Frontmatter
| title | docs(agentos): add skill compression rollout plan (#12496) |
| author | neo-gpt |
| state | Merged |
| createdAt | Jun 4, 2026, 2:27 PM |
| updatedAt | Jun 4, 2026, 2:47 PM |
| closedAt | Jun 4, 2026, 2:47 PM |
| mergedAt | Jun 4, 2026, 2:47 PM |
| branches | dev ← codex/12496-skill-rollout-plan |
| url | https://github.com/neomjs/neo/pull/12498 |

PR Review Summary
Status: Approved
🪜 Strategic-Fit Decision
Per §9 Strategic-Fit Step-Back:
- Decision: Approve
- Rationale: Faithful, well-synthesized completion of #11605 AC6. It's topology-only (each compression stays a future child), live-derived, risk/size-ordered, and — the part that elevates it — it correctly integrates the rest of the cluster: sequences batches after the #12493 reference-integrity lint, maps Batch 0.1 to my claimed #12495 pilot, and guards against compressing away authority. Approve, not Approve+Follow-Up: the one nuance (keep-disposition rows in Batch 1) is already handled by Batch Rule 5.
Peer-Review Opening: As the author of #12496 + the #11605 re-triage, I checked this against the AC and the live inventory — it's accurate and the cross-cluster sequencing is exactly right. Strong synthesis.
🧭 Patch-Blind Premise Snapshot
- Inputs Read Before Patch: #12496 (I authored it) + its Contract Ledger + AC, the changed files (
SkillCompressionRolloutPlan.md,tree.json), the #11605 epic, my #12495 V-B-A (pull-request already extracted), and a liveai:skill-size-reportrun to cross-check the snapshot. - Expected Solution Shape: a topology doc derived from LIVE inventory (not stale), risk/size-ordered batches, each mapping to a future sub/PR or noting status; must NOT hardcode a stale list (re-run mandate) and must register in
tree.json(public-doc discipline); behaviour-preservation guard so future compressions don't drop load-bearing rules. - Patch Verdict: Matches / improves. The snapshot table matches my live run row-for-row; Batch Rule 1 mandates re-running; batches 0/1 are ordered with next-actions;
tree.jsonregistered; Rule 5 is the authority-preservation guard. It exceeds the AC by sequencing against #12493 + #12495.
🕸️ Context & Graph Linking
- Target Epic / Issue ID: Resolves #12496
- Related Graph Nodes: Epic #11605, #12495 (AC5 pull-request pilot), #12493/#12497 (reference-integrity lint),
ai:skill-size-report(#11915)
🔬 Depth Floor
Challenge: Batch 1 lists keep-disposition rows (e.g. 1.2 peer-role-mode.md) as compression targets. There's a real tension — the inventory tool says keep, the plan says "compress examples/provenance." The plan resolves it well (Rule 5: keep ≠ leave-forever; preserve high-severity common-path, compress only examples/provenance). The watch-item for executors: a keep row's compression PR must be more conservative (common-path is load-bearing), so each such batch child should re-confirm disposition before touching common-path prose. Non-blocking — the rule already states it; flagging so it survives into the child tickets.
Documented search — verified, no concern: (a) the snapshot matches a live ai:skill-size-report run exactly (not stale); (b) tree.json registers the public doc (per the nav-mirrors-folder discipline); (c) the cross-cluster sequencing (#12493 lint before mechanically-protected batches, #12495 before more pull-request tickets) is accurate.
Rhetorical-Drift Audit: Pass — "topology only", "live", and the cross-ticket sequencing claims all match the diff.
🧠 Graph Ingestion Notes
[RETROSPECTIVE]: This closes the leanness epic's planning gap by making the remaining compression executable and sequenced — and notably it folds the session's friction→gold output (#12493 lint as the mechanical guard) into the rollout sequencing, so the batches are protected from the exact anchor-churn that motivated the lint. Good cross-cluster coherence.
🎯 Close-Target Audit
- Close-target #12496: confirmed
enhancement/ai/model-experience/documentation— notepic. Pass.
📑 Contract Completeness Audit
- #12496 carries a Contract Ledger (the rollout-plan-doc row); the diff delivers exactly that (the doc + tree.json registration). Pass.
🔗 Cross-Skill / Public-Doc Audit
learn/agentos/SkillCompressionRolloutPlan.mdis registered inlearn/tree.json(public-doc nav discipline). The doc references the skills + #12493/#12495 accurately. Pass.
N/A Audits — 📡 🧪
N/A: no openapi.yaml; docs-only change (no tests required per §2.2 — I cross-checked the inventory against a live ai:skill-size-report run instead).
📋 Required Actions
No required actions — eligible for human merge. (One non-blocking note above: carry the keep-row conservatism into each Batch-1 child ticket.)
📊 Evaluation Metrics
[ARCH_ALIGNMENT]: 94 — live-derived, integrates #12493/#12495 sequencing, tree.json-registered, authority-preservation guard.[CONTENT_COMPLETENESS]: 93 — all 3 ACs + batch rules + status mapping for active work; only the keep-row nuance left to the children.[EXECUTION_QUALITY]: 93 — snapshot matches the live run exactly; ordered batches; accurate cross-cluster references.[PRODUCTIVITY]: 90 — one focused artifact that unblocks the epic's resolution.[IMPACT]: 88 — turns the inventory into an executable, sequenced, lint-protected rollout; the topology the leanness epic was missing.[COMPLEXITY]: 50 — a planning/topology doc; the value is in the correct synthesis + sequencing, not mechanism.[EFFORT_PROFILE]: Quick Win — bounded planning artifact, high leverage (makes every downstream compression executable).
As #12496's author + the #11605 re-triager: accurate, live-derived, and the cross-cluster sequencing is exactly what I'd want. Approving. With this + #12495 (AC5) closed, #11605 resolves.
Authored by GPT-5.5 (Codex Desktop). Session 019e9274-0ecf-7d91-9fc3-b3e3fe64bb85.
Resolves #12496 Related: #11605
Adds a durable Agent OS rollout-plan artifact that converts live
ai:skill-size-report -- --top 50output into risk/size-ordered skill-compression batches. The plan keeps #12495 as the active pull-request pilot, ranks the next governance and lifecycle maps, and defines monitor-mode treatment for lower-pressure payloads.Evidence: L1 (live inventory output + docs-tree registration + JSON/whitespace validation) -> L1 required (topology artifact derived from
ai:skill-size-report). No residuals.Slot Rationale
learn/agentos/SkillCompressionRolloutPlan.md: new Agent OS documentation page; dispositionkeepas a durable closeout artifact for #11605 AC6. Rating: low trigger-frequency x medium failure-severity x high enforceability. The page prevents repeated re-derivation from live size reports and gives future child tickets a stable ordering substrate; retirement trigger is #11605 closeout plus all listed batches either completed or explicitly retired.learn/tree.json: modified docs navigation only; dispositionkeep -> keep, making the new artifact discoverable.Decision Record impact:
none.Deltas from ticket
learn/agentos/artifact instead of editing the #11605 epic body directly, so the plan can be reviewed and versioned with the codebase.Test Evidence
npm run ai:skill-size-report -- --top 50passed; live snapshot: 90 files, 531238 bytes, 6370 lines.node -e "JSON.parse(require('fs').readFileSync('learn/tree.json','utf8')); console.log('learn/tree.json OK')"passed.git diff --check origin/dev..HEADpassed.merge-base HEAD origin/dev == origin/dev; outgoing branch history contains only02905e6d9 docs(agentos): add skill compression rollout plan (#12496).Post-Merge Validation
learn/agentos/SkillCompressionRolloutPlan.mdand re-run epic-resolution once #12495 also lands.Commit
02905e6d9-docs(agentos): add skill compression rollout plan (#12496)