2026-07-14 22:01:50 -04:00
|
|
|
# Documentation index
|
|
|
|
|
|
|
|
|
|
This index is generated from live files by `scripts/generate-documentation-index.py`.
|
|
|
|
|
Dated plans, audits, releases, and archive material are historical evidence, not current authority.
|
|
|
|
|
|
|
|
|
|
## Product and workflow
|
|
|
|
|
|
2026-07-20 19:05:57 -04:00
|
|
|
- [README](https://github.com/boshu2/agentops/blob/main/README.md)
|
|
|
|
|
- [Product boundary](https://github.com/boshu2/agentops/blob/main/PRODUCT.md)
|
|
|
|
|
- [Fitness goals](https://github.com/boshu2/agentops/blob/main/GOALS.md)
|
|
|
|
|
- [Program boundary](https://github.com/boshu2/agentops/blob/main/PROGRAM.md)
|
Align AgentOps around its operations-layer identity (#1051)
Executes docs/plans/2026-08-07-agentops-operations-layer-alignment.md:
AgentOps is the operations layer for agentic engineering; the federated
integration graph is the topology, the semantic work-and-proof protocol
is the contract, and RPI is the standard one-experiment traversal.
Retires the ao flywheel command family and all knowledge-flywheel
product state, tombstones the seven-move operating-loop workflow,
narrows ao init and the .agents state writers to declared destinations,
renames the core architecture page to rpi-traversal.md with a
compatibility redirect, aligns AGENTS.md, 25 skills, public and package
copy, regenerates every owned projection, and strengthens the
conformance gates with planted-negative proofs.
Both the alignment subject and the follow-up gate-bookkeeping commit
carry fresh author-distinct validation PASS verdicts with empty
not_checked scope.
Test-Removal-Reason: dead knowledge-flywheel and session-store surfaces were deleted with their tests (operations-layer alignment)
2026-08-07 18:37:03 -04:00
|
|
|
- [RPI traversal](architecture/rpi-traversal.md)
|
feat(gc): ship thin native AgentOps factory pack (#980)
## Outcome
Ships AgentOps 3.3 as a thin native Gas City pack and removes the
accidental second orchestration control plane.
- Removes the custom GC delivery command/package, packet/schema family,
feeder/program engine, reducer/order, reliability registry, Beads
capability mirror, and fork-baseline runtime checks (about 29k deleted
lines).
- Retains six bounded adapters for pinned toolchain materialization,
clean bootstrap, native sling/status/doctor invocation, bead-isolated
worktrees, moving-main PR delivery, and teardown.
- Uses official Gas City and Beads behavior as the state owners, with
required OTEL configuration.
- Preserves Fable Mayor/Refiner, Sol-high planning and fresh validation,
Terra-high default implementation, Opus-medium overflow, and
support-only Luna.
- Supports automatic Refiner merge after hosted CI or a manual-review
toggle without locking `main`.
## Evidence
- Exact official GC: `8ffc009ded781a2ada2077f3a29bd712b2def0bf`
- Exact official BD: `8e4e59d39f3459a43cf21a3236a13eca4dd874f7`
- Full pinned native boundary: 9/9 passed in 114.047s
- Exact source-bead route replay: passed in 98.051s
- Release replay: manifest integrity, thin tests and both pack lints,
generated projections, contract compatibility, Bats contract,
ShellCheck, test-removal ratchet, and `go test ./...` all passed
- Fresh independent semantic verdict: PASS (Sol-high)
- Exact delivered head: `e805f0e26ce21c2eae9e720f57fff2a705f3185b`
- Subject manifest:
`8554d065076f70d0e639ca353409d2a75dca7ac01e4cb65cb4a118e98c0770fc`
- Verdict:
`3f89376b675de854832f38b46ccfa7ad7ca54079ffde578769c33e1f118c68c1`
## Release boundary
After this PR merges, the release qualification runs one fresh mixed
Terra/Opus canary from merged `main`, with at most one external repair
and one terminal retry. No live city repairs itself.
The only known local fast-gate exception is `workflow.install-drift`:
the installed workflow symlink resolves to the separate dirty primary
checkout, outside this candidate. All candidate-owned gates passed.
2026-07-22 19:08:02 -04:00
|
|
|
- [Gas City reliability boundary](operations/gas-city-reliability.md)
|
2026-07-14 22:01:50 -04:00
|
|
|
- [Agent workflow](agent-workflow-reference.md)
|
|
|
|
|
- [Repository CI and delivery](CI-CD.md)
|
|
|
|
|
- [Component map](architecture/component-map.md)
|
|
|
|
|
- [Ports and adapters](architecture/ports-and-adapters.md)
|
|
|
|
|
- [Skill router](SKILL-ROUTER.md)
|
|
|
|
|
- [Skill graph](reference/agentops-skill-graph.md)
|
|
|
|
|
|
|
|
|
|
## Contracts
|
|
|
|
|
|
|
|
|
|
- [Agents Documentation Authority](contracts/agents-documentation-authority.yaml)
|
|
|
|
|
- [Bounded Contexts](contracts/bounded-contexts.yaml)
|
|
|
|
|
- [Ci Jobs](contracts/ci-jobs.yaml)
|
|
|
|
|
- [Codex Skill API Contract](contracts/codex-skill-api.md)
|
|
|
|
|
- [AgentOps context map](contracts/context-map.md)
|
|
|
|
|
- [Corpus learning seam — the field-level public/private boundary](contracts/corpus-learning-seam.md)
|
|
|
|
|
- [Critical Skills](contracts/critical-skills.txt)
|
|
|
|
|
- [Finding Artifact.Schema](contracts/finding-artifact.schema.json)
|
|
|
|
|
- [Finding Compiler Contract](contracts/finding-compiler.md)
|
|
|
|
|
- [Finding Registry Contract](contracts/finding-registry.md)
|
|
|
|
|
- [Finding Registry.Schema](contracts/finding-registry.schema.json)
|
|
|
|
|
- [Forbidden Claims](contracts/forbidden-claims.yaml)
|
feat(gc): ship thin native AgentOps factory pack (#980)
## Outcome
Ships AgentOps 3.3 as a thin native Gas City pack and removes the
accidental second orchestration control plane.
- Removes the custom GC delivery command/package, packet/schema family,
feeder/program engine, reducer/order, reliability registry, Beads
capability mirror, and fork-baseline runtime checks (about 29k deleted
lines).
- Retains six bounded adapters for pinned toolchain materialization,
clean bootstrap, native sling/status/doctor invocation, bead-isolated
worktrees, moving-main PR delivery, and teardown.
- Uses official Gas City and Beads behavior as the state owners, with
required OTEL configuration.
- Preserves Fable Mayor/Refiner, Sol-high planning and fresh validation,
Terra-high default implementation, Opus-medium overflow, and
support-only Luna.
- Supports automatic Refiner merge after hosted CI or a manual-review
toggle without locking `main`.
## Evidence
- Exact official GC: `8ffc009ded781a2ada2077f3a29bd712b2def0bf`
- Exact official BD: `8e4e59d39f3459a43cf21a3236a13eca4dd874f7`
- Full pinned native boundary: 9/9 passed in 114.047s
- Exact source-bead route replay: passed in 98.051s
- Release replay: manifest integrity, thin tests and both pack lints,
generated projections, contract compatibility, Bats contract,
ShellCheck, test-removal ratchet, and `go test ./...` all passed
- Fresh independent semantic verdict: PASS (Sol-high)
- Exact delivered head: `e805f0e26ce21c2eae9e720f57fff2a705f3185b`
- Subject manifest:
`8554d065076f70d0e639ca353409d2a75dca7ac01e4cb65cb4a118e98c0770fc`
- Verdict:
`3f89376b675de854832f38b46ccfa7ad7ca54079ffde578769c33e1f118c68c1`
## Release boundary
After this PR merges, the release qualification runs one fresh mixed
Terra/Opus canary from merged `main`, with at most one external repair
and one terminal retry. No live city repairs itself.
The only known local fast-gate exception is `workflow.install-drift`:
the installed workflow symlink resolves to the separate dirty primary
checkout, outside this candidate. All candidate-owned gates passed.
2026-07-22 19:08:02 -04:00
|
|
|
- [GC 3.3 migration provenance](contracts/gc33-migration-provenance.md)
|
2026-07-14 22:01:50 -04:00
|
|
|
- [Contracts](contracts/index.md)
|
2026-07-15 10:00:26 -04:00
|
|
|
- [Optional Lesson Format](contracts/lesson-format.md)
|
2026-07-14 22:01:50 -04:00
|
|
|
- [Superseded Historical ADR: Local Push-Gate Experiments](contracts/local-pre-push-gate-retirement.md)
|
|
|
|
|
- [Multi-runtime tier charter](contracts/multi-runtime-tier-charter.md)
|
|
|
|
|
- [Optional dispatch adapter](contracts/orchestration-ports.md)
|
|
|
|
|
- [Contract: PMF Evidence Gate](contracts/pmf-evidence.md)
|
|
|
|
|
- [Producer-Defect Recurrence Contract](contracts/producer-defect-register.md)
|
2026-07-15 00:21:02 -04:00
|
|
|
- [Generated skill projections](contracts/registry-as-derived.md)
|
2026-07-15 10:00:26 -04:00
|
|
|
- [Release Notes Contract](contracts/release-notes.md)
|
Structural: goals→fitness rename with compatibility alias; shared retired to a declared contract owner (#1007)
## Summary
The two structural beads deferred from the skill-overhaul reboot waves.
**goals → fitness** (`age-skill-overhaul-reboot-sjv7v.10`, 07-24 plan
D9)
- The semantic skill is now `fitness`; the `ao goals` CLI command family
deliberately keeps its name.
- `skills/goals` remains a thin, non-advertised compatibility alias:
user-invocable, zero capabilities/effects/dependencies, an `alias-of`
context_rel edge to fitness, physical deletion only under the
observed-zero policy.
- `alias-of` added to the frontmatter schema enums (the catalog schema's
own description already listed it as valid relationship vocabulary; the
enum lagged).
- bootstrap's `goals` consumer edge migrated; the stale `goals.feature`
row in the scenario-linkage contract corrected (the feature file was
already absent).
**shared retirement** (`age-skill-overhaul-reboot-sjv7v.11`, 07-24 plan
D9)
- The runtime-neutrality contract moved to its declared owner:
`docs/contracts/runtime-neutrality.md`, scope unchanged (shared
references a consuming skill loads).
- The last consumer edge (`bootstrap consumes: shared`) removed;
`skills/shared` reduced to a non-routable tombstone pending the
observed-zero deletion window; the ports-and-adapters contract updated
to executed state.
## Validation
- Strict frontmatter 50/50 (fitness + alias); regen byte-current;
scenario-linkage PASS; liveness/anti-spiral/desc-budget bats green;
`cli/internal/skills` Go tests pass
- Cross-family review, two rounds: round 1 — one finding fixed
(unintended contract-scope broadening reverted), one rejected with
evidence (the reviewer inferred a pre-existing feature file from a stale
doc row; the pre-change tree had none); round 2 delta **VERDICT: PASS**
Tracker: `age-skill-overhaul-reboot-sjv7v.10`, `.11`
2026-07-29 01:03:12 -04:00
|
|
|
- [Runtime Neutrality Contract](contracts/runtime-neutrality.md)
|
2026-07-14 22:01:50 -04:00
|
|
|
- [Scenario → Test Linkage Contract](contracts/scenario-test-linkage.md)
|
|
|
|
|
- [Scope Escape Report Template](contracts/scope-escape-report.md)
|
Skill overhaul reboot: lean plan, salvaged evidence, validator liveness, anti-spiral hardening (W0+W1) (#998)
## Summary
Reboots the stalled 2026-07-24 skill-system overhaul as a lean wave
program and lands its first two beads, plus the anti-spiral hardening
from the 2026-07-28 incident brief.
**W0 — salvage + plan** (`age-skill-overhaul-reboot-sjv7v.1`)
- Lean reboot plan (`docs/plans/2026-07-28-skill-overhaul-reboot.md`):
per-skill enhancement in 8 waves via normal RPI; proof-epoch machinery
explicitly abandoned; 07-24 plan marked superseded.
- Salvages the four Sol-reviewed per-skill audits (49 canonical skills)
+ program validation from `/tmp` into
`docs/audits/2026-07-28-skill-overhaul-reboot/raw/`, the 07-24 plan/duel
docs, and the 07-25 progress review; distills them into four actionable
checklists (231 tagged items, all hypotheses to re-verify).
**W1 — validator liveness** (`age-skill-overhaul-reboot-sjv7v.2`)
- Seven skill validators (rpi, plan, implement, learn, ms, scaffold,
security) had `! grep` forbidden-phrase guards that are silent no-ops
under `set -euo pipefail`. Witnessed RED, converted to the `if grep …;
exit 1` house form, reworded learn's boundary sentence.
- `tests/scripts/skill-validator-liveness.bats`: whitespace-class static
sweep + seeded behavioral liveness with unseeded pre-check.
**Anti-spiral hardening** (incident: 326 control artifacts, zero
implementation commits, RPI never invoked)
- **rpi**: automatic admission (orchestration/delegation/"execute this
plan"); phase lock after an accepted plan; spiral breaker — two
consecutive control artifacts with no new implementation evidence →
`NOT_BUILT`; subject-first reporting. All pinned by validator greps.
- **validate**: nonempty-implementation-candidate precondition;
`store-verdict` CLI mechanically refuses an empty subject manifest.
- **AGENTS.md**: constraint floor (a plan/duel frozen without the active
ADRs/blocking gates is invalid) + ADR-0016 pointer;
phase-lock/spiral-stop lines in the core loop.
- `tests/scripts/anti-spiral-contract.bats`: stripping any pinned phrase
fails the owning validator; empty-manifest refusal is behaviorally
tested.
- Placement report with proposed host-level `CLAUDE.md` rule and
`dueling-idea-wizards` packet-completeness patch:
`docs/audits/2026-07-28-skill-overhaul-reboot/anti-spiral-hardening.md`.
## Validation
- RED→GREEN witnesses for all seven guards; 15/15 bats across both new
suites
- 16/16 validate-skill unit tests; 9/9 rpi kernel tests; 8/8 skill
validators
- `scripts/regen-all.sh --check` clean; `shellcheck -S warning` clean
- Cross-family (Codex) review round 1: 3 findings, all fixed; delta
re-review in flight (two-round ceiling per plan)
Known pre-existing: `validate-skill-frontmatter.sh --strict` warns on
skill-builder's missing optional `context_rel` (present on
`origin/main`; assigned to W4).
Tracker: `age-skill-overhaul-reboot-sjv7v`; waves W2–W8 follow as
separate PRs.
2026-07-28 09:29:14 -04:00
|
|
|
- [Skill system architecture](contracts/skill-ports-and-adapters.md)
|
2026-07-14 22:01:50 -04:00
|
|
|
- [Ubiquitous language](contracts/ubiquitous-language.md)
|
|
|
|
|
- [Update Principles Contract](contracts/update-principles.md)
|