singularity-forge/BUILD_PLAN_MILESTONE_MAP.md

# BUILD_PLAN → Milestone Map

Every BUILD_PLAN.md tier item mapped to a milestone. **Rule D015**: every new milestone must cite which BUILD_PLAN tier/item it implements.

This file answers **where work belongs**, not **whether code is done**. "Mapped" means a BUILD_PLAN item has a milestone/slice home. It does **not** mean the implementation is verified in the current repo.

## Mapping vs. code truth

- **Mapped** — the item has a milestone/slice destination.
- **Verified in code** — the behavior exists in the repo and has evidence/tests/artifacts.
- **Open** — still planned or partially folded in, but not yet verified as complete.
- **Deferred** — intentionally out of the active plan.

---

## High-level milestone direction

These are the strategy bands above the itemized mapping:

1. **Core foundation** — UOK, purpose-driven TDD, eight-field PDD gate, repo-local state
2. **Single-repo sharpening** — adopt the best execution/workflow ideas from pi-mono, gsd-2, Claude Code, Codex, Aider, and Plandex where they strengthen Forge
3. **Autonomous reliability** — evidence, recovery, verification, and self-improvement loops
4. **Surface coherence** — CLI, TUI, docs, and workflow language all reflect the same UOK-driven model
5. **ACE convergence prep** — keep concepts compatible with ACE Coder without turning Forge into the multi-repo system

---

## Tier 0 — Pi-mono ports → **M006**
## Tier 0.5 — gsd-2 ports → **M006 + M007**

All mapped. See BUILD_PLAN.md for item-level status.

## Tier 1 — ESSENTIAL → **ALL MAPPED**

| Item | Milestone | Slice | Status |
|---|---|---|---|
| 1.1 Vault secret resolver | **M017-yf67h6** | S01-S03 | ⬜ NEW |
| 1.2 Singularity Memory integration | **M017-jpw5jo** | S01-S03 | ⬜ NEW |
| 1.3 Schema reconciliation (spec rewrite) | **M013** | S12 | ⬜ Folded in |
| 1.4 Config schema alignment | **M013** | S13 | ⬜ Folded in |

## Tier 2 — STRONG → **ALL MAPPED**

| Item | Milestone | Slice | Status |
|---|---|---|---|
| 2.1 Persistent agents v1 | M012 | S01-S05 | ⬜ |
| 2.2 Doc-sync sub-step | M009 | S08 | ⬜ |
| 2.3 Intent chapters | M013 | S08 | ⬜ |
| 2.4 PhaseReview 3-pass | M016 | S01-S02 | ⬜ |
| 2.5 turn_status marker | M013 | S09 | ⬜ |
| 2.6 last_error cap | M013 | S10 | ⬜ |
| 2.7 cost_micro_usd | M013 | S11 | ⬜ |

## Tier 3+ → **Deferred by design**

---

## Summary

| Tier | Mapped | Gap |
|---|---|---|
| Tier 0 | 10 (M006) | 0 |
| Tier 0.5 | 17 (M006+M007) | 0 |
| **Tier 1** | **4** (M017×2, M013×2) | **0** |
| Tier 2 | 7 (M012, M009, M013, M016) | 0 |
| Tier 3+ | 0 | deferred |

**Zero mapping gaps.** Every BUILD_PLAN tier item is either mapped to a milestone or explicitly deferred.

That does **not** mean zero implementation gaps. Open `TODO`, `NEW`, and `⬜` markers in `BUILD_PLAN.md`, this map, and milestone artifacts still represent real work until they are reconciled against code evidence.
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
+								# BUILD_PLAN → Milestone Map
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								Every BUILD_PLAN.md tier item mapped to a milestone. **Rule D015**: every new milestone must cite which BUILD_PLAN tier/item it implements.
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
-												sf snapshot: uncommitted changes after 258m inactivity

											
										
										
											2026-05-07 15:37:55 +02:00
+								This file answers **where work belongs**, not **whether code is done**. "Mapped" means a BUILD_PLAN item has a milestone/slice home. It does **not** mean the implementation is verified in the current repo.
 								## Mapping vs. code truth
 								- **Mapped** — the item has a milestone/slice destination.
 								- **Verified in code** — the behavior exists in the repo and has evidence/tests/artifacts.
 								- **Open** — still planned or partially folded in, but not yet verified as complete.
 								- **Deferred** — intentionally out of the active plan.
 								---
 								## High-level milestone direction
 								These are the strategy bands above the itemized mapping:
 . **Core foundation** — UOK, purpose-driven TDD, eight-field PDD gate, repo-local state
 . **Single-repo sharpening** — adopt the best execution/workflow ideas from pi-mono, gsd-2, Claude Code, Codex, Aider, and Plandex where they strengthen Forge
 . **Autonomous reliability** — evidence, recovery, verification, and self-improvement loops
 . **Surface coherence** — CLI, TUI, docs, and workflow language all reflect the same UOK-driven model
 . **ACE convergence prep** — keep concepts compatible with ACE Coder without turning Forge into the multi-repo system
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
+								---
 								## Tier 0 — Pi-mono ports → **M006**
 								## Tier 0.5 — gsd-2 ports → **M006 + M007**
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								All mapped. See BUILD_PLAN.md for item-level status.
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								## Tier 1 — ESSENTIAL → **ALL MAPPED**
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								| Item | Milestone | Slice | Status |
 								|---|---|---|---|
 								| 1.1 Vault secret resolver | **M017-yf67h6** | S01-S03 | ⬜ NEW |
 								| 1.2 Singularity Memory integration | **M017-jpw5jo** | S01-S03 | ⬜ NEW |
 								| 1.3 Schema reconciliation (spec rewrite) | **M013** | S12 | ⬜ Folded in |
 								| 1.4 Config schema alignment | **M013** | S13 | ⬜ Folded in |
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
 								## Tier 2 — STRONG → **ALL MAPPED**
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								| Item | Milestone | Slice | Status |
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
+								|---|---|---|---|
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								| 2.1 Persistent agents v1 | M012 | S01-S05 | ⬜ |
 								| 2.2 Doc-sync sub-step | M009 | S08 | ⬜ |
 								| 2.3 Intent chapters | M013 | S08 | ⬜ |
 								| 2.4 PhaseReview 3-pass | M016 | S01-S02 | ⬜ |
 								| 2.5 turn_status marker | M013 | S09 | ⬜ |
 								| 2.6 last_error cap | M013 | S10 | ⬜ |
 								| 2.7 cost_micro_usd | M013 | S11 | ⬜ |
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								## Tier 3+ → **Deferred by design**
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								---
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
 								## Summary
 								| Tier | Mapped | Gap |
 								|---|---|---|
 								| Tier 0 | 10 (M006) | 0 |
 								| Tier 0.5 | 17 (M006+M007) | 0 |
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								| **Tier 1** | **4** (M017×2, M013×2) | **0** |
-												fix: wire bundled extension inventory

											
										
										
											2026-05-05 00:03:47 +02:00
+								| Tier 2 | 7 (M012, M009, M013, M016) | 0 |
-												docs: clarify guided planning artifacts

											
										
										
											2026-05-05 00:06:57 +02:00
+								| Tier 3+ | 0 | deferred |
-												sf snapshot: uncommitted changes after 258m inactivity

											
										
										
											2026-05-07 15:37:55 +02:00
+								**Zero mapping gaps.** Every BUILD_PLAN tier item is either mapped to a milestone or explicitly deferred.
 								That does **not** mean zero implementation gaps. Open `TODO`, `NEW`, and `⬜` markers in `BUILD_PLAN.md`, this map, and milestone artifacts still represent real work until they are reconciled against code evidence.