Repository navigation
perf(session-flow): cut the handoff skill body through progressive disclosure #12657
Description
Refs #12243
Outcome
The /session-flow:handoff body is cut through progressive disclosure: action-specific detail moves to reference files read on demand, and the hub keeps routing and gates. This is one of five slices under #12243; the first cut (/source-control:worktree) landed in #12387, whose recipe this follows.
Size at origin/main 3bd42cabfe: body 36,785 bytes (SKILL.md with frontmatter stripped, the method #12387 used); the skill directory holds 120,309 tracked bytes. The binding limit is the paired eval run each cut needs, so each skill is its own PR.
Done when
- The hub's body bytes fall, measured the same way. Moved text sits verbatim in
reference/, and every citation of it (tests, hooks, scripts, fixtures, README) is repointed. -
/docs-hygiene:compress comparereturns VERDICT PASS with no SEMANTIC LOSS. - The
ho-*cases inplugins/session-flow/evals/run on the before and after copies with/evals:plugin-eval --baseline <before.json> --margin <m>, on a roundrun-validity.pymarks VALID on both arms, and the after arm is non-inferior (plugins/playbooks/skills/skill-authoring/reference/skill-criteria.md, "Cutting text"). Four cases cover this skill; if the moved text has no case that reads it, add one before the before-run.
Related
- perf: cut the bodies of the most-invoked skills through progressive disclosure - part 1 of 2 #12243 (parent), perf(source-control): move the worktree nesting measurement out of the skill hub #12387 (cut 1 recipe), perf: cut the bodies of the most-invoked skills through progressive disclosure - part 2 of 2 #12244 (after figure).
Activity
github-actions commentedon Nov 3, 2026
Proposed work class: work-class: scoped
Basis: automated intake triage; the lanes App applied this class.
Size: Medium
Complexity: Medium
Uncertainty: Knowable
Flags: none
Blocked by: none
I read this as one slice of #12243. It cuts the
/session-flow:handoffskill body by moving action-specific text verbatim intoreference/files, repointing every citation, and passing the compress compare and the pairedho-*eval non-inferiority check. The outcome and done-when items are exact, so I found nothing open. The paired eval run is not something an unattended lane can do, and thehost-runlabel already covers it. I found no duplicate among the open issues.Automated triage, applied by the lanes App.
melodic-automation-lanes commentedon Nov 3, 2026
Not admitted to the issue lane: its done-when asks for what an unattended lane run cannot perform: item 3 (a model eval run: "The ho-* cases in plugins/session-flow/evals/ run on the before and after cop..."); recommended split: keep the other items here as the admissible issue and move these to a child issue for the host queue (
host-run); it carries host-run. Admission takes the issue once each of those is met, when intake triages it again (.github/actions/resolve-config/admission-rules.json).melodic-automation-lanes commentedon Nov 3, 2026
The latest triage verdict holds nothing: admission moved the issue to
status: confirmed; its comment says why.kyle-sexton commentedon Nov 3, 2026
Claim. Backlog HITL host-run worker is taking this now.
kyle-sexton commentedon Nov 3, 2026
Negative control, preregistered before the first paid run.
Per
plugins/playbooks/skills/skill-authoring/reference/rewrite-a-plugin.md:22-24and:60-66:ho-*cases inplugins/session-flow/evals/, including the newho-wip-commit-on-pause, which covers the moved WIP-commit text.claude-opus-5-5), same flags (--runs 2 -j 2 --scaffold --ablation none --allow-tools Bash Write Edit --keep-temp;ho-todowrite-renders-listruns in its own invocation withCLAUDE_CODE_ENABLE_TASKS=0, as its case requires):skills/handoffswapped in.SKILL.mdbody deleted (frontmatter kept, one placeholder sentence).case drop, or the mean case score falls by 0.15 or more.--own-copy-search-warnson the degraded side only. If neither holds, the cut is unmeasurable and the before text ships.run-validity.py, after non-inferior to before at margin 0.05.test(session-flow): give the wip-commit case a default branch