Clip managed product-repo AGENTS.md after the fleet context audit #607

Open
opened 2026-07-23 17:55:34 +00:00 by coilyco-ops · 1 comment
Owner

Dependency

Depends on coilyco-flight-deck/agentic-os#657 and participates in AOS #655.

Goal

Use the deterministic AGENTS.md inventory to clip managed product repos without changing the AOS substrate contract. Each product repo should retain only unconditional repo-specific doctrine that truly belongs in every session for that repo.

Ownership and rollout

  • AOS authors the inventory and classification engine.
  • Infrastructure owns the canonical managed-repo manifest and fleet rollout.
  • Each target repo owns its AGENTS.md and receives its own reviewed commit.
  • Ward setup and package installation do not perform install-time mass mutation.
  • AOSH remains a separate hardware provider and is not added to the AOS substrate or global context.

Acceptance

  • Derive the target set as the infrastructure-managed repo universe minus the committed AOS substrate set.
  • Consume AOS #657 output rather than rescanning arbitrary local checkout paths.
  • Preserve repository-specific unconditional commands, safety boundaries, ownership, and load-point bridges.
  • Remove doctrine already supplied by the composed global base.
  • Move role-specific depth to role COMPOSED.md, task-specific capability to an admitted skill, durable explanation to docs, and mechanical invariants to code or validators.
  • Preserve managed pointer blocks and generated artifacts through their owning generators.
  • Keep root and nested AGENTS.md cascade semantics valid for every target harness.
  • Apply changes as repo-owned commits with a per-repo before/after token report and a reversible audit log.
  • Record explicit exemptions for repos whose unconditional doctrine cannot shrink.
  • Do not auto-load agentic-os-hardware AGENTS.md or its skill catalog as part of the rollout.
  • Re-run AOS #656 for all selected lanes after the fleet changes and link the before/after result.
  • Add a dry-run or check mode that reports drift without mutating repos.

Done condition

The managed product fleet is converged, each repo's own validations pass, canonical Forgejo main contains the changes, and AOS #657 reports no unexplained duplicate global doctrine in product AGENTS.md files.

## Dependency Depends on coilyco-flight-deck/agentic-os#657 and participates in AOS #655. ## Goal Use the deterministic AGENTS.md inventory to clip managed product repos without changing the AOS substrate contract. Each product repo should retain only unconditional repo-specific doctrine that truly belongs in every session for that repo. ## Ownership and rollout * AOS authors the inventory and classification engine. * Infrastructure owns the canonical managed-repo manifest and fleet rollout. * Each target repo owns its AGENTS.md and receives its own reviewed commit. * Ward setup and package installation do not perform install-time mass mutation. * AOSH remains a separate hardware provider and is not added to the AOS substrate or global context. ## Acceptance * Derive the target set as the infrastructure-managed repo universe minus the committed AOS substrate set. * Consume AOS #657 output rather than rescanning arbitrary local checkout paths. * Preserve repository-specific unconditional commands, safety boundaries, ownership, and load-point bridges. * Remove doctrine already supplied by the composed global base. * Move role-specific depth to role COMPOSED.md, task-specific capability to an admitted skill, durable explanation to docs, and mechanical invariants to code or validators. * Preserve managed pointer blocks and generated artifacts through their owning generators. * Keep root and nested AGENTS.md cascade semantics valid for every target harness. * Apply changes as repo-owned commits with a per-repo before/after token report and a reversible audit log. * Record explicit exemptions for repos whose unconditional doctrine cannot shrink. * Do not auto-load agentic-os-hardware AGENTS.md or its skill catalog as part of the rollout. * Re-run AOS #656 for all selected lanes after the fleet changes and link the before/after result. * Add a dry-run or check mode that reports drift without mutating repos. ## Done condition The managed product fleet is converged, each repo's own validations pass, canonical Forgejo main contains the changes, and AOS #657 reports no unexplained duplicate global doctrine in product AGENTS.md files.
Author
Owner

AOS #657 landed agents-context-inventory on main at 5c822c3. Infrastructure must supply its canonical managed-repo manifest as owner/name visibility entries. The legacy status-line list cannot be reused unchanged: its bare agentic-os entry resolves to multiple checkouts on the initiating host, and it carries no public/private provenance. The AOS command fails closed on that ambiguity and emits no doctrine text for private repositories.

AOS #657 landed `agents-context-inventory` on main at `5c822c3`. Infrastructure must supply its canonical managed-repo manifest as `owner/name visibility` entries. The legacy status-line list cannot be reused unchanged: its bare `agentic-os` entry resolves to multiple checkouts on the initiating host, and it carries no public/private provenance. The AOS command fails closed on that ambiguity and emits no doctrine text for private repositories.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
coilyco-flight-deck/infrastructure#607
No description provided.