Echo 1.0: Echo Docs Split Before Release

[flyingrobots]

Before Echo 1.0, split durable documentation out of the Echo code repository.

Doctrine

• Echo repo answers: what builds, what is enforced, what must not drift?
• Echo Docs answers: what does it mean, how do I understand it?
• GitHub Issues answer: what work exists?
• GitHub Milestones answer: what goalpost are we closing?
• GitHub Projects answer: what is the operating view right now?

Required slices

• Inventory repo docs by owner: code-coupled, public docs, historical design, tracking, delete.
• Create echo-docs repository with license, README, publishing target, and cross-link policy.
• Move public docs, narrative docs, diagrams, and historical design archive.
• Replace moved docs in Echo with stubs only where inbound links require them.
• Delete repo-local planning surfaces and backlog folders.
• Add a docs drift guard that rejects static issue counts, task-list roadmaps, branch-status prose, and dead planning paths.
• Update contributor workflow for code docs vs reader docs vs GitHub work tracking.

Exit criteria

• Echo repo contains only code-coupled docs and stable engineering doctrine.
• Echo Docs owns reader-facing and historical documentation.
• Live planning is in GitHub Issues/Milestones/Projects.
• Release docs point to the split correctly.

[coderabbitai]

🔗 Related PRs

#18 - docs: import selected docs from geom smoke branch [merged]
#309 - feat: add Doghouse PR flight recorder [merged]
#326 - Echo contract hosting roadmap [merged]
#529 - Add Hello Echo demo and docs lifecycle policy [merged]
#540 - Add Echo-owned file aperture [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!