session-flow: retro findings, catch-up scope and recommend-skills router #7575

Parent

Refs #7555. Source: PLAN Phase 7, topic poteto-review. Thread: session-flow.

Depends on

• config-cascade: settings resolution and convention home #7571 Settings resolution and convention home
• enforcement-ladder: v2.0.0 ladder and one guardrail criterion #7572 Enforcement ladder v2.0.0
• corrections: new plugin with /corrections:codify #7573 corrections plugin (retro codify already moved out)
• corrections: findings buffer with a local-file adapter #7574 Findings buffer (unapplied lessons go to the buffer)

Outcome

The retro carries Matt's findings and is offered, not forced, at chain end; /session-flow:orient
answers "what are we doing?" since the user's last message; one router,
/session-flow:recommend-skills, shortlists skills from an index of every skill.

Decisions

• Retro absorbs Matt's retro: "no guardrail for this mistake" and "unwired or broken check" findings,
  information-access and no-op-in-steering-file categories, writing-for-agents yardstick, pointer
  after a long search, tool-economy finding (D9, D48, Q524). Origin: Matt's.
• Retro offered at chain end, not forced; unapplied lessons go to the buffer; value measured by
  lessons absorbed (D50 item 10). Setting: retro offer at chain end offer (user).
• Retro trends moves to /session-flow:audit-sessions, the all-transcripts source for codify (D50
  item 3, D53).
• /session-flow:orient gains a since-your-last-message scope (anchor: the user's last own
  message), "Needs you" first, per-item decision, why now, options, recommendation, if unanswered,
  unknowns; live re-check of every PR, run and agent touched; ketchup's current item shape and order
  (D67, Q562; Lauren's ketchup). Setting: catch-up word cap 250 (150 available, user).
• Orient covers this conversation plus live sessions waiting on the owner; orient all rolls up
  lanes, default one machine, /fleet:reach only in the owner's setup (D87, Q123).
• One router /session-flow:recommend-skills (renamed from show-options): a script indexes
  frontmatter of all skills (installed, disabled, not installed), the agent shortlists, reads those
  SKILL.md files, may ask one question, never enables or installs (D80, Q157, Q189, Q190; Matt's
  reading of shortlisted skills). Setting: router excludes disabled or uninstalled, default include
  all (user).
• /session-flow:orchestrate gains a coordinator action (any surface, also as a CLI session) and a
  ## Next naming /planning:draft-goal-condition (Q122, Q526).
• Workflow continuation: /clear stays resumable; mid-phase, hand bulk work to subagents before
  compacting; handoff and questionnaire files stay in the memory dir (Q525, Q543, Q544).
• Rejected: forced retro; orient answering chat pings; persona-named routers; a coordinator tied to
  Claude Projects.

Key interfaces

From the design's module layout: "session-flow: retro absorbs Matt's findings; retro trends
moves to /session-flow:audit-sessions. orient gains the since-your-last-message scope.
show-options renamed /session-flow:recommend-skills. orchestrate gains a coordinator action
and a ## Next naming /planning:draft-goal-condition."

Settings: "Catch-up word cap 250 ... Retro offer offer."

Slices, filed when this phase starts: retro-absorb-and-trends-move, orient-catch-up,
recommend-skills, orchestrate-coordinator.

Done when

• The recommend-skills skill directory exists, show-options does not, and
  rg -n 'session-flow:show-options' plugins docs --glob '!**/CHANGELOG.md' --glob '!.changes/**'
  prints nothing.
• bash plugins/skill-quality/scripts/check-skill.sh plugins/session-flow/skills exits 0.
• Every slice sub-issue is closed by a merged PR, each skill-body cut with before/after evals.

Out of scope

• Chat-ping answers (communication).
• Description trims, which follow the Skill authoring thread's pilot.