mirror of
https://github.com/boshu2/agentops.git
synced 2026-09-14 15:08:13 +08:00
Bo
62cc3b6ee0
Closes out the six residual items #1051 disclosed: terminology residue on non-authority surfaces, the eval command-surface fixture that failed when executed (#{3,4} -> #{3,5}), the vacuous retrieval-quality canary and the nightly job that ran it, the consumer-free dream config block and its exclusive helpers, the remaining knowledge-shaped writers moved to the scratch tier, and the MEMORY.md consumer audit. bin/ralph still resumes legacy .agents/ralph/ checkpoints so the documented backwards-compat contract holds without a migration; both paths and the outside-both refusal are now tested. Fresh author-distinct validation returned PASS with empty not_checked, after an earlier revision failed on a dangling nightly invoker and a back-compat test regression that were fixed and independently re-verified. Test-Removal-Reason: the dream config subsystem was deleted with its tests (operations-layer residuals)
116 lines
3.7 KiB
YAML
116 lines
3.7 KiB
YAML
schema_version: agentops-documentation-authority.v1
|
|
status: active
|
|
|
|
# This contract records human and agent judgments; the checker proves only
|
|
# filesystem, index, ownership-path, and literal-reference facts.
|
|
scope:
|
|
root_markdown_count: 10
|
|
reference_excludes:
|
|
- glob: .agents/rpi/**
|
|
reason: generated runtime evidence
|
|
- glob: docs/releases/**
|
|
reason: immutable release history
|
|
- glob: docs/plans/**
|
|
reason: historical planning records
|
|
- glob: docs/audits/**
|
|
reason: point-in-time audit evidence
|
|
- glob: docs/provenance/**
|
|
reason: append-only provenance evidence
|
|
- glob: docs/handoffs/**
|
|
reason: historical session handoffs
|
|
- glob: spec/teardown-2026-05-28/**
|
|
reason: archived teardown specification
|
|
- glob: CHANGELOG.md
|
|
reason: immutable release history
|
|
|
|
documents:
|
|
- path: AGENTS.md
|
|
tracked: true
|
|
class: operating-contract
|
|
disposition: retain-and-tighten
|
|
owner: AGENTS.md
|
|
proof: scripts/check-cathedral-cut-conformance.py plus fresh-context verdicts
|
|
references:
|
|
phase_policy: {inventory: exact, pre-cutover: exact, cutover: exact}
|
|
include_globs:
|
|
- docs/agent-workflow-reference.md
|
|
- docs/CI-CD.md
|
|
- docs/contracts/codex-skill-api.md
|
|
consumers:
|
|
- docs/agent-workflow-reference.md
|
|
- docs/CI-CD.md
|
|
- docs/contracts/codex-skill-api.md
|
|
|
|
- path: CLAUDE.md
|
|
tracked: true
|
|
class: compatibility-adapter
|
|
disposition: retain-symlink
|
|
owner: AGENTS.md
|
|
proof: factual symlink and owner-path checks
|
|
|
|
- path: README.md
|
|
tracked: true
|
|
class: public-entrypoint
|
|
disposition: retain-and-tighten
|
|
owner: README.md
|
|
proof: scripts/check-cathedral-cut-conformance.py plus fresh-context verdicts
|
|
|
|
- path: PRODUCT.md
|
|
tracked: true
|
|
class: product-contract
|
|
disposition: retain-and-tighten
|
|
owner: PRODUCT.md
|
|
proof: scripts/check-cathedral-cut-conformance.py
|
|
|
|
- path: GOALS.md
|
|
tracked: true
|
|
class: fitness-contract
|
|
disposition: retain-and-tighten
|
|
owner: GOALS.md
|
|
proof: ao goals validate --json
|
|
|
|
- path: CHANGELOG.md
|
|
tracked: true
|
|
class: release-history
|
|
disposition: retain-historical
|
|
owner: CHANGELOG.md
|
|
proof: tests/docs/validate-doc-release.sh
|
|
|
|
- path: PROGRAM.md
|
|
tracked: true
|
|
class: product-boundary
|
|
disposition: retain-and-tighten
|
|
owner: PROGRAM.md
|
|
proof: Cathedral Cut conformance
|
|
|
|
# MEMORY.md is a temporary machine-consumed projection, not an AgentOps
|
|
# authority: its claims belong to their cited sources (docs, ADRs, session
|
|
# records). Consumer audit (2026-08-07): two live consumers exist — the
|
|
# corpus-delta eval harness (scripts/corpus-delta-harness.sh reads it as a
|
|
# context surface in both A/B arms) and the coding-agent convention of
|
|
# loading a root memory file. The former ao session memory writer is
|
|
# removed, so the file is read-only surface. Retained; retire when the
|
|
# harness stops reading it and the convention is served by a caller-owned
|
|
# memory system.
|
|
- path: MEMORY.md
|
|
tracked: true
|
|
class: machine-consumed-memory-projection
|
|
disposition: retain-until-consumers-migrate
|
|
owner: MEMORY.md
|
|
proof: factual path and consumer audit
|
|
|
|
- path: PRACTICE-REGISTRY.md
|
|
tracked: true
|
|
class: machine-consumed-practice-registry
|
|
disposition: retain-until-structured-owner-exists
|
|
owner: PRACTICE-REGISTRY.md
|
|
proof: scripts/validate-practice-citations.sh
|
|
|
|
- path: release-notes.md
|
|
tracked: false
|
|
presence: optional-generated
|
|
class: ignored-generated-runtime-output
|
|
disposition: preserve-outside-repository-cleanup
|
|
owner: scripts/extract-release-notes.sh
|
|
proof: tests/docs/validate-doc-release.sh
|