fix(best-practices): restore canonical content, dedupe, sync script, spec exemplar

- best-practices/v1: replace 9 stale symlinks (into planning/v1) with real files
  synced byte-identical from the canonical best-practices project; add INDEX.md,
  scripting.md, mechanical-test-generation.md (canonical had drifted heavily,
  e.g. api-design.md 463->807 lines)
- planning/v1: delete duplicated best-practices/ copy (requires: inheritance
  confirmed via spec/harness.md HC-1/HC-7)
- scripts/sync-best-practices.sh: idempotent re-sync from canonical checkout
- code-methodology/v1: INDEX.md + scripting.md references now resolve; point
  test-writing tasks at mechanical-test-generation.md
- spec-writing/v1: worked spec exemplar (module layout table, Why: lines, exact
  error messages, parametrize pattern table) + CLAUDE.md pointer + mount entry
This commit is contained in:
Paul O'Reilly
2026-07-02 21:27:43 +12:00
parent 97d98689be
commit dab3db3727
26 changed files with 4010 additions and 2411 deletions

View File

@@ -10,6 +10,8 @@ Before starting any task:
- Python task → read `test-driven-development.md`, `spec-driven-development.md`
- Kubernetes task → read `kubernetes.md`
- Shell scripts → read `scripting.md`
- Writing tests mechanically from a spec (test-writer role, or any task deriving
test files directly from spec requirements) → read `mechanical-test-generation.md`
4. Read the relevant topic files from `/workspace/best-practices/`
5. Apply those practices to your work