Keep the repository root focused on README while moving the remaining planning and swarm test documents under docs/ and indexing them there.
Constraint: The user explicitly requested that documents should live under docs/.
Rejected: Leaving older root-level Markdown files in place | it keeps the homepage cluttered and splits the documentation surface.
Confidence: high
Scope-risk: narrow
Directive: Keep future ordinary documentation under docs/ unless it is a root entrypoint such as README.md.
Tested: git diff --cached --check; find . -maxdepth 1 -type f -name '*.md' shows only README.md.
Not-tested: No runtime tests rerun because this is a documentation path-only move.
Co-authored-by: OmX <omx@oh-my-codex.dev>
