Skip to content

docs: point Active 6-Week Execution Plan links at live 2026-03-05 plan#8516

Merged
scarmani merged 2 commits into
mainfrom
structex/p2-docs-active-plan-link-fix
Jun 21, 2026
Merged

docs: point Active 6-Week Execution Plan links at live 2026-03-05 plan#8516
scarmani merged 2 commits into
mainfrom
structex/p2-docs-active-plan-link-fix

Conversation

@scarmani

Copy link
Copy Markdown
Collaborator

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.md instead of the live
docs/status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md. The p2-docs scrutiny gate
flagged 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 live
    status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md.
  • docs/README.md — repoint the EXECUTION_NEXT_6_WEEKS ("Active short-horizon
    plan") link to the live ./status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md.
  • docs-site/docs/contributing/documentation-index.md — regenerated via
    doc_stats.py --write + sync-docs.js so 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→archive
    refs, metric drift, tier contradictions all PASS).
  • python3 scripts/ci/check_docs_links.pyOK all internal markdown links and anchors resolve.
  • rg sweep: no live (non-archive) doc links the "Active … Execution Plan" to
    2026-02-25-EXECUTION_NEXT_6_WEEKS.md (only docs-site/scripts/sync-docs.js
    still references the archive basename — see Deferred below).
  • make lintAll 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.yml sync gate fails on any un-committed mirror drift:

Risks

Docs-only; no code or API surface touched. Low risk.

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>
@scarmani scarmani marked this pull request as ready for review June 19, 2026 00:37
@scarmani scarmani requested a review from an0mium as a code owner June 19, 2026 00:37
@scarmani scarmani marked this pull request as draft June 19, 2026 00:42
@scarmani

Copy link
Copy Markdown
Collaborator Author

BLOCKED — do not merge as-is. Returning to orchestrator.

This PR's docs/INDEX.md + docs/README.md edits (repoint the "Active 6-Week
Execution Plan" links to the live status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md)
are correct and were confirmed correct by both reviewers. But the required
regeneration of the docs-site mirror (docs-build.yml fails on any un-synced
drift) produces a broken raw link in docs-site/docs/contributing/documentation-index.md
that also fails tests/scripts/test_docs_site_sync_links.py::test_documentation_index_rewrites_status_and_planning_links.

The only clean fix is to change the docs-site/scripts/sync-docs.js DOC_MAP key
archive/status/2026-02-25-EXECUTION_NEXT_6_WEEKS.mdstatus/EXECUTION_NEXT_6_WEEKS_2026-03-05.md
(item 2), which regenerates docs-site/docs/contributing/execution-next-6-weeks-2026-03-05.md
from the archive (2026-02-25) content to the live (2026-03-22) content — a file
path-frozen by #8461. Item 3's hygiene mirror is frozen by #8460 + #8461.

Items 1+2 are inseparable, and items 2+3 require touching mirror pages owned by
the stale/conflicting PRs #8460 and #8461. Recommendation: resolve/close those
two PRs (or lift the freeze), then land items 1+2+3 in one Tier-1 PR. Details in
the mission library note.

…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>
@scarmani scarmani marked this pull request as ready for review June 21, 2026 15:11
@scarmani

Copy link
Copy Markdown
Collaborator Author

Claude independent model review

Reviewer: claude (anthropic) — independent adversarial model review via the Aragora Claude reviewer, grounded on the exact PR head.
Head: f72daaf (f72daaf), committed 2026-06-21T15:08:28Z.
PR: #8516.
Model family: claude

Verdict: PASS

All changes are documentation-only and verified internally consistent:

  • sync-docs.js DOC_MAP key status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md resolves under SOURCE_DIR (docs/) to an existing file — confirmed present.
  • docs/INDEX.md and docs/README.md links now point at status/EXECUTION_NEXT_6_WEEKS_2026-03-05.md, which exists; no broken links.
  • The docs-site copy body is byte-identical to the source plan (only Docusaurus frontmatter prepended), so no sync drift.
  • No dangling references to the old archive/status/2026-02-25-EXECUTION_NEXT_6_WEEKS.md path remain (the archive file itself is correctly left in place).
  • Hygiene-register text edits (docs-site + docs/status) are consistent with each other and now name the live plan path.

No correctness, security, or regression risk in this change set.

No findings.

dogfood: yes

@scarmani

Copy link
Copy Markdown
Collaborator Author

Gemini independent model review

Reviewer: gemini (google) — independent adversarial model review via Antigravity CLI harness, grounded on the exact PR head.
Head: f72daaf (f72daaf), committed 2026-06-21T15:08:28Z.
PR: #8516.
Model family: gemini

Verdict: PASS

  • [P3] docs-site/docs/contributing/execution-next-6-weeks-2026-03-05.md (under CI/Gate Commands): Commands 1–6 reference python instead of python3, which is inconsistent with repository standards (e.g. AGENTS.md) and will cause execution failures in environments where python maps to Python 2 or is unregistered.

dogfood: yes

@scarmani scarmani merged commit f6db64b into main Jun 21, 2026
76 of 79 checks passed
@scarmani scarmani deleted the structex/p2-docs-active-plan-link-fix branch June 21, 2026 17:59
scarmani added a commit that referenced this pull request Jun 22, 2026
…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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant