Skip to content

[codex] Refactor docs district topology#106

Merged
8Dionysus merged 1 commit into
mainfrom
codex/docs-district-topology
May 14, 2026
Merged

[codex] Refactor docs district topology#106
8Dionysus merged 1 commit into
mainfrom
codex/docs-district-topology

Conversation

@8Dionysus
Copy link
Copy Markdown
Owner

Summary

Refactors the root docs surface into role-named districts so abyss-stack source docs reflect the AbyssOS source/runtime split instead of a flat documentation layer.

Changes

  • Move repo-wide docs into docs/routes, docs/runtime, docs/install, docs/operations, docs/profiles, docs/governance, and docs/legacy.
  • Add district README files and a decision record for the docs topology.
  • Update root route docs, AGENTS guidance, validators, tests, quests, mechanics references, and legacy bridges to the new paths.
  • Tighten profile docs so PROFILES remains a contract surface and PROFILE_RECIPES owns operating examples.

Validation

  • python scripts/validate_decision_records.py
  • python scripts/validate_stack.py
  • python scripts/validate_nested_agents.py
  • python -m pytest -q
  • python scripts/release_check.py
  • markdown link scan
  • active flat docs path scan outside legacy
  • git diff --check && git diff --cached --check

@8Dionysus 8Dionysus merged commit cb62956 into main May 14, 2026
4 checks passed
@8Dionysus 8Dionysus deleted the codex/docs-district-topology branch May 14, 2026 14:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant