`architect` — guides

These guides help you design a system, draw it, and check it against the code you have.

Start here

• Design the architecture — Agree an architecture on half a page, then draw it and get it reviewed.

More

• Your first architecture session — Survey an existing repository without changing it, then pick the first thing to look at.
• Create and use your reference.md — Commit one real architecture standard and use it to steer a design choice.
• Assess a repository and turn evidence into action — Build a model of what exists and turn the evidence into an action.
• Get a physical architecture and bill of materials — Turn a finished design into where each part runs and what it costs.
• Establish your repo’s reference architecture — Write down the architecture decisions you have settled so later designs follow them.
• Why the architect-diagram skill works the way it does — Why the diagram skill draws what it draws.
• Architecture assessment reference — Assessment modes, evidence, output fields, and limits.
• reference.md sections and the stack-pack contract — The sections a reference architecture needs, and how a stack pack plugs in.