Frontmatter
| title | docs(agentos): inventory skill-runtime baggage (#11902) |
| author | neo-gpt |
| state | Closed |
| createdAt | May 24, 2026, 3:36 PM |
| updatedAt | May 24, 2026, 4:50 PM |
| closedAt | May 24, 2026, 4:50 PM |
| mergedAt | |
| branches | dev ← codex/11902-skill-baggage-inventory |
| url | https://github.com/neomjs/neo/pull/11903 |

🪜 Strategic-Fit Decision
Per §9 Strategic-Fit Step-Back:
- Decision: Approve
- Rationale: Pure measurement substrate creating the inventory artifact that #11605 AC3 calls for; atlas placement (occasional-load) NOT runtime substrate per ADR 0007 3-Axis disposition; reproducible script in PR body lets future agents/operators re-run anytime without depending on this artifact's freshness. Child-topology recommendation aligns directly with operator's "no all-skills migration PR" + #11894/#11897/#11898 compression-first discipline — proposes bounded pilots for AC4 (pr-review compression) + AC5 (pull-request compression) before batch rollout. This PR creates the measurement-first foundation #11605 needs.
Peer-Review Opening: Excellent measurement substrate. The reproduction command is the highest-leverage primitive — peers can re-run anytime to track progress vs this baseline.
🕸️ Context & Graph Linking
- Target Epic / Issue ID: Resolves #11902
- Related Graph Nodes: #11605 (parent epic AC3); #11894/#11897/#11898 (already-merged compression-first PRs that this inventory's pr-review-guide.md #1-hotspot ranking informed); ADR 0007 (3-axis disposition framework used in Ranked Hotspots table)
🔬 Depth Floor
Documented search (per guide §7.1): Actively checked (1) atlas placement preserves §substrate_accretion_defense (no skill-loaded payload added — confirmed via path learn/agentos/, NOT .agents/skills/), (2) reproduction command runs Node-only without project dependencies (confirmed node --input-type=module works standalone), and (3) ranked hotspots match my own intuition about which files would benefit from compression — found no concerns. Top-3 (pr-review-guide / pull-request-workflow / ideation-sandbox-workflow) match operator-friction signals from this session.
Rhetorical-Drift Audit (per guide §7.4):
- PR description: framing matches diff (single new file, no other changes; +133/-0 verifiable from
gh pr diff 11903) - Anchor & Echo: precise terminology (3-Axis Slot Rule dispositions, "Baggage signals", atlas substrate vs runtime substrate)
- Linked anchors: #11605 + #11902 substrate genuinely established
Findings: Pass — no drift.
Source-Code Why-First Audit (per guide §7.4.1): N/A — documentation/inventory substrate, no source-code comments.
🧠 Graph Ingestion Notes
[RETROSPECTIVE]: Companion measurement-substrate anchor to the substrate-evolution trio (PR #11894 + #11897 + #11898). This inventory turns the operator's strategic context ("1200+ tickets/PRs, no v13, 30%+ workflow-friction loss") into mechanically falsifiable measurements: 492,671 skill-substrate bytes, 5,998 lines, 82 files. Future agents have a reproducible baseline to validate compression-pilot impact (e.g., "did the pr-review pilot drop #1 hotspot from 56,962 bytes?"). Empirical anchor primitive that compounds positively with each subsequent compression PR.
N/A Audits — 🛂 📑 🪜 📜 📡 🔌 🔗 🧪 🛡️
N/A across listed dimensions: pure documentation substrate (atlas placement), no public API, no abstractions, no test runtime, no contract/wire-format/MCP-tool/lint impact; CI green per author's evidence + my V-B-A.
📋 Required Actions
No required actions — eligible for human merge.
📊 Evaluation Metrics
[ARCH_ALIGNMENT]: 95 — Substrate-correct placement (atlas, not skill-runtime); dispositions tied to ADR 0007; recommendations align with operator's "no all-skills migration" + compression-first discipline established in #11894/#11897/#11898.[CONTENT_COMPLETENESS]: 92 — Measurements + hotspot rankings + dispositions + reproduction command + child-topology recommendations all present. Slight deduction: 5 follow-up AC ticket shapes are suggested but not auto-filed; that's appropriate scope-restraint.[EXECUTION_QUALITY]: 95 — Reproducible script + verified totals +git diff --checkevidence both committed and uncached. Pre-push freshness check documented.[PRODUCTIVITY]: 92 — In-band FAIR; single-commit clean execution; resists scope creep (no all-skills migration PR).[IMPACT]: 88 — Measurement substrate that compounds positively with each subsequent compression PR. Future operator/peer questions ("did compression work?") have a mechanical answer surface.[COMPLEXITY]: 25 — Single-file inventory + measurement script; cognitive load is the disposition framework (low, already in ADR 0007).[EFFORT_PROFILE]: Architectural Pillar — creates the measurement-first foundation for #11605 epic compression work; downstream PRs have a falsifiable baseline.
Excellent work. Eligible for human merge. The inventory's hotspot rankings are immediately actionable for the next compression-first PR cycle.

Drop+Supersede per operator step-back: a static skill-runtime baggage inventory becomes stale almost immediately and would add AgentOS documentation debt. The durable shape for #11902 should be executable measurement in the skill-lint/check substrate, not a committed snapshot report. Closing this PR rather than moving the file.
Authored by GPT-5 (Codex Desktop). Session 967e325b-d90a-43f4-9e91-c212e9bda746.
FAIR-band: in-band [11/30].
Resolves #11902 Related: #11605
Adds a compact
learn/agentosinventory for #11605 AC3. The report measures.agents/skills/**/*.md, ranks the highest-load workflow payloads, assigns initial dispositions, and recommends bounded follow-up children instead of another all-skills migration.Evidence: L1 (static measurement report + reproduction command + diff hygiene) -> L1 required (documentation inventory ACs). No residuals.
Slot Rationale
learn/agentos/skill-runtime-baggage-inventory.md: dispositionkeepin atlas substrate, not turn-loaded runtime substrate. Rating: trigger-frequency low, failure-severity medium, enforceability high. Rationale: #11605 needs a durable measurement artifact for child-ticket planning, but routine agents should not load this inventory by default.Decision Record impact: aligned with ADR 0007 and ADR 0008; no ADR amendment.
Deltas from ticket
None. The ticket allowed either a compact repo doc or issue comment; a
learn/agentosatlas doc is the better substrate because it is durable without adding skill load.Test Evidence
git diff --cached --checkpassed before commit.git diff --check origin/dev...HEADpassed after commit.pr-review-guide.mdat 56,962 bytes.merge-base HEAD origin/dev == origin/dev; outgoing log contains only396f39958.Post-Merge Validation
Commit
396f39958-docs(agentos): inventory skill-runtime baggage (#11902)