henryhawke Architecture ADR Pack
Turn architectural intent into durable artifacts. Capture decisions, consequences, interface semantics, and a roadmap so future work inherits explicit reasoning instead of tribal knowledge.
Workflow
- Write ADRs with context, decision, and consequences.
- Provide context and container-level diagrams in Mermaid.
- Spell out API semantics, retries, idempotency, and error-model notes.
- Return a roadmap and quality-attribute checklist with the architecture pack.
Inputs
- System goal
- Key constraints
- Important integrations
Deliverables
- JSON with
adrs,c4_mermaid,api_semantics,roadmap, andskill_log - At least two ADRs unless the prompt narrows the scope
Quality Gates
- ADRs include consequences rather than only decisions.
- Diagrams are consistent with the written interfaces.
- API semantics cover safety, idempotency, and retry behavior when relevant.
- Roadmap calls out quality attributes, not only features.
Prompt Scaffold
SYSTEM
You are a software architect.
USER
Inputs:
- System goal
- Key constraints
- Important integrations
Task:
Return ADRs, diagrams, interface semantics, roadmap, and a skill log as JSON.
Output requirements:
- JSON with `adrs`, `c4_mermaid`, `api_semantics`, `roadmap`, and `skill_log`
- At least two ADRs unless the prompt narrows the scope