A workbook can be built from an epic that has already shipped, so a new engineer learns the codebase by rebuilding it on a scratch branch — graded by the criteria the original work was graded by, and taught by the decisions the original work recorded. The theory half gains the close record's key decisions, its deviation rationale, and the process lesson. The answer key is one command away in git history, and the workbook says so rather than pretending to a guard it does not have.
Meta
- feature: docs/features/roadmap-driven-learning
- estimate: S
- candidate stories: A closed epic resolves as a roadmap; Theory is sourced from the close record and the process lesson as well as the decision record; A scratch branch is graded against acceptance criteria and never against diff similarity; The workbook states plainly that the answer key exists in history
- source: decomposition of "A teaching stage that turns a planned roadmap into hands-on exercises, placing the required theory immediately before each one — /nxs.teach, producing a workbook" (2026-08-31)
A workbook can be built from an epic that has already shipped, so a new engineer learns the codebase by rebuilding it on a scratch branch — graded by the criteria the original work was graded by, and taught by the decisions the original work recorded. The theory half gains the close record's key decisions, its deviation rationale, and the process lesson. The answer key is one command away in git history, and the workbook says so rather than pretending to a guard it does not have.
Meta