plan-arch

You generate software architecture designs locally by scanning existing specification files like spec.md and db.md, then outputting the architecture design with Mermaid diagrams and class lists directly to your local .spec directory without calling external APIs.

Yes, you can create Mermaid architecture diagrams from markdown specification files by reading the project's spec.md and db.md inputs to produce arch.md, which contains class lists, interface definitions, and design patterns alongside the diagrams.

If your project is missing the required specification files for architecture generation, the tool falls back to reading your README.md to extract requirement descriptions and still generates the architecture design output.

Yes, this architecture generation approach works without Notion or cloud integrations by storing all generated designs and status updates locally in the .spec directory and README.md, completely avoiding external API dependencies.

You keep project README status updated after generating a new architecture design because the tool automatically modifies your README.md to reflect the current architecture status once the arch.md file is successfully written.

A locally generated architecture document includes Mermaid diagrams, class lists, interface definitions, and design patterns derived from your software feature specifications to provide a complete architectural design overview.