Source: 2026-04-20 multi-expert AADM audit. Docs-UX auditor.
Problem
README.md, START-HERE.md, MINIMUM-VIABLE-ADOPTION.md, handbook/Developer_Handbook.md, method/AI_Assisted_Development_Method_v3_2_1.md all re-introduce the method.
README and START-HERE have ~70% content overlap. New users bounce: README → "read START-HERE first" → START-HERE → "read method/" → 1057 lines → handbook says half of it again.
Fix
- README becomes a 30-line landing pad: links to START-HERE (adoption), MVA (incremental), method (theory), handbook (practice). Nothing re-introduces.
- START-HERE is canonical entry door for everyone.
- Each top-level doc has exactly one job, stated in its first paragraph.
Acceptance
grep -l "what AADM solves" returns one file. Same for any other introductory phrase that should appear once.
Source: 2026-04-20 multi-expert AADM audit. Docs-UX auditor.
Problem
README.md,START-HERE.md,MINIMUM-VIABLE-ADOPTION.md,handbook/Developer_Handbook.md,method/AI_Assisted_Development_Method_v3_2_1.mdall re-introduce the method.README and START-HERE have ~70% content overlap. New users bounce: README → "read START-HERE first" → START-HERE → "read method/" → 1057 lines → handbook says half of it again.
Fix
Acceptance
grep -l "what AADM solves"returns one file. Same for any other introductory phrase that should appear once.