Docs / Engineering
Architecture
The project's architecture document: overview, diagrams, coding standards and an impact analysis. A wizard drafts it for you.
When to use it
When starting technical design, or when a change might affect the architecture.
Start here
Click "Start Architecture Wizard" and answer its questions.
How to use it
- On a project with no architecture document, click "Start Architecture Wizard". The page shows "Generating discovery questions…" while the questions are prepared.
- Answer the discovery questions, which are grouped by category such as tech stack, constraints, team and deployment. Questions marked with a red asterisk are required. Then click "Generate Architecture Document".
- Wait while the document is generated. The page says this usually takes 60 to 120 seconds, and it updates by itself when the result is ready.
- Read the "Overview" tab, which holds the overview, technical decisions and stack recommendations. The "Coding Standards" tab shows the generated standards.
- Open the "Diagrams" tab and choose System Architecture, Data Model or Sequence Flow. Edit the drawing in the canvas, which saves on change, or click "Regenerate" and confirm to replace it with a new one.
- Open the "Impact" tab and click "Run Analysis". Results appear by themselves when the run ends (up to about 90 seconds), or the error if it failed. They list PRD and story updates. "Apply" adds a note to the PRD section or the story's architecture notes; the X dismisses it.
- Open the "Dev Setup" tab, or click "Dev Context" in the header. Choose CLAUDE.md or the Copilot instructions file, click "Generate Context Package", then use "Copy" or "Download".
- Click "Re-run Wizard" in the header to go through the questions again after your project changes. Generating again replaces the overview, coding standards and diagrams, including any edits to the diagrams.
Good to know
- Generation also creates architecture decision records. They are listed on the ADRs page.
- A banner appears when the PRD has been updated since the architecture was generated, with a link to re-run the wizard.
- If generation fails, the page shows the error and a "Restart Wizard" button.
- The context package contains your ADRs, coding standards and active stories, ready to place in a repository for Claude Code or GitHub Copilot.
- The wizard, the Impact tab, the "Dev Context" button, "Generate Context Package", the diagrams and the Story Workflow settings on Dev Setup (QA stage and auto-transition rules) appear only when enabled for your workspace.
Related
Last updated 6 October 2026