docs(upstream): aihero course lane 6: shared vocabulary adoption and aihero-course provenance doc

[kyle-sexton]

Context

Sixth and final vetting lane for the AI Hero course lessons; contract in docs/topics/pocock-course-lanes/PLAN.md (branch claude/plan-mode-discussion-55kszx). Runs last by construction: it harvests decisions from lanes 1-5. Establishes course-lesson provenance as a distinct tracked source (course content has no releases, so it needs its own recheck-trigger discipline) and decides which of his dictionary terms enter our ubiquitous language.

Proposed work

• Create docs/upstream/aihero-course.md (amended per A2: created by lane 1) — consolidate and finalize: trigger discipline stated, cross-linked from docs/upstream/mattpocock-skills.md; all lane 1-5 decision rows collected
• Decide term adoption via /domain-driven-design:curate-language: smart zone, primary/secondary source, AFK, design concept, phase boundary, and terms lanes 1-5 surfaced
• Carry the bookkeeping from the 2026-08-17 recheck: annotate the SSOT's TRACK rows (invocation-reach invariant landed unreleased via mattpocock/skills PRs feat(planning): route incumbency-driven plan-review findings to incumbent mode #878/feat(typos-format): per-file typos autofix hook plugin #880; diagnosing-bugs dropped its post-mortem step); apply the A1 row-35 correction; fix the v12-map private-marketplace staleness
• Evaluate the portable authoring finding for our own skills (explicit "Call the Skill tool" phrasing) — recorded in the SSOT annotation for evaluation when the release trigger fires

Acceptance criteria

• docs/upstream/aihero-course.md exists with its own trigger discipline and all lane decision rows, cross-linked from the SSOT
• The coverage index in the parent topic maps every lesson claim to a decision row, filed item, or explicit not-relevant note (the effort's completion gate)
• SSOT TRACK-row annotations landed (plus the A1 row-35 correction and the v12-map staleness fix)
• Term-adoption decisions recorded; glossary updates routed through /domain-driven-design:curate-language (outcome: no central glossary exists; creation deferred per its lazy-creation rule with the placement question surfaced to the user; seven verdicts recorded in the provenance doc)
• Work items filed for anything decided but not executed in-lane (none required; the deferred glossary is a user decision, not a filed item)

References

• docs/topics/pocock-course-lanes/PLAN.md (contract; coverage index)
• docs/upstream/mattpocock-skills.md (SSOT; annotated)
• docs/conventions/upstream-drift/README.md (observable-trigger bar)

Metadata

Field	Value
Category	unspecified
Area	docs, upstream
Ecosystem	unspecified

[kyle-sexton]

Scope note from the steering-section session (2026-08-17, branch claude/pocock-steering-course-00zkvd): the course's nine steering lessons were inventoried and filed as lanes 7–9 (#2909, #2910, #2911) — index and lesson-coverage map in docs/topics/pocock-course-lanes/STEERING.md on that branch. Two things land in this lane's harvest:

• Coverage index: extend it to the nine steering lessons; each steering lane's acceptance criteria name the lessons it owns. All three should close before this lane does.
• Term-adoption candidates from the steering lessons: sediment, cache (environment-as-truth restated in a doc), push vs point, context load, cognitive load, navigation pointer. Note existing collisions: "tombstone" is already used here for lease/compatibility markers (different sense), and "sediment" appears once in playbooks:fable-5 execution doctrine (code sense).

Also relevant to the TRACK-row annotation item already in this lane's scope: the session re-evaluated the writing-for-agents rejection and superseded it in the SSOT (decomposition table, commit 80fee78a); both tracked strands now carry disposition paths through #2909/#2910.

---

Generated by Claude Code

[kyle-sexton]

Two audit amendments (user-approved 2026-08-17, recorded in docs/topics/pocock-course-lanes/PLAN.md at 1d54cd46) adjust this lane's scope:

1. A2 — creation ownership moved: lane 1 (session-flow/handoff: aihero course lane 1: use-case boundaries, purpose argument, expiry #2899) creates the docs/upstream/aihero-course.md skeleton (row schema + divergence-at-re-fetch trigger form fixed at creation), and lanes 1-5 write their rows directly into it as they close. This lane no longer creates the doc; it keeps the coverage index, term-adoption decisions, SSOT TRACK-row annotations, and final consolidation. Read "Create docs/upstream/aihero-course.md" in this issue's Proposed work as "consolidate and finalize" accordingly.

2. A1 — one more bookkeeping row: correct the SSOT's row-35 phrase "our measured bands stand" (docs/upstream/mattpocock-skills.md) to match context-guard's own language — the shipped band thresholds are "declared judgment defaults" with named provenance, not measurements (both audit validators cited plugins/context-guard/reference/reader-contract.md and the README). This joins the two existing TRACK-row annotation items already listed here.

---

Generated by Claude Code

[kyle-sexton]

Coordination note (2026-08-17): a parallel session is running a teach-skill comparison against Matt Pocock's material (branch claude/teach-skill-comparison-h3rpag; his teach maps to our education plugin per docs/upstream/mattpocock-skills-v12-map.md row 22, CONVERGENT). Any adopt/reject/track decisions it produces about his course or skills content belong in the SAME provenance home this effort establishes — docs/upstream/aihero-course.md (course-lesson claims; skeleton owned by lane 1 per the A2 amendment) or docs/upstream/mattpocock-skills.md (skills-repo claims) — under the same row conventions. This lane's consolidation pass should check that branch's outcomes and fold them in rather than letting a second convention emerge.

---

Generated by Claude Code

[kyle-sexton]

Lane 9 (#2911) term-candidate increment for the adoption decision here: "highway / stale highway" (lesson 6's navigation-pointer metaphor, used in lane 9's decision rows in docs/topics/pocock-course-lanes/STEERING.md). Adds to the lane-7 list already posted on this issue; lane 6 decides adoption.

---

Generated by Claude Code