Appendix C — Source-document crosswalk
This appendix is the machine-checkable record that nothing in the source corpus was orphaned by the wiki rewrite. Every document under knowledge/ (and docs/review/) maps to the chapter or chapters that absorbed it, with one of three dispositions. KEPT (reference) — the file stays in place as a citable reference source, deeper than the wiki chapter that summarizes it. ARCHIVED — the file’s content was fully absorbed into the wiki and the original moved to knowledge/archived/, where each archived file carries a header pointing back to the chapter that now owns it. TOOL DEP — the file stays in place because a skill or script reads it directly (scaffold-robot, analyze-team, setup-logging/simulation/testing, build_site.py, agent_score.py); it is load-bearing tooling, not just prose.
| Source document | Absorbed by | Disposition |
|---|---|---|
INDEX.md | — (the annotated index of knowledge/ itself) | Not absorbed — tooling/index; read by skills to navigate the corpus |
| build-spec/ | ||
elite-architecture.md | Part I + Part II (ch. 1–23) | TOOL DEP — kept; source for scaffold-robot / analyze-team |
code-review-principles.md | Appendix D | ARCHIVED |
logging.md | Part I ch. 7 + Part III ch. 29 | TOOL DEP — kept; source for setup-logging |
simulation.md | Part I ch. 7 + Part II | TOOL DEP — kept; source for setup-simulation |
testing.md | Part I ch. 7 + Part II | TOOL DEP — kept; source for setup-testing |
other-topics.md | Part I ch. 9 — Other advanced topics | ARCHIVED |
subsystems/00–08 | Part II ch. 18 (and ch. 15–23) | KEPT (reference source) |
| corpus-analysis/ | ||
02-frc-37-team-survey.md | Part I + Appendix A | ARCHIVED |
03-io-layer-strategy-pattern.md | Part I ch. 3, Part II ch. 16–17, Appendix B | ARCHIVED |
04-novice-to-elite-progression.md | Appendix A ch. 3 — maturity ladder | KEPT (reference) |
05-motor-io-interfaces.md | Part II ch. 17, Part III ch. 26 | KEPT (reference) |
06-lessons-from-broader-robotics.md | Lessons from Outside ch. 1 | ARCHIVED |
07-code-generators.md | Lessons from Outside ch. 2 | KEPT (reference) |
08-drivetrain-as-architecture.md | Part I ch. 6, Part II ch. 19, Part III ch. 27 | KEPT (reference) |
| rubric/ | ||
rubric.md | Scoring — the rubric in full + Appendix A ch. 2 | TOOL DEP — kept; read by build_site.py, agent_score.py, scoring skills |
| survey/ | ||
sd-frc-final-report.md (+ inventories + *.csv) | Scoring — the San Diego scoresheet + Appendix A ch. 4 | KEPT (reference) |
sd-frc-scores-pilot.md | Appendix A ch. 2 (the pilot that fixed two scoring rules) + Scoring — the San Diego scoresheet | KEPT (reference) |
| examples/ | ||
methodology.md | Appendix A ch. 1 | KEPT (reference) |
sample-score-output-reefscape2025.md | Scoring — the rubric in full (worked candidate-pass example, cited in the scoring procedure) | KEPT (reference) |
patribots-four-year-scoring.md | Scoring — the Patribots, four years | KEPT (reference) |
patribots-four-year-scoring.pdf | same as the .md above (PDF rendering) | KEPT (reference artifact) |
| alternatives/ | ||
01–04 + README | Part I ch. 8, Part II ch. 23 | KEPT (reference) |
| specs/ | ||
portable-component-model.md | Part III ch. 25 (and ch. 24, 28–31), Appendix B | KEPT (reference) |
portable-motor-interface.md | Part III ch. 26 | KEPT (reference) |
portable-swerve-interface.md | Part III ch. 27 | KEPT (reference) |
| docs/review/ | ||
portable-component-model-review.md | Part III ch. 32 | KEPT (reference) |