---
id: 11950
title: Inventory skill baggage for decision-atom rollout
state: CLOSED
labels:
  - documentation
  - enhancement
  - ai
  - refactoring
  - architecture
  - model-experience
assignees: []
createdAt: '2026-05-25T02:53:16Z'
updatedAt: '2026-05-25T02:54:58Z'
githubUrl: 'https://github.com/neomjs/neo/issues/11950'
author: neo-gpt
commentsCount: 1
parentIssue: null
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-05-25T02:54:58Z'
---
# Inventory skill baggage for decision-atom rollout

## Context

Parent epic #11605 defines the skill-baggage compression program. #11884 completed the first AC1/AC2 slice by codifying the decision-atom lesson-promotion shape. The next missing parent handle from the prior GPT epic review is AC3: inventory all `.agents/skills/**/*.md` workflow payloads before piloting hot-path migrations.

This child exists so the parent does not remain a prose-only program and future agents do not jump directly into broad `pr-review` / `pull-request` rewrites without evidence.

## Duplicate / adjacency sweep

- Live #11605 body and comments show #11884 as the existing AC1/AC2 child and name AC3 as a missing child.
- Live GitHub search for `skill baggage inventory decision atom maps #11605` returned only parent #11605.
- Existing adjacent tickets #11604 and #11603 are broader governance / bandwidth concerns, not the concrete inventory artifact.
- KB query for skill baggage / decision atom / map-atlas substrate confirmed existing lint and Map-vs-Atlas substrate, but did not surface a #11605 AC3 ticket.

## The Problem

The parent epic explicitly rejects a giant all-skills migration and asks for inventory before pilots. Without a concrete inventory ticket, future sessions will either:

- start compressing hot-path skills from intuition;
- over-focus on byte counts without checking trigger frequency and behavior risk;
- miss existing lint/manifest budget signals; or
- recreate one-off audits that are not usable as rollout planning input.

The inventory is the evidence layer that makes later `pr-review`, `pull-request`, and batch rollout children scoped instead of aesthetic cleanup.

## The Architectural Reality

Current substrate already has several relevant anchors:

- `test/playwright/unit/ai/scripts/lint/lintSkillManifest.spec.mjs` covers per-file payload budgets, oversized workflow maps, and section-trigger parsing.
- `.agents/skills/pr-review/references/pr-review-guide.md` and `.agents/skills/pr-review/assets/pr-review-template.md` already encode Progressive Disclosure / Map-vs-Atlas review gates.
- ADR 0007 and ADR 0008 define compaction taxonomy and Progressive Disclosure skill anatomy.
- #11884 closed the first source-of-authority slice for `Bias -> Rule -> Rationale -> Trigger`; this ticket consumes that atom, it does not redefine it.

The inventory belongs as an audit artifact plus ranked rollout plan, not as immediate runtime instruction substrate.

## The Fix

Create a focused inventory artifact for `.agents/skills/**/*.md` workflow payloads:

1. Enumerate skill payload files, grouped by skill and load role (`SKILL.md`, workflow map, audit payload, template, incident/provenance payload).
2. Measure byte count / line count and flag budget or map-pressure signals already covered by lint substrate.
3. Identify sections with incident/provenance baggage, repeated edge-case stories, absent trigger pointers, or candidate `Bias -> Rule -> Rationale -> Trigger` compression.
4. Assign disposition candidates: `keep`, `compress-to-trigger`, `move`, `rewrite`, or `retire`.
5. Produce a ranked rollout table for the pilot and batch tickets, including `pr-review` and `pull-request` but not modifying them in this child.

## Contract Ledger Matrix

| Target Surface | Source of Authority | Proposed Behavior | Fallback / Edge Case | Docs | Evidence |
|---|---|---|---|---|---|
| Skill baggage inventory artifact | #11605 AC3; #11884 decision atom source | Records measured skill payload size, section risk, and disposition candidates across `.agents/skills/**/*.md`. | If a file is generated or non-workflow-only, classify it and exclude from migration ranking with rationale. | Yes | Artifact includes file list, counts, and disposition table. |
| Rollout ranking table | #11605 AC4-AC6 | Produces candidate order for `pr-review`, `pull-request`, and later batch groups by risk/size, not aesthetic preference. | If inventory shows pilot order should change, document why rather than forcing parent prose. | Yes | Table maps parent ACs to recommended children / follow-ups. |
| Behavior-preservation signals | #11605 AC9/AC10; ADR 0007/0008 | Each candidate disposition notes what behavior must remain load-bearing after compression. | If behavior cannot be preserved by atom+trigger, mark `keep` or `rewrite`, not `retire`. | Yes | Inventory rows include behavior-risk notes and required validation signals. |
| Existing lint substrate usage | `lintSkillManifest.spec.mjs`; Progressive Disclosure review gates | Inventory reuses existing budget/map concepts instead of inventing a parallel scoring model. | If lint lacks a needed signal, file a follow-up rather than overloading this child. | No new runtime docs by default | Evidence cites the lint/test/source anchor used for each measured signal. |

## Decision Record impact

Aligned with ADR 0007 and ADR 0008. Depends on #11884 for the decision-atom source of authority. Does not amend ADRs.

## Acceptance Criteria

- [ ] Inventory artifact enumerates `.agents/skills/**/*.md` payloads by skill and load role.
- [ ] Inventory records byte count, line count, section count where practical, and existing budget/map-pressure signals.
- [ ] Inventory identifies incident/provenance baggage, repeated edge-case stories, absent trigger pointers, and decision-atom compression candidates.
- [ ] Each row has a disposition candidate: `keep`, `compress-to-trigger`, `move`, `rewrite`, or `retire`.
- [ ] Ranked rollout table proposes pilot/batch grouping and explicitly covers `pr-review` and `pull-request`.
- [ ] No broad skill migration is included in this child.
- [ ] Validation includes `git diff --check` for the artifact and any relevant skill/manifest lint if touched.

## Out of Scope

- Editing `pr-review`, `pull-request`, or other hot-path skill behavior.
- Adding new AGENTS.md rules.
- Creating a new lint rule unless the inventory proves a missing signal that deserves a follow-up.
- Closing parent #11605.

## Avoided Traps

| Trap | Why rejected |
|---|---|
| Byte-count scoreboard only | Parent #11605 targets cognitive-load reduction while preserving behavior, not blind deletion. |
| One-shot all-skills cleanup | Parent explicitly requires pilots and batches after inventory. |
| Baggage laundering | Moving prose into another always-loaded file is not a valid disposition. |
| Re-defining the atom | #11884 already owns the decision-atom source; this child consumes it. |

## Related

- Parent epic: #11605.
- Prior child: #11884.
- Adjacent: #11604, #11603, #11319, #10537.
- Source authorities: ADR 0007, ADR 0008, `lintSkillManifest.spec.mjs`, `/create-skill` skill payload.

Origin Session ID: `e5a3acc3-d261-4ebf-96b1-4053ab0eafdf`

Handoff Retrieval Hint: `query_raw_memories("skill baggage inventory decision atom maps #11605 pr-review pull-request map atlas")`


## Timeline

- 2026-05-25T02:53:17Z @neo-gpt added the `documentation` label
- 2026-05-25T02:53:17Z @neo-gpt added the `enhancement` label
- 2026-05-25T02:53:18Z @neo-gpt added the `ai` label
- 2026-05-25T02:53:18Z @neo-gpt added the `refactoring` label
- 2026-05-25T02:53:18Z @neo-gpt added the `architecture` label
- 2026-05-25T02:53:18Z @neo-gpt added the `model-experience` label
- 2026-05-25T02:53:43Z @neo-gpt added parent issue #11605
- 2026-05-25T02:54:36Z @neo-gpt removed parent issue #11605
### @neo-gpt - 2026-05-25T02:54:57Z

Closing as duplicate / superseded-by-existing-child. Verification after creation found native #11605 children already include #11902, 'Inventory skill-runtime baggage for decision-atom migration', which delivered #11605 AC3 via PR #11903 before pivoting away from a static snapshot. Related pilots #11893 and #11904 are already closed as well. I created #11950 from an insufficient duplicate-sweep query; leaving it open would split the #11605 topology.

- 2026-05-25T02:54:58Z @neo-gpt closed this issue

