docs: remove legacy/history archival docs + trim runbooks to generic essentials#120
Merged
Merged
Conversation
…essentials Remove archival V1->V2->flatten->reorg migration narrative (LEGACY-CLEANUP.md + docs/history/) and fix every live reference so no link dangles. Trim the three operator runbooks to generic bounded-infra ops, dropping operator-personal anecdotes and verbose narrative while keeping load-bearing steps/commands. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
De-personalizes and de-clutters the public docs: removes the V1→V2→flatten→reorg archival migration narrative (no longer relevant to a fresh reader), fixes every live reference so no link dangles, and trims the three operator runbooks to generic bounded-infrastructure ops.
Removed (git rm — history preserved)
docs/LEGACY-CLEANUP.mddocs/history/(all 5:AUDIT.md,CUTOVER.md,FLIP.md,PARITY-VALIDATION.md,PARITY.md)Broken links fixed
Every tracked live file that pointed at a removed doc was reworded to drop the dangling link (banner narrative kept where it stands alone):
CONTRIBUTING.md— LEGACY-CLEANUP + history/CUTOVER linksAGENTS.md— LEGACY-CLEANUP + history/CUTOVERCHANGELOG.md— LEGACY-CLEANUP inventory pointerdocs/configuration.md,docs/data.md,docs/GETTING_STARTED.md,docs/hermes-agent.md— LEGACY-CLEANUP + history/CUTOVERdocs/operator-guide.md— history/FLIP, history/CUTOVER, history/PARITY, history/PARITY-VALIDATION, history/AUDIT (6 sites)docs/product requirements docs/architecture-and-principles.md— docs/history tree note + LEGACY-CLEANUPscripts/README.md,secrets/README.md— history/CUTOVER + LEGACY-CLEANUPservices/ops-api/README.md— history/AUDIT + history/PARITY-VALIDATIONservices/codebase-memory/README.md,services/codebase-memory-ui/README.md— history/PARITYgit grepproves zero remaining refs toLEGACY-CLEANUP/docs/history// the 5 filenames in tracked files.Runbooks trimmed (generic essentials kept, personal/verbose cut)
docs/runbooks/auth.mddocs/runbooks/bounded-hermes.mddocs/runbooks/secrets.mdCut: operator-personal anecdotes (CADDY_BIND "operator-approved 2026-07-17" date, the DASHBOARD_TRUSTED_PROXY_NET subnet-drift incident row, the
ordo-hermes-backuppersonal git remote, the self-hosted-SearXNG aside, Discord-specific troubleshooting → generalized to "a provider"), duplicated background, and long narrative wrappers. Kept (tighter): all setup/rotation/recovery commands, the OpsClient bounded-ops API surface, audit-log + add-a-verb procedures, and the troubleshooting tables — these are load-bearing for any operator. Reductions are under 50% because these are command-dense reference docs with little prose padding; halving would have deleted genuine generic steps.bounded-hermes.mdis preserved (it's referenced by the Hermes agent skills) and trimmed in place.Validation
python -m ruff check .→ clean.python -m pytest tests/ -q→ 556 passed, 4 skipped. 3 pre-existing failures intests/substrate/are from uncommitted operator WIP incatalog/models.yaml(swaps the ultra model tofable-qwen3.6-27b-q6), not this PR — verified by stashing the WIP (all 3 pass) and by this PR being docs-only. No test reads the removed doc paths (greppedtests/).🤖 Generated with Claude Code