Bo 5b334a13f2 docs(ao): categorize reduction surface (#811) ...

## Summary
- add root `REDUCTION.md` defining the lean AO vs MTO reduction boundary
and reversible KEEP / RELOCATE / ARCHIVE / RESEARCH buckets
- add `docs/reduction/ao-file-buckets.tsv`, a generated per-file
inventory for every current `cli/cmd/ao/*.go` file with bucket,
rationale, and import dependency clusters
- inventory totals: 637 files = 450 KEEP, 146 RELOCATE, 2 ARCHIVE, 39
RESEARCH

## Validation
- `test "$(( $(wc -l < docs/reduction/ao-file-buckets.tsv) - 1 ))" -eq
"$(find cli/cmd/ao -maxdepth 1 -name '*.go' | wc -l)"`
- `bash scripts/regen-all.sh --check`
- `git diff --check`
- `PRE_PUSH_SKIP_MKDOCS=1 bash scripts/pre-push-gate.sh --fast` passed;
warning-only executable-spec drift remains pre-existing (`scenarios
--lint`, `trace --orphans`)

BR: cp-q4d

2026-06-07 02:13:46 -04:00

..

_hooks

fix(docs): unbreak mkdocs --strict — drop deleted HOOKS.md emit (ag-u46) (#521)

2026-05-24 18:29:31 -04:00

adr

docs: reconcile legacy-RPI-lane doctrine + ADR-0009 substrate marker (ag-etgr #frozen-rpi-doctrine) (#698)

2026-06-03 12:51:49 +00:00

architecture

docs(architecture): add integrator (merge-execution) to agentpod function enum (ag-egpu) (#802)

2026-06-06 12:53:09 -04:00

assets

docs(readme): command-by-command AgentOps hero (v5) (#753)

2026-06-05 15:43:42 +00:00

brainstorms

docs(3.0): ag-p7j W3 — reframe peripheral docs to in-session (ag-p7j) (#528)

2026-05-24 21:20:11 -04:00

code-map

docs(3.0): ag-p7j W1 — delete daemon contracts, regen generated docs, reframe skills (ag-p7j) (#529)

2026-05-24 21:55:17 -04:00

comparisons

chore(docs): gut dead-mechanism context poison from agent-facing docs (ag-sjz8 #gut-poison) (#764)

2026-06-06 09:44:45 -04:00

contracts

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

convergence

docs(architecture): formalize the L0-L4 autonomy ladder (ag-wrom #autonomy-ladder) (#787)

2026-06-06 12:18:20 +00:00

council-log

…

domains

Executable spec layer (epic soc-58nt, F2–F5): GOALS as BDD acceptance criteria (#292)

2026-05-17 15:31:15 -04:00

evidence

…

examples

docs(3.0): ag-p7j W3 — reframe peripheral docs to in-session (ag-p7j) (#528)

2026-05-24 21:20:11 -04:00

getting-started

fix(ops): route work selection through reconciliation

2026-05-26 19:07:42 -04:00

learnings

docs(ship-loop): encode 2026-05-19 self-correction learnings into doctrine (soc-7ovd) (#354)

2026-05-19 16:57:21 +00:00

levels

…

migration-trackers

…

overrides

…

patterns

docs(substrate): reconcile doctrine — skill-dispatch + drop Gas City reference (ag-88y5 #docs-skills-dispatch-reframe) (#696)

2026-06-03 12:11:23 +00:00

plans

docs(plan): PMF blocker analysis and execution plan (#557)

2026-05-28 13:56:24 +00:00

positioning

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

profiles

docs(3.0): sweep remaining daemon/schedule/hook prose + MIGRATION-3.0 (ag-qbw) (#520)

2026-05-24 18:27:24 -04:00

reduction

docs(ao): categorize reduction surface (#811)

2026-06-07 02:13:46 -04:00

reference

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

releases

chore(corpus): refresh stale flywheel-compounding snapshot (ag-omcw #refresh-snapshot) (#716)

2026-06-04 08:22:40 -04:00

rescope

docs(rescope): close 13-cycle DDD/hex rescope arc with retrospective

2026-05-12 22:56:00 -04:00

rfcs

docs(3.0): sweep remaining daemon/schedule/hook prose + MIGRATION-3.0 (ag-qbw) (#520)

2026-05-24 18:27:24 -04:00

runbooks

docs(substrate): reconcile doctrine — skill-dispatch + drop Gas City reference (ag-88y5 #docs-skills-dispatch-reframe) (#696)

2026-06-03 12:11:23 +00:00

sovereignty-proof

feat(skills)!: 3.0 consolidation — merge 4, cut 2, resolve 6 keep-flags (81→75) (#533)

2026-05-24 23:17:27 -04:00

standards

…

templates

docs(3.0): sweep remaining daemon/schedule/hook prose + MIGRATION-3.0 (ag-qbw) (#520)

2026-05-24 18:27:24 -04:00

workflows

docs(hookless): close cold-start orientation drift (soc-qh2g1 #cold-start-orientation-coherence) (#795)

2026-06-06 11:23:56 -04:00

3.0-readiness.md

feat(hookless)!: remove all hooks — skills + CLI only (soc-57b7f #remove-all-hooks) (#511)

2026-05-24 11:19:37 -04:00

3.0.md

docs(doctrine): reconcile 3.0.md tooling-floor wording with the bd/git floor (ag-60jd #tooling-floor-reconcile) (#790)

2026-06-06 14:07:38 +00:00

activation-profiles.md

refactor(gc): strip Gas City coupling; adopt NTM+MCP+managed-agents (ag-124p) (#679)

2026-06-02 09:06:41 -04:00

agent-footguns.md

docs: remove hooks-as-live-runtime refs from footguns/context-packet/seed (ag-t1ca #small-files) (#710)

2026-06-03 21:50:55 -04:00

agent-workflow-reference.md

docs(workflow): surface make regen-all finalizer in contributor docs (ag-hlng #regen-all-discoverability) (#659)

2026-05-31 15:23:07 -04:00

agentops-3-explainer-kit.md

docs: reconcile narrative docs with retired daemon/Gas-City + reframe Anthropic claim (ag-6v3j #convergent) (#708)

2026-06-03 21:33:26 -04:00

agentops-3-pmf-evidence-loop.md

docs: re-narrate live Gas City operator instructions to NTM+MCP+managed-agents (ag-r6g1 #docs-slice) (#687)

2026-06-02 15:31:05 -04:00

agentops-3-youtube-starter-series.md

docs: re-narrate live Gas City operator instructions to NTM+MCP+managed-agents (ag-r6g1 #docs-slice) (#687)

2026-06-02 15:31:05 -04:00

agentops-brief.md

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

agentops-system-map.md

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

agents-operator-guide.md

…

ARCHITECTURE.md

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

assurance-profile.md

feat: factory claim ledger with proof taxonomy (soc-kizn.1) (#256)

2026-05-07 17:58:23 -04:00

behavioral-discipline.md

docs: fix broken intra-repo links in docs/ (ag-28dp #docs-link-rot) (#781)

2026-06-06 10:17:39 -04:00

brownian-ratchet.md

docs(roadmap): move aspirational claims into docs/ROADMAP.md (soc-icvff #w1b-roadmap) (#470)

2026-05-23 10:08:13 -04:00

cdlc.md

docs(doctrine): re-narrate out-of-session substrate Gas City → NTM+MCP+managed-agents (ag-vg40 #substrate-renarration) (#676)

2026-06-02 07:51:25 -04:00

CHANGELOG.md

chore(release): v3.0.1 — plugin version bump + Nightly Static Validation fix (ag-s3z) (#539)

2026-05-25 08:54:37 -04:00

CI-CD.md

docs: re-narrate live Gas City operator instructions to NTM+MCP+managed-agents (ag-r6g1 #docs-slice) (#687)

2026-06-02 15:31:05 -04:00

CLEANUP-distill-to-core.md

docs(cleanup): add AgentOps distill-to-core plan (ag-eli0)

2026-06-06 12:22:30 -04:00

cli-skills-map.md

feat(ao): add harness-neutral bead ports (#810)

2026-06-07 02:03:39 -04:00

cli-surface.json

feat(ao): add harness-neutral bead ports (#810)

2026-06-07 02:03:39 -04:00

cli-surface.md

feat(ao): add harness-neutral bead ports (#810)

2026-06-07 02:03:39 -04:00

CODE_OF_CONDUCT.md

…

context-lifecycle.md

docs: fix broken intra-repo links in docs/ (ag-28dp #docs-link-rot) (#781)

2026-06-06 10:17:39 -04:00

context-packet.md

docs(hookless): close cold-start orientation drift (soc-qh2g1 #cold-start-orientation-coherence) (#795)

2026-06-06 11:23:56 -04:00

CONTRIBUTING.md

…

create-your-first-skill.md

docs: fix broken intra-repo links in docs/ (ag-28dp #docs-link-rot) (#781)

2026-06-06 10:17:39 -04:00

curation-pipeline.md

feat(ci): gate live-hooks reintroduction in docs/ (ag-rryf #doc-hooks-drift-gate) (#713)

2026-06-03 22:38:26 -04:00

daemon-migration.md

docs: reconcile narrative docs with retired daemon/Gas-City + reframe Anthropic claim (ag-6v3j #convergent) (#708)

2026-06-03 21:33:26 -04:00

dependencies.md

chore(docs): drop dead ao evolve refs from agent-facing docs (ag-354d #doc-refs) (#736)

2026-06-05 02:51:40 +00:00

documentation-index.md

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

domain-practice-packets.md

docs: rename PRACTICE.md to PRACTICE-REGISTRY.md + add CDLC narrow-waist doctrine

2026-05-15 20:16:53 -04:00

ENV-VARS.md

docs(hookless): close cold-start orientation drift (soc-qh2g1 #cold-start-orientation-coherence) (#795)

2026-06-06 11:23:56 -04:00

evolve-setup.md

chore(docs): drop dead ao evolve refs from agent-facing docs (ag-354d #doc-refs) (#736)

2026-06-05 02:51:40 +00:00

FAQ.md

docs(positioning): assurance profile + goals as reconcile setpoints (soc-sx99) (#257)

2026-05-07 17:50:17 -04:00

first-value-path.md

docs: fix docs asserting Gas City is the reference -> NTM+MCP+managed-agents (ag-r6g1 #docs-slice-2) (#689)

2026-06-02 16:06:22 -04:00

flywheel-audit.md

…

GLOSSARY.md

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

how-it-works.md

docs: fix docs asserting Gas City is the reference -> NTM+MCP+managed-agents (ag-r6g1 #docs-slice-2) (#689)

2026-06-02 16:06:22 -04:00

INCIDENT-RUNBOOK.md

docs: de-hook the 6 big operator/architecture docs (ag-t1ca #big-files) (#711)

2026-06-03 22:05:09 -04:00

index.md

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

knowledge-flywheel.md

docs(3.0): sweep remaining daemon/schedule/hook prose + MIGRATION-3.0 (ag-qbw) (#520)

2026-05-24 18:27:24 -04:00

leverage-points.md

feat(ci): gate live-hooks reintroduction in docs/ (ag-rryf #doc-hooks-drift-gate) (#713)

2026-06-03 22:38:26 -04:00

local-compute-routing.md

docs: finish doc-staleness epic tails — local-model framing + dead test paths (ag-ph6h, ag-j4tw) (#712)

2026-06-03 22:11:05 -04:00

LOOP-BUDGET.md

fix(docs): purge dangling validate-hooks-doc-parity.sh refs from operational docs (ag-c2i #operational-docs-no-dangling-hooks-parity-ref) (#579)

2026-05-28 09:18:59 -04:00

MIGRATION-3.0.md

refactor(gc): strip Gas City coupling; adopt NTM+MCP+managed-agents (ag-124p) (#679)

2026-06-02 09:06:41 -04:00

newcomer-guide.md

docs(audit): remediate stale root + key docs — hookless refs, skill counts, retired CI jobs (ag-lk80 #staleness-fixes) (#705)

2026-06-03 20:44:06 -04:00

one-session-mode.md

docs(one-session-mode): AgentOps maximally-Claude one-session mode (ag-eli0)

2026-06-06 13:52:21 -04:00

origin-story.md

…

philosophy.md

docs: finish doc-staleness epic tails — local-model framing + dead test paths (ag-ph6h, ag-j4tw) (#712)

2026-06-03 22:11:05 -04:00

preserved-refs.tsv

docs: retire integrated executable-spec preserve refs

2026-05-17 06:38:01 -04:00

PRODUCT-TEMPLATE.md

…

re-steer-policy.default.json

Executable spec layer (epic soc-58nt, F2–F5): GOALS as BDD acceptance criteria (#292)

2026-05-17 15:31:15 -04:00

reference.md

docs(hookless): close cold-start orientation drift (soc-qh2g1 #cold-start-orientation-coherence) (#795)

2026-06-06 11:23:56 -04:00

release-e2e-checklist.md

feat(ci): gate live-hooks reintroduction in docs/ (ag-rryf #doc-hooks-drift-gate) (#713)

2026-06-03 22:38:26 -04:00

RELEASING.md

fix(ops): route work selection through reconciliation

2026-05-26 19:07:42 -04:00

rg-optimized.md

chore: scrub all jsm references — external ref only, patterns kept (soc-wnic7 #scrub-jsm) (#501)

2026-05-23 22:41:56 -04:00

ROADMAP.md

docs: reconcile legacy-RPI-lane doctrine + ADR-0009 substrate marker (ag-etgr #frozen-rpi-doctrine) (#698)

2026-06-03 12:51:49 +00:00

scale-without-swarms.md

…

SCHEMAS.md

docs(hookless): close cold-start orientation drift (soc-qh2g1 #cold-start-orientation-coherence) (#795)

2026-06-06 11:23:56 -04:00

SECURITY.md

…

seed-definition.md

docs: remove hooks-as-live-runtime refs from footguns/context-packet/seed (ag-t1ca #small-files) (#710)

2026-06-03 21:50:55 -04:00

SKILL-API.md

feat(agentops): make 3.0 hookless-first

2026-05-16 09:43:08 -04:00

SKILL-ROUTER.md

docs: clarify AgentOps golden paths

2026-05-03 00:41:17 -04:00

skills-decision-tree.md

docs: clarify AgentOps golden paths

2026-05-03 00:41:17 -04:00

SKILLS.md

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

software-factory.md

docs: fix broken intra-repo links in docs/ (ag-28dp #docs-link-rot) (#781)

2026-06-06 10:17:39 -04:00

strategic-direction.md

feat(ci): gate live-hooks reintroduction in docs/ (ag-rryf #doc-hooks-drift-gate) (#713)

2026-06-03 22:38:26 -04:00

task-proposals-2026-04-29.md

…

test-architecture-debt-analysis.md

feat(skills): land four-vendor skill corpus (#803)

2026-06-06 23:44:42 -04:00

testing-skills.md

docs: finish doc-staleness epic tails — local-model framing + dead test paths (ag-ph6h, ag-j4tw) (#712)

2026-06-03 22:11:05 -04:00

TESTING.md

docs: finish doc-staleness epic tails — local-model framing + dead test paths (ag-ph6h, ag-j4tw) (#712)

2026-06-03 22:11:05 -04:00

the-science.md

docs(positioning): wiki-framing sweep across all surface docs (soc-9xn0) (#262)

2026-05-07 21:04:47 -04:00

troubleshooting.md

fix(memory): reconcile W6 cutover commands

2026-06-05 04:50:49 -04:00

trust-factory.md

docs: rename PRACTICE.md to PRACTICE-REGISTRY.md + add CDLC narrow-waist doctrine

2026-05-15 20:16:53 -04:00

UPGRADING.md

feat(ci): gate live-hooks reintroduction in docs/ (ag-rryf #doc-hooks-drift-gate) (#713)

2026-06-03 22:38:26 -04:00

wiki-for-agents.md

fix(memory): reconcile W6 cutover commands

2026-06-05 04:50:49 -04:00