Summary
Add a specsmith architect command that generates or enriches architecture
documentation by scanning the project and conducting an interactive interview.
Proposed Workflow
- Scan project structure, modules, languages, dependencies, entry points
- Scan git history for architecture-relevant commits (refactors, new modules)
- Scan existing docs (REQUIREMENTS.md, AGENTS.md) for architectural references
- Present a draft architecture to the user
- Run an interactive interview asking about:
- Major components and their responsibilities
- Data flow between components
- External interfaces and dependencies
- Deployment model
- Platform-specific considerations
- Generate or update docs/architecture.md with the combined information
- Optionally generate a component diagram (text-based, Mermaid or ASCII)
Integration Points
specsmith import --guided already does basic component prompts - this would
replace that with the richer version
specsmith audit would recommend running architect when architecture.md
is missing or stale
specsmith export would include architecture summary in compliance reports
Design Considerations
- Must work offline (no LLM required) - the interview is deterministic prompts
- AI agents can be used AFTER to enrich the generated scaffold
- Should detect and reference existing architecture docs in non-standard locations
Summary
Add a
specsmith architectcommand that generates or enriches architecturedocumentation by scanning the project and conducting an interactive interview.
Proposed Workflow
Integration Points
specsmith import --guidedalready does basic component prompts - this wouldreplace that with the richer version
specsmith auditwould recommend runningarchitectwhen architecture.mdis missing or stale
specsmith exportwould include architecture summary in compliance reportsDesign Considerations