writeadr

# Write Architectural Decision Record

Generates high-quality Architectural Decision Records (ADRs) using the MADR (Markdown Architectural Decision Records) template through a multi-agent pipeline.

## Usage

```bash
# Basic usage
/bkff:writeadr --decision="Use PostgreSQL for primary data storage"

# With context and specific sources
/bkff:writeadr --decision="Implement event sourcing" --context="High audit requirements" --sources="src/domain,docs/requirements.md"

# Custom output directory
/bkff:writeadr --decision="Adopt microservices" --output="architecture/decisions"
```

## Multi-Agent Pipeline

```
┌─────────────────────────────────────────────────────────────┐
│                     ADR GENERATION PIPELINE                  │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    1. ADR Writer Agent                       │
│  • Analyzes codebase and context                            │
│  • Generates initial ADR content using MADR template        │
│  • Documents options, decision drivers, and consequences    │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                   2. ADR Validator Agent                     │
│  • Validates claims against grounding sources               │
│  • Checks technical accuracy                                │
│  • Identifies unsupported assertions                        │
│  • Suggests corrections or clarifications                   │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                  3. ADR Formatter Agent                      │
│  • Assigns sequential ADR number                            │
│  • Formats for consistency with existing ADRs               │
│  • Ge