Remove checked-in role COMPOSED sources from AOS #764

New issue

Open

opened 2026-07-27 18:27:26 +00:00 by coilyco-ops · 0 comments

coilyco-ops commented

2026-07-27 18:27:26 +00:00

Member

Decision

AOS is retiring checked-in per-agent or per-role COMPOSED.md skill sources. The current canonical tree contains 58 entry points under .agents/composed/.

The agent-compose input-contract change is tracked in agent-compose issue 106.

Migration rule

The engineer must classify each current source before removal:

Durable, broadly reusable knowledge may become an ordinary SKILL.md only when universal discoverability is intentional.
Person, role, identity, or personality policy belongs in the owning agent-compose person package.
Obsolete or duplicative material is deleted.
Role-only content must not become an ordinary skill merely to preserve every file.

Acceptance

No tracked .agents/composed/*/COMPOSED.md entry points remain.
.agents/roles.kdl no longer carries role-composed skill admission.
The check-composed-skills hook, Python entry point, implementation, tests, examples, and dogfood configuration are removed or reshaped around the surviving source model.
Seed-skill generation no longer treats composed frontmatter as its source of truth. Any still-required seeding policy moves to one explicit owner.
Context-budget classification, reports, snapshots, inventories, and generators stop reporting a role-composed source class.
README, AGENTS, docs/FEATURES.md, the personality-provider docs, role-composition docs, skill-discipline docs, and cross-links describe the surviving model.
Public feature links do not point into the removed directory.
A repository-wide search distinguishes generated aggregate COMPOSED.md output from retired checked-in skill sources.
Focused tests and full repository validation pass through Ward.
The change lands on canonical main and the normal release pipeline publishes it.

Coordination

Agent-compose issue 106 owns compiler compatibility and release order. AOS owns this provider migration and the catalog validator changes. Infrastructure owns fleet convergence after both releases.

Non-goals

Removing the generated host composition output solely because it shares the name COMPOSED.md.
Copying all 58 sources into agent-compose.
Expanding any role's runtime authority.

## Decision AOS is retiring checked-in per-agent or per-role `COMPOSED.md` skill sources. The current canonical tree contains 58 entry points under `.agents/composed/`. The agent-compose input-contract change is tracked in [agent-compose issue 106](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/106). ## Migration rule The engineer must classify each current source before removal: * Durable, broadly reusable knowledge may become an ordinary `SKILL.md` only when universal discoverability is intentional. * Person, role, identity, or personality policy belongs in the owning agent-compose person package. * Obsolete or duplicative material is deleted. * Role-only content must not become an ordinary skill merely to preserve every file. ## Acceptance * No tracked `.agents/composed/*/COMPOSED.md` entry points remain. * `.agents/roles.kdl` no longer carries role-composed skill admission. * The `check-composed-skills` hook, Python entry point, implementation, tests, examples, and dogfood configuration are removed or reshaped around the surviving source model. * Seed-skill generation no longer treats composed frontmatter as its source of truth. Any still-required seeding policy moves to one explicit owner. * Context-budget classification, reports, snapshots, inventories, and generators stop reporting a role-composed source class. * README, AGENTS, `docs/FEATURES.md`, the personality-provider docs, role-composition docs, skill-discipline docs, and cross-links describe the surviving model. * Public feature links do not point into the removed directory. * A repository-wide search distinguishes generated aggregate `COMPOSED.md` output from retired checked-in skill sources. * Focused tests and full repository validation pass through Ward. * The change lands on canonical main and the normal release pipeline publishes it. ## Coordination Agent-compose issue 106 owns compiler compatibility and release order. AOS owns this provider migration and the catalog validator changes. Infrastructure owns fleet convergence after both releases. ## Non-goals * Removing the generated host composition output solely because it shares the name `COMPOSED.md`. * Copying all 58 sources into agent-compose. * Expanding any role's runtime authority.

coilyco-ops added the

autonomy

async-consult

priority

labels

2026-07-29 03:45:20 +00:00

coilyco-ops added

priority

and removed

priority

labels

2026-07-29 06:27:29 +00:00