architecture-documenter

Architecture documentation drifts when systems evolve faster than docs. This Skill automates documentation maintenance by inspecting your current code, configs, and infrastructure, then generating or updating docs/architecture/index.md with accurate system descriptions and Mermaid diagrams reflecting your actual architecture.

Yes. This Skill inspects your infrastructure and generates Mermaid diagrams integrated into architecture documents for system overview, cloud deployment, service design, and CI/CD flows, providing clear visual representation of components and their relationships.

Tool-based inspection of your codebase and infrastructure is the foundation. This Skill prioritizes introspection via tools first, then CLI fallback, to produce unified architecture documentation with service boundaries, cloud topology, and CI/CD pipelines all in one coherent doc set.

No. This Skill automates the inspection and update cycle for architecture documentation. It detects infrastructure changes through tool-based code and config analysis, then updates only the relevant architecture documents while preserving manual edits elsewhere.

The Skill creates and maintains docs/architecture/ with enforced lowercase dashed filenames. It integrates into your existing documentation structure, prompts for confirmation when changes are ambiguous, and updates only files it owns, leaving other docs untouched.

Have your codebase and infrastructure accessible for inspection. The Skill uses tool-based introspection to read code, configs, and infrastructure state directly, then generates documentation—no manual architectural diagrams or descriptions required upfront.