yoi/work-items/closed/20260601-110026-docs-information-architecture/thread.md

Created

Created by tickets.sh create.

---

Implementation report

Implementation report

Summary

Reorganized maintained repository documentation around current Yoi design intent and development workflow.

Changes

• Replaced the root README.md with a concise developer entry point.
• Added docs/README.md as the documentation map and contribution boundary.
• Added maintained design docs under docs/design/:
  • overview.md
  • pod-session-state.md
  • context-history.md
  • profiles-manifests-prompts.md
  • tool-permissions-scope.md
  • memory-knowledge.md
  • compaction.md
  • provider-model-boundary.md
• Added maintained development docs under docs/development/:
  • work-items.md
  • workflows.md
  • validation.md
  • dogfooding.md
  • environment.md
• Moved old top-level docs, docs/plan/, docs/ref/, and docs/research/ material into ignored docs/.local/old-docs/ so the repository documentation surface no longer presents it as current authority.

Validation

• ./tickets.sh doctor => doctor: ok
• git diff --check => passed
• stale-surface grep over README.md, maintained docs/, and crate READMEs excluding docs/report/ and docs/.local/ => no output

---

Closed

Completed documentation information architecture cleanup: root and docs README now define maintained docs surface; design/development docs added; old plan/ref/research/top-level docs moved out of maintained surface; validation passed.

---