docs: point Active 6-Week Execution Plan links at live 2026-03-05 plan#8516
Conversation
The P2 docs archive pass repointed the live "Active 6-Week Execution Plan" links in docs/INDEX.md and docs/README.md to the archived 2026-02-25-EXECUTION_NEXT_6_WEEKS.md instead of the live docs/status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md (still the canonical short-horizon plan). Repoint both live links to the 2026-03-05 plan and regenerate the docs-site documentation-index mirror to match. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
|
BLOCKED — do not merge as-is. Returning to orchestrator. This PR's The only clean fix is to change the Items 1+2 are inseparable, and items 2+3 require touching mirror pages owned by |
…026-03-05 plan The P2 archive pass left the live "Active 6-Week Execution Plan" surfaces pointing at the archived 2026-02-25 plan. Item 1 (docs/INDEX.md + docs/README.md links -> live status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md) shipped in 0a9037c, but its docs-site mirror was broken without the sync-docs source fix. This commit completes items 2+3 and regenerates the mirrors: - docs-site/scripts/sync-docs.js DOC_MAP key archive/status/2026-02-25-EXECUTION_NEXT_6_WEEKS.md -> status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md (same route value). The contributing/execution-next-6-weeks-2026-03-05 route now sources the LIVE plan, and REVERSE_LOOKUP rewrites the live path to the ./execution-next-6-weeks-2026-03-05 slug. - docs/status/DOCUMENTATION_HYGIENE_AND_GAP_REGISTER.md prose: "archived" -> live six-week execution plan reference. - Regenerated docs-site mirrors (documentation-index, execution-next-6-weeks-2026-03-05, documentation-hygiene-and-gap-register) via doc_stats.py --write && sync-docs.js. Verify: tests/scripts/test_docs_site_sync_links.py 5 passed; check_docs_consistency.py PASS (broken links / live->archive / metric drift / tier contradictions); check_docs_links.py OK; make lint green. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Claude independent model reviewReviewer: claude (anthropic) — independent adversarial model review via the Aragora Claude reviewer, grounded on the exact PR head. Verdict: PASS All changes are documentation-only and verified internally consistent:
No correctness, security, or regression risk in this change set. No findings. dogfood: yes |
Gemini independent model reviewReviewer: gemini (google) — independent adversarial model review via Antigravity CLI harness, grounded on the exact PR head. Verdict: PASS
dogfood: yes |
…26-03-05 plan (#8551) The "Current Focus (March 2026)" bullet in DOCUMENTATION_HYGIENE_AND_GAP_REGISTER.md summarized the active six-week plan with stale OLD-plan framing ("first receipt quickly, parity hard-close, reliability cleanup, surface simplification, and status consolidation") that does not appear anywhere in the live plan (docs/status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md). This was grok's one in-scope [P2] finding during the PR #8516 model review, deferred from that link-only-scoped PR. Rewrite the bullet to reflect the live plan's actual priority order: closing the default product loop on main, making proof surfaces truthful by default, finishing the bounded execution operator contract, running design-partner PMF loops, and expanding one truthful workbench slice before a PMF decision gate. The doc's link already points at the live plan (#8516); only the framing prose was stale. The docs-site mirror was regenerated via `node docs-site/scripts/sync-docs.js` (not hand-edited). docs/archive/** untouched. Validation (worktree): - python3 scripts/check_docs_consistency.py -> all checks PASS (rc=0) - python3 scripts/ci/check_docs_links.py -> OK (rc=0) - python3 -m pytest tests/scripts/test_docs_site_sync_links.py -q -> 5 passed - make lint -> All checks passed! ; make test-smoke -> Smoke tests passed! Risk: docs-only, no code/public-API surface; mirror is deterministic sync output. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Source
The P2 docs archive pass (feature
p2-tree-and-archive) repointed the live"Active 6-Week Execution Plan" links to the archived
docs/archive/status/2026-02-25-EXECUTION_NEXT_6_WEEKS.mdinstead of the livedocs/status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md. The p2-docs scrutiny gateflagged this as BLOCKING: the live short-horizon plan still declares itself
canonical, yet the index/readme sent readers to the archived predecessor.
Change (Tier 0, docs-only)
docs/INDEX.md— repoint the "Active 6-Week Execution Plan" link to the livestatus/EXECUTION_NEXT_6_WEEKS_2026-03-05.md.docs/README.md— repoint theEXECUTION_NEXT_6_WEEKS("Active short-horizonplan") link to the live
./status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md.docs-site/docs/contributing/documentation-index.md— regenerated viadoc_stats.py --write+sync-docs.jsso the mirror matches.The 2026-02-25 file stays archived; it is no longer linked as the active plan.
Validation (run on this branch's worktree)
python3 scripts/check_docs_consistency.py→ PASS (broken links, live→archiverefs, metric drift, tier contradictions all PASS).
python3 scripts/ci/check_docs_links.py→OK all internal markdown links and anchors resolve.2026-02-25-EXECUTION_NEXT_6_WEEKS.md(onlydocs-site/scripts/sync-docs.jsstill references the archive basename — see Deferred below).
make lint→All checks passed!make test-smoke→ Core/Server/Memory imports OK, Smoke tests passed.Deferred (NOT in this PR — returned to orchestrator)
The two remaining scrutiny items cannot land cleanly right now because their
target docs-site mirror pages are path-frozen by open (conflicting/stale) PRs,
and the
docs-build.ymlsync gate fails on any un-committed mirror drift:docs-site/scripts/sync-docs.jsDOC_MAP source → live plan +regenerate
contributing/execution-next-6-weeks-2026-03-05.md): the execmirror page is frozen by fix(ci): clear base security and smoke blockers #8461.
docs/status/DOCUMENTATION_HYGIENE_AND_GAP_REGISTER.mdwording +mirror): the hygiene mirror page is frozen by chore(deps): update audit-vulnerable Python locks #8460 and fix(ci): clear base security and smoke blockers #8461.
Risks
Docs-only; no code or API surface touched. Low risk.