## Issue Metadata

| Field | Value |
|-------|-------|
| Date | `{today}` |
| Status | `INIT` |
| Type | `{issue_type}` |
| Branch | TBD <!-- fmt: {{prefix}}/{slug} e.g. feat/my-feature --> |
| Archetypes | {archetypes_display} |
| Train | {train_display} |
| Feature | TBD |

---

## Scope

### In Scope

- (define specific deliverables)

### Out of Scope

- (define explicit exclusions)

### Dependencies

- (list session or external dependencies)

---

## Context

### Problem Statement

| Aspect | Current | Target | Issue |
|--------|---------|--------|-------|
| (aspect) | (current state) | (target state) | (why it's a problem) |

### User Impact

(How does this problem affect users, developers, or the system?)

### Root Cause

(Why does this problem exist? What architectural or design decisions led to it?)

---

## Architecture

### Existing Patterns

| Pattern | Example File | Convention |
|---------|--------------|------------|
| (pattern) | `(path)` | `(convention file)` |

### Conceptual Model

| Term | Definition | Example |
|------|------------|---------|
| (term) | (definition) | (example) |

### Before State

```
(current architecture/structure)
```

### After State

```
(target architecture/structure)
```

{data_model_section}

---

## Phases

### Phase 1: (Name)

**Deliverables:**
- (artifact) - (description)

**Files:**

| File | Change |
|------|--------|
| `(path)` | (description) |

---

## Validation

### Gate Tests

| ID | Phase | Command | Expected | ATDD Validator | Status |
|----|-------|---------|----------|----------------|--------|
| GT-001 | design | `atdd validate coach` | PASS | `src/atdd/coach/validators/test_issue_validation.py` | TODO |
| GT-002 | design | `atdd registry update --check` | PASS | `src/atdd/coach/commands/registry.py` | TODO |
{gate_tests_rows}| GT-800 | completion | `atdd urn validate` | PASS | `src/atdd/coach/validators/test_urn_traceability.py` | TODO |
| GT-850 | completion | `atdd registry update --check` | PASS | `src/atdd/coach/commands/registry.py` | TODO |
| GT-900 | completion | `atdd validate` | PASS | `src/atdd/` | TODO |

### Success Criteria

- [ ] (measurable outcome 1)
- [ ] (measurable outcome 2)

---

## Decisions

| # | Question | Decision | Rationale |
|---|----------|----------|-----------|
| 1 | (question) | (decision) | (rationale) |

---

## Activity Log

### Entry 1 ({today})

**Completed:**
- Issue created via `atdd new {slug}`

**Next:**
- Create branch: `atdd branch <N>` (this issue's number)
- Fill Context, Scope, and Architecture sections
- Define phases and gate tests

---

## Artifacts

### Created

- (none yet)

### Modified

- (none yet)

### Deleted

- (none yet)

---

## Release Gate

Before merge: rebase on main, bump version based on branch prefix, commit, push.
After merge: CI tags and publishes to PyPI automatically.

- [ ] Rebase on main: `git pull origin main --rebase`
- [ ] Bump version (feat/ → MINOR, fix/ → PATCH): edit version file, commit "Bump version to X.Y.Z"
- [ ] Merge PR → CI creates tag + publishes

---

## Notes

(Additional context, learnings, or decisions that don't fit elsewhere.)
