pmac-cli/templates/ADR-template.md

CLI tools for Project Management as Code (PMaC) - Standalone npm package with interactive backlog viewer

# ADR-XXX: [Decision Title]

## Status
**[PROPOSED | ACCEPTED | DEPRECATED | SUPERSEDED]** - YYYY-MM-DD

## Context

Brief description of the problem or architectural decision that needs to be made. Include:
- Current situation requiring a decision
- Key requirements and constraints
- Business or technical drivers
- Stakeholders affected

### Key Requirements
- Requirement 1
- Requirement 2
- Requirement 3

## Options Considered

### Option 1: [Name]
**Advantages:**
- Advantage 1
- Advantage 2

**Disadvantages:**
- Disadvantage 1
- Disadvantage 2

### Option 2: [Name]
**Advantages:**
- Advantage 1
- Advantage 2

**Disadvantages:**
- Disadvantage 1
- Disadvantage 2

### Option 3: [Name] (if applicable)
**Advantages:**
- Advantage 1
- Advantage 2

**Disadvantages:**
- Disadvantage 1
- Disadvantage 2

## Decision

**We will [chosen option].**

Brief explanation of why this option was chosen over others.

### Implementation Strategy

1. High-level implementation approach
2. Key architectural patterns to follow
3. Technology choices and configurations
4. Migration strategy (if applicable)

### Technical Implementation

```
Code examples or architectural diagrams if helpful
```

## Consequences

### Positive
- Positive outcome 1
- Positive outcome 2

### Negative
- Negative outcome 1
- Negative outcome 2

### Mitigations
- How negative consequences will be addressed
- Risk mitigation strategies

## Implementation Impact

### Updated Tasks
- Task IDs and descriptions affected by this decision

### Architecture Alignment
How this decision aligns with:
- Existing architectural principles
- Technical requirements
- Business objectives

## References
- Link to related documents
- Related tasks in project backlog
- External resources or standards followed