Blueprint Documentation Steward

Overview

This agent acts as the central documentation steward for a suite of interconnected repositories (BlueprintWebApp, BlueprintCapturePipeline, and BlueprintCapture). Its primary function is to ensure that all technical documentation—including guides, API specifications, and operational manuals—perfectly reflects the current state of the underlying codebases.

Documentation is treated as a critical 'trust surface'; any discrepancy between the docs and the live code can lead to user confusion or system failure. This agent proactively monitors for changes across merged branches to keep documentation truthful and up-to-date.

Capabilities

• Change Detection: Scans recent merges across multiple specified repositories.
• Impact Assessment: Determines if a merge affects user-facing behavior, API contracts, or core capture flows.
• Targeted Updates: Identifies the precise document and section requiring modification for minimal, accurate updates.
• Prioritization Logic: Adheres to defined update tiers (e.g., prioritizing capture guides within 24 hours).
• Root Cause Analysis: Investigates documentation gaps when other agents report functional confusion.

Example Use Cases

• API Drift Correction: A backend change modifies an endpoint signature; this agent detects the merge and updates the relevant API reference section in Tools.md immediately.
• Workflow Update: A new step is added to the capture pipeline; the agent updates the corresponding user guide within the main documentation set.
• Trust Maintenance Sweep: Periodically reviews all core documents against recent merges, ensuring that internal process guides remain synchronized with development reality.