Context
#11605 is the parent program for compressing skill baggage into decision-atom maps. Its AC3 requires an inventory of .agents/skills/**/*.md workflow payloads before the hot-path pilots start.
Current topology check: #11884 covers #11605 AC1/AC2. The remaining parent AC3 inventory work has no native child handle yet. Exact synced-content sweep found #11605 as the owning parent and no equivalent AC3 inventory child.
The Problem
The team has identified a recurring failure mode: hot-path agent skills accumulate incident archaeology, edge-case stories, and repeated rule payload until routine lifecycle work becomes token-expensive and easy to half-read.
Before editing pr-review, pull-request, or other hot paths again, the swarm needs a measured inventory that separates:
- runtime rules that must stay loaded,
- compactable behavior atoms,
- atlas/provenance payload that should move behind triggers,
- stale or duplicate material that can be retired.
Without this inventory, the next PR risks becoming another hand-picked rewrite instead of a governed loaded-surface reduction.
The Architectural Reality
This work is read-only analysis over the agent skill substrate. It does not rewrite skills directly.
The owning parent is #11605. The governing patterns are ADR 0007 Map-vs-World-Atlas compaction, ADR 0008 skill anatomy, and the shipped recursive trigger-aware workflow substrate from #11319. /create-skill remains the skill-shape authority; this inventory supplies the data for later child tickets.
The Fix
Produce a ranked inventory for .agents/skills/**/*.md and directly referenced workflow payloads that identifies high-cost runtime surfaces and proposes a disposition for each relevant section.
Minimum disposition vocabulary:
keepcompress-to-triggermoverewriteretire
The output should be concise enough to guide child-ticket creation, not another large always-loaded guide.
Contract Ledger Matrix
| Target Surface |
Source of Authority |
Proposed Behavior |
Fallback |
Docs |
Evidence |
| Skill baggage inventory report |
#11605 AC3 |
Ranked audit with byte counts, section counts, and disposition candidates |
Existing parent AC remains unfulfilled |
Issue comment or compact repo doc chosen during implementation |
Reproducible measurement command plus sampled section evidence |
| Disposition vocabulary |
#11605 + ADR 0007/0008 |
Use keep, compress-to-trigger, move, rewrite, retire consistently |
Parent prose remains the only taxonomy |
Inventory output |
Each candidate section has one disposition and brief intent rationale |
| Follow-up child topology |
#11605 AC4-AC8 |
Inventory recommends bounded pilot/batch child tickets rather than one migration PR |
Future agents re-derive scope from the epic |
Native child issues or explicit deferrals |
Links or proposed issue list in the inventory output |
Decision Record impact
Aligned with ADR 0007 and ADR 0008. This ticket does not amend either ADR; it gathers evidence for the migration program defined in #11605.
Acceptance Criteria
Out of Scope
- Rewriting
pr-review, pull-request, or any other skill in this ticket.
- Deleting incident history.
- Creating new lifecycle gates.
- Treating byte reduction as the only success metric; behavior preservation still matters.
Avoided Traps
- Hand-editing the loudest skill first without measuring the broader surface.
- Moving prose into another always-loaded file and calling it compression.
- Producing an inventory so large that it becomes a new context-drain artifact.
- Collapsing all #11605 remaining ACs into one migration PR.
Related
Parent: #11605
First child: #11884
Related: #11604, #11603, #11319, #10537
Origin Session ID: 967e325b-d90a-43f4-9e91-c212e9bda746
Retrieval Hint: skill baggage inventory decision atom maps byte counts disposition keep compress-to-trigger move rewrite retire pr-review pull-request
Context
#11605 is the parent program for compressing skill baggage into decision-atom maps. Its AC3 requires an inventory of
.agents/skills/**/*.mdworkflow payloads before the hot-path pilots start.Current topology check: #11884 covers #11605 AC1/AC2. The remaining parent AC3 inventory work has no native child handle yet. Exact synced-content sweep found #11605 as the owning parent and no equivalent AC3 inventory child.
The Problem
The team has identified a recurring failure mode: hot-path agent skills accumulate incident archaeology, edge-case stories, and repeated rule payload until routine lifecycle work becomes token-expensive and easy to half-read.
Before editing
pr-review,pull-request, or other hot paths again, the swarm needs a measured inventory that separates:Without this inventory, the next PR risks becoming another hand-picked rewrite instead of a governed loaded-surface reduction.
The Architectural Reality
This work is read-only analysis over the agent skill substrate. It does not rewrite skills directly.
The owning parent is #11605. The governing patterns are ADR 0007 Map-vs-World-Atlas compaction, ADR 0008 skill anatomy, and the shipped recursive trigger-aware workflow substrate from #11319.
/create-skillremains the skill-shape authority; this inventory supplies the data for later child tickets.The Fix
Produce a ranked inventory for
.agents/skills/**/*.mdand directly referenced workflow payloads that identifies high-cost runtime surfaces and proposes a disposition for each relevant section.Minimum disposition vocabulary:
keepcompress-to-triggermoverewriteretireThe output should be concise enough to guide child-ticket creation, not another large always-loaded guide.
Contract Ledger Matrix
keep,compress-to-trigger,move,rewrite,retireconsistentlyDecision Record impact
Aligned with ADR 0007 and ADR 0008. This ticket does not amend either ADR; it gathers evidence for the migration program defined in #11605.
Acceptance Criteria
.agents/skills/**/*.mdand directly referenced workflow payloads for loaded byte counts and section counts.keep,compress-to-trigger,move,rewrite, orretire.pr-reviewandpull-requestif still supported by measurements.Out of Scope
pr-review,pull-request, or any other skill in this ticket.Avoided Traps
Related
Parent: #11605 First child: #11884 Related: #11604, #11603, #11319, #10537
Origin Session ID: 967e325b-d90a-43f4-9e91-c212e9bda746
Retrieval Hint:
skill baggage inventory decision atom maps byte counts disposition keep compress-to-trigger move rewrite retire pr-review pull-request