By name: "ARCHITECT ADR" description: "Prompt for Architect Alphonso to perform analysis and draft a Proposed ADR" version: "1.0.0" type: "prompt-template" agent: "architect-alphonso" category: "architecture" tags: ["architecture", "adr", "decision-record", "trade-offs", "design"]
ARCHITECT ADR
Prompt for Architect Alphonso to perform analysis and draft a Proposed ADR
Instructions
Clear context. Bootstrap as Architect Alphonso. When ready:
Execute an architectural analysis and draft a Proposed ADR.
Inputs:
- Decision Title: <TITLE>
- Problem Context (paragraph): <CONTEXT>
- Forces / Constraints (bullets): <FORCES>
- Options (bullets, short labels): <OPTIONS>
- Preferred Option: <PREFERRED>
- Impact Areas (e.g., performance, portability, maintainability): <IMPACTS>
- Related Artifacts (paths): <RELATED>
- Existing ADR References (list): <ADR_REFS>
- Risk Appetite (low|medium|high): <RISK_APPETITE>
- Time Horizon (short|medium|long): <HORIZON>
- Non-Functional Requirements (bullets): <NFRS>
Task:
- Validate uniqueness of <TITLE> vs existing ADRs.
- Decompose context into problem statement + drivers + constraints.
- Analyze each <OPTION> against <IMPACTS> and <NFRS> (matrix-style, qualitative scores).
- Provide rationale for selecting <PREFERRED> (trade-off narrative).
- Draft ADR in template format (status: Proposed) with sections: Context, Decision, Rationale, Envisioned Consequences (+ positive/negative), Considered Alternatives.
- Add risk assessment (tie to <RISK_APPETITE>) and horizon alignment.
- Suggest acceptance criteria + success metrics.
- Output file:
docs/architecture/adrs/ADR-XXX-\<slug>.md(choose next number). - Provide diff plan for cross-link updates (README index).
Output:
- ADR markdown content
- Option Impact Matrix block
- Success Metrics list
Constraints:
- Keep Decision section ≤ 120 words.
- Each alternative: one sentence reason for rejection.
- Avoid speculative implementation detail; defer to Technical Design doc if needed.
Ask clarifying questions if <CONTEXT> or <PREFERRED> ambiguous.
Workflow
- Provide diff plan for cross-link updates (README index).
Inputs
- TITLE (required) - Decision Title
- CONTEXT (required) - paragraph
- FORCES (required) - bullets
- OPTIONS (required) - bullets, short labels
- PREFERRED (required) - Preferred Option
- IMPACTS (required) - e.g., performance, portability, maintainability
- RELATED (required) - paths
- ADR_REFS (required) - list
- RISK_APPETITE (required) - low|medium|high
- HORIZON (required) - short|medium|long
- NFRS (required) - bullets
Outputs
- Success Metrics list