Group the top-level docs into docs/project, docs/design, docs/assets and docs/process, each with its own README index. Delete the superseded docs/screens/head-review page and sheets. Rewrite every markdown link, absolute docs path and tool/test reference to the new locations, fix the pre-existing broken anchors and remove the dead Joke Shop photo-board link. check_docs OK, Python tooling 167/167.
Design Documentation
Gameplay, venues, presentation and player-facing constraints.
gameplay.md— the playable loop, escalation mechanics, venues and tutorial.venues.md— real-site evidence, game mapping and venue simplifications.ui-copy.md— screen, copy and button inventory plus the screen-design judge record.accessibility.md— accessibility statement and known gaps.known-limitations.md— release blockers and accepted limitations.
Up: ../README.md · Product plan: ../../PLAN.md · Tasks:
../../TODO.md.