## Issue Metadata

| Field | Value |
|-------|-------|
| Date | `{today}` |
| Status | `INIT` |
| Type | `{issue_type}` |
| Branch | {branch_display} |
| 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

### Graph Context

(graph context will be injected at creation by atdd issue <slug>)

### Mirror Across Agents

| Agent | Current state | Target state | Action |
|-------|---------------|--------------|--------|
| planner | (current — observed/missing) | (target — declared rule, validator, etc.) | (action — add/update/none) |
| tester | (current — observed/missing) | (target) | (action) |
| coder | (current — observed/missing) | (target) | (action) |
| coach | (current — observed/missing) | (target) | (action) |

### 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}

---

## Rule Wiring

(OPTIONAL — fill in only when this issue introduces new convention rules. Otherwise leave the table empty or remove this section.)

| rule_id | severity | disposition | bind_to | fix_hint_ref |
|---------|----------|-------------|---------|--------------|
| (rule_id) | (1-5) | (strict\|suppress-and-clean\|advisory\|documentation-only) | (validator module::function) | (recipe or convention pointer) |

---

## 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 --scope changed-files` | PASS | `src/atdd/coach/commands/registry.py` | TODO |
{gate_tests_rows}| GT-800 | completion | `atdd repo 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 issue {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

#1172 (SHIPPED): the release version lives in the State Store (singleton
`release` object, migration v2) and is projected at build time by the in-tree
backend — `pyproject.toml` is `dynamic = ["version"]` (no `version =` line to
hand-edit or conflict on). The GH006 direct-push auto-bump is RETIRED. CI
publication (release-worker draining core's neutral version_decided outbox) is the
remaining #1172 follow-up; until it lands the release is operator-coordinated. Do NOT
re-adopt the GH006 auto-bump or a hand-edited pyproject version.

- [ ] Rebase on main: `git pull origin main --rebase`
- [ ] Bump the State Store version (feat/ → MINOR, fix|chore|docs/ → PATCH): `atdd state version bump --class X`
- [ ] Merge PR → publication handled by the release extension (interim: operator-coordinated)

---

## Notes

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