docs(readme): split 89 KB monolith into hero-pitch + 6 docs/ files
README down from 89 KB to 7.8 KB (11x reduction, target was 10-15 KB).
Visitor-facing README now loads in one screen — hero + 3 killer features
+ what-it-solves + quick install + docs index.
Extracted 6 new files under docs/:
- INSTALL.md (15 KB) — prerequisites, profiles, interactive install,
MCP binary, keisei CLI intro, runtime hook controls, what-you-get table
- REFERENCE.md (35 KB) — every one of 25 Rust primitives + 13 shell
primitives + 10 hooks + 39 skills with actual CLI surface (clap flags,
exit codes, env vars, state paths), keisei CLI deep-dive, 12 pipelines
- ARCHITECTURE.md (11 KB) — build pipeline, creating-a-new-agent,
adding custom blocks/manifests, agents overview, cross-tool bridges,
meta-composer, regen counts, workflow-file editing protocol
- SLEEP-LAYER.md (11 KB) — three-phase nightly cycle diagram,
session self-audit (RULE 0.14), Cloud REM sync, sleep-on-it incubation,
deep-sleep NREM consolidation with 4-primitive pipeline + example
- SECURITY.md (7.6 KB) — threat surface table + 8 mitigations in detail
(memory-repo privacy, secrets-guard patterns, supply-chain SHA pinning,
S3 SSRF, brain path/name validation, exFAT warning, battle matrix)
- WHY.md (3.6 KB) — full 'From the author' manifesto restored from
git history (pre-1f3aaca product pivot). Medium/dev.to-friendly for
virality, separate from the product README
New docs cross-link each other + README has docs index in tail.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ce9ba61ee0