docs(upstream): AI Hero course journey roadmap — remaining lanes and filed follow-ons, in order

[kyle-sexton]

Context

Durable roadmap for the AI Hero course (Matt Pocock) vetting journey, so the ordered queue survives handoffs, /clears, and fresh containers (handoff files are memory-tier and never committed). Contract: docs/topics/pocock-course-lanes/PLAN.md on branch claude/plan-mode-discussion-55kszx (unmerged); consolidated decision record: docs/upstream/aihero-course.md (chain branch, lane 6 harvest). Update this issue's checklist as items close; close it when the journey's completion gate (lane 6's coverage index) is met.

Done

• Lane 1 session-flow/handoff: aihero course lane 1: use-case boundaries, purpose argument, expiry #2899 (handoff boundaries) — closed; filed session-flow/handoff: adopt purpose argument across the save-point engine (aihero lane 1) #2955, session-flow/handoff: routing-signals table, do-not-duplicate rule, worktree caveat, promote-content rule (aihero lane 1) #2956
• Lane 2 session-flow/workflow: aihero course lane 2: phase-boundaries tree re-audit and context-driven continuation router #2900 (phase-boundaries router) — closed; filed session-flow/workflow: context-driven continuation router evolution (aihero lane 2) #2971, session-flow/workflow: eval coverage for the continuation router (aihero lane 2) #2972, context-guard: reader-contract advisory-injection section predates the 0.5.0 audience split (aihero lane 2) #2973
• Lanes 7–9 playbooks/docs-hygiene: aihero course lane 7: authoring-time steering doctrine (writing-for-agents re-decision) #2909/skill-quality/plugin-philosophy: aihero course lane 8: invocation-mode doctrine and evidence-driven fleet re-grade #2910/claude-memory: aihero course lane 9: steering-surface validations (navigation pointers, harness claims, auto-memory, /init-then-prune eval) #2911 (steering section) — closed; decisions merged via PR docs: AI Hero steering-section vetting — lanes 7–9 decisions, invocation-mode rubric, harness-claims verdicts #2990; filed docs-hygiene: implement write-for-agents — authoring-time skill for agent-consumed markdown #2962, skill-quality: add completion-criteria check criterion + pointer to write-for-agents doctrine #2963, skill-quality/fleet: enforce the invocation-mode rubric — explicit disable-model-invocation on 17 skills, check criterion, skill-authoring pointer #2968, planning: flip questionnaire to model-invoked — the one invocation-mode re-grade flip #2969, claude-memory: patch audit criteria for navigation pointers — C5 carve-out, C7 stale-highway note, C3 nested CLAUDE.md + @-mention rows, design-smell remediation #2987, claude-memory: /init-then-prune eval fixture — static bloated CLAUDE.md graded against expected audit findings #2989
• Lane 3 session-flow: aihero course lane 3: compaction doctrine (fork-beats-compaction, auto-compact stance, evidence-degraded marker) #2901 — closed 2026-08-17 by TWO parallel runs (contract branch filed context-guard: document verified auto-compact-window interplay with zones #2995; chain run zero items); reconciled rows in docs/upstream/aihero-course.md lane 3
• Lane 4 planning: aihero course lane 4: plan-mode asset-rush critique vs interview-first sequencing #2902 — closed 2026-08-17 by TWO parallel runs (chain run filed planning: eval coverage for interview lock-mode STOP-on-gap and auto-detect auto-guard (aihero lane 4) #2997); asset-rush critique convergent-validated, lock audit LICENSED; reconciled rows in docs/upstream/aihero-course.md lane 4
• Lane 5 planning/interview: aihero course lane 5: grilling parity check #2903 — closed by TWO parallel runs (chain 2026-08-18 with the audit-answers overturn filing planning: interview prototype detour + plan-mode-off guidance (aihero lane 5 audit findings) #2998; contract run 6 minutes later from the committed lesson paste); merged dual-run record in docs/upstream/aihero-course.md lane 5 — the chain audit supersedes where they conflicted, the contract run's lesson basis cured the UNVERIFIED clear-step caveat
• Lane 6 docs(upstream): aihero course lane 6: shared vocabulary adoption and aihero-course provenance doc #2904 — closed 2026-08-18: aihero-course.md consolidated (interim records aihero-core-lanes.md / aihero-steering-lanes.md dissolved), C1–C9 + lane-9 verdict tables graduated, 15-term adoption recorded, SSOT TRACK-row annotations + A1/private-marketplace corrections landed, cross-skill invocation phrasing codified in the invocation-mode README, 15-lesson coverage index in place (the completion gate); filed docs: materialize the project glossary for the lane-6 adopted terms (curate-language deferred creation) #3000
• Chain close: docs-only PR docs(upstream): AI Hero course lanes 3–6 — decision records and consolidated provenance #3001 from claude/pocock-steering-course-00zkvd MERGED 2026-08-18 (squash c1986798, all 48 checks green) — the consolidated docs/upstream/aihero-course.md and the lanes 3–6 records are on the default branch

Remaining

Implementation follow-ons only (each rides its own fresh branch through the normal pipeline; sequencing constraints noted) — tracked on their own issues, not gating this roadmap:

• session-flow/workflow: context-driven continuation router evolution (aihero lane 2) #2971 → then session-flow/workflow: eval coverage for the continuation router (aihero lane 2) #2972, context-guard: reader-contract advisory-injection section predates the 0.5.0 audience split (aihero lane 2) #2973 (lane 2: router evolution, then eval coverage + reader-contract)
• session-flow/handoff: adopt purpose argument across the save-point engine (aihero lane 1) #2955, session-flow/handoff: routing-signals table, do-not-duplicate rule, worktree caveat, promote-content rule (aihero lane 1) #2956 (lane 1: purpose argument; routing-signals table)
• docs-hygiene: implement write-for-agents — authoring-time skill for agent-consumed markdown #2962 → then skill-quality: add completion-criteria check criterion + pointer to write-for-agents doctrine #2963 (lane 7: write-for-agents skill, then the audit-side criterion that points at it)
• skill-quality/fleet: enforce the invocation-mode rubric — explicit disable-model-invocation on 17 skills, check criterion, skill-authoring pointer #2968, planning: flip questionnaire to model-invoked — the one invocation-mode re-grade flip #2969 (lane 8: explicit-key normalization + check criterion; questionnaire flip — independent)
• claude-memory: patch audit criteria for navigation pointers — C5 carve-out, C7 stale-highway note, C3 nested CLAUDE.md + @-mention rows, design-smell remediation #2987 → then claude-memory: /init-then-prune eval fixture — static bloated CLAUDE.md graded against expected audit findings #2989 (lane 9: criteria patch, then the eval fixture that honors its C5 carve-out)
• context-guard: document verified auto-compact-window interplay with zones #2995 (lane 3, contract-branch run: context-guard documents the verified auto-compact config surfaces + zones-below-trigger guidance — independent)
• planning: eval coverage for interview lock-mode STOP-on-gap and auto-detect auto-guard (aihero lane 4) #2997 (lane 4: interview lock/auto-guard eval coverage — independent)
• planning: interview prototype detour + plan-mode-off guidance (aihero lane 5 audit findings) #2998 (lane 5: interview prototype detour + plan-mode-off + plan/SKILL.md reconcile — independent)
• docs: materialize the project glossary for the lane-6 adopted terms (curate-language deferred creation) #3000 (lane 6: glossary materialization for the adopted terms — needs a maintainer placement decision)

Adjacent, not in this queue

Pocock Shipping-section absorption (#2933 spec; lanes #2934–#2949) — same upstream source, separate contract and queue. Decide its interleaving now that this journey's lanes are closed.

Notes for resuming sessions

• SUPERSESSION WARNING (2026-08-18): the contract branch claude/plan-mode-discussion-55kszx carries its OWN copy of docs/upstream/aihero-course.md (lanes 1–4 plus a pre-audit lane 5). That copy is SUPERSEDED by the consolidated mainline record — when that branch eventually merges, its PR must take main's docs/upstream/aihero-course.md and drop its own, and must also graduate/prune its docs/topics/** slice per the contract-slice prune gate, and land the PENDING "six lanes → plus steering lanes" Goal amendment in its PLAN.md.
• The steering chain branch claude/pocock-steering-course-00zkvd merged twice (PR docs: AI Hero steering-section vetting — lanes 7–9 decisions, invocation-mode rubric, harness-claims verdicts #2990, then the lanes 3–6 chain via PR docs(upstream): AI Hero course lanes 3–6 — decision records and consolidated provenance #3001) — it is now fully merged and dead; nothing further lands on it.
• The lane contract (docs/topics/pocock-course-lanes/PLAN.md) still lives on the unmerged contract branch; read it via git show origin/claude/plan-mode-discussion-55kszx:docs/topics/pocock-course-lanes/PLAN.md.
• The C1–C9 verdict table is GRADUATED into docs/upstream/aihero-course.md (2026-08-18) with the C8 caveat carried — cite the graduated copy; C8 should be re-verified rather than chain-cited.

Metadata

Field	Value
Category	unspecified
Area	docs/upstream, session-flow, planning, claude-memory, skill-quality, docs-hygiene
Ecosystem	unspecified

[kyle-sexton]

Journey complete — closing this roadmap. PR #3001 merged 2026-08-18 (squash c1986798, all 48 checks green), landing the consolidated docs/upstream/aihero-course.md with the 15-lesson coverage index — the completion gate this issue was scoped to close on.

Final state: all ten discussion lanes closed (1–6 original contract + 7–9 steering) across two merged chain PRs (#2990, #3001); every lesson claim mapped to a decision row, a filed work item, or an explicit tracked/not-relevant note; harness-claims verdict tables graduated with the C8 re-verify caveat carried; 15 adopted terms recorded; SSOT annotations landed.

Not gated by this roadmap and continuing on their own issues: the nine implementation follow-ons (#2955, #2956, #2962→#2963, #2968, #2969, #2971→#2972/#2973, #2987→#2989, #2995, #2997, #2998, #3000 — sequencing arrows per the body), the contract-branch supersession obligations (recorded in the body's warning note), and the adjacent Shipping-section queue (#2933), whose interleaving is now decidable.

---

Generated by Claude Code