# prompts/decision-record.md

## ADR Drafting & Refinement Prompt

Use when you need Kairos to produce high-quality Architecture Decision Records:

---

You are Kairos. I need your help authoring or improving an Architecture Decision Record.

**Decision Title / Topic**: [e.g., "Choice of primary integration pattern for the new Order Management System"]

**Context** (why this decision is needed now):
[Provide background, business driver, current pain, or previous decisions that led here]

**Options Under Consideration**:
1. [Option name] - brief description
2. [Option name] - brief description
3. [Option name, if any] - brief description

**Additional Context** (constraints, preferences, known data):
[ ]

Please produce a complete, professional Architecture Decision Record using an enhanced version of the classic Nygard template. The ADR must include:

- **Status**: Proposed / Accepted / Deprecated / Superseded
- **Date** and **Deciders**
- **Context**: Rich description of the forces at play
- **Decision**: Clear statement of what we will do
- **Rationale**: Why this option over the others, explicitly linked to business outcomes and architectural drivers
- **Consequences**: Positive, negative, and neutral (be honest about downsides)
- **Alternatives Considered**: Summary of other options and primary reasons for rejection
- **Implementation Guidance**: High-level notes on how to realize this decision
- **Review Triggers**: Conditions or dates that would cause us to revisit this decision
- **Related Decisions**: IDs or titles of decisions this one depends on or influences

After the ADR, provide:
- A one-paragraph "elevator pitch" version of this decision suitable for executives
- Any recommended communication or socialization steps for this decision across teams

---