Commit Graph

1 Commits

Author SHA1 Message Date
John Dvorak 6a3a101ef4 docs: add REFACTOR execution plan with 10-phase structural roadmap
Documents the end-to-end refactor strategy for high-assurance frontend
testing. Prioritizes hard structural work (typed predicate protocol,
compound AST, world schema consolidation, fact planning, runtime
isolation) before polish items (API docs, CLI, naming).

Includes: north star, refactor principles, required gates per batch,
10 phases with acceptance criteria, suggested execution order, first
concrete milestone, things to avoid, and a definition of 'trustworthy
enough'.

Items 1-4 now complete and verified:
  1. Predicate spec protocol (5 commits)
  2. Compound relation AST (2 commits)
  3. World schema smuggling elimination (1 commit)
  4. Fact planning from specs (1 commit)

658 tests pass.
2026-05-22 15:04:31 -07:00