---
id: architecture/oq-promotion-sync
name: Sync AGENTS.md + phase-0 ledger pointers to the promoted OQ ledger (planning)
status: pending
depends_on: []
scope: single
risk: trivial
impact: project
level: planning
tags: [architecture, phase-1, oq]
---

## Description

Phase 1 promoted the Phase 0 OQ ledger into `docs/architecture/open-questions.md`
(OQ-TN-01..14) and split OQ-TN-11/13 into resolved halves (ADR-001/ADR-003).
The older ledgers still describe pre-Phase-1 states in two places:

1. `docs/research/phase-0-findings.md` — the OQ sections (OQ-TN-01..10) should
   carry one-line "promoted to `docs/architecture/open-questions.md` as OQ-TN-NN"
   pointers so a reader landing in the research doc finds the live tracker (the
   convergence checklist's last unchecked item says "promoted ... with statuses" —
   the promotion exists; the back-pointer is the missing half).
2. `AGENTS.md` — the "Architecture Context" section says `docs/architecture/`
   "will hold the authoritative spec (Phase 1 of the SDD process)... It does not
   exist yet". That is now stale: the spec exists (ADR-001..006 + 4 spec docs +
   BAST + OQ tracker). Update the paragraph to point at the real directory and
   adjust the "read it before non-trivial changes once it exists" line.

## Work

- phase-0-findings.md: add a promotion note at the top of the Open Questions
  section (and one line under the convergence checklist's final item) pointing
  at `docs/architecture/open-questions.md`; mark the checklist item done.
- AGENTS.md: rewrite the `docs/architecture/` bullet to the present tense
  (spec exists; read it before non-trivial changes; ADRs 001..006 are
  Accepted; the OQ tracker is authoritative for open questions).

## Verification

- [ ] phase-0-findings.md has the promotion pointer; the checklist's final
      item is checked
- [ ] AGENTS.md architecture-context paragraph reflects the existing spec
- [ ] No other stale "does not exist yet" language anywhere in AGENTS.md or
      docs/

## Out of scope

- Any change to the OQ statuses themselves (that is the tracker's job now)

## References

- docs/architecture/open-questions.md (the promoted ledger)
- docs/sdd_process.md §Safe Exit (the two-halves rule for deferrals)

## Notes

> Agent fills during implementation.

## Summary

> Agent fills this on completion.