README dropped from ~503 to ~141 lines — skimmable in under a minute.
The long-form content moved into 7 titled pages under documentation/:
install, how-it-works, vs-cot-and-tot, frames, when-to-use, api, evals.
Added a Featured section near the top: The New Stack feature story,
OpenClaw community testing testimonial, and the external research review.
Kept above the fold: hero, badges (+ New Stack), the architectural pitch,
one-command install, quickstart, a 2-step how-it-works summary, the
headline results table, and a documentation index table.
docs/ stays reserved for GitHub Pages assets (hero.png, og, index.html);
documentation/ holds the browsable markdown so the two never collide.
Udit Raj