maestro-improve

maestro-improve

Use when a Lead assigns improvement work on one target to a Peer. The target is the only parameter; a separate Peer challenges the returned candidate before acceptance.

A correction that stays in a transcript is spent when that session ends. The lesson record is what survives, and doctrine is the only thing a future session actually reads. This skill is the one place the two are joined: it turns filed corrections into the smallest edit that would have prevented them.

Folds rules from pstack's reflect and correct (Lauren Tan, MIT; notice in THIRD_PARTY.md).

The parameter

The target names the doctrine a lesson corrects: a recipe section, the SLP Workspace Pack in src/plugins/resources/SLP.md, a Hub template, a skills/maestro-* file, or a repository's Workspace Protocol. Where each one lives, and what an edit to it costs, is in references/targets.md.

Intakes

Most lessons are filed at the correction, by the seat that took it. Two intakes catch the ones nobody filed. Both end in maestro lesson file, and neither edits doctrine. Filing is reversible, so it waits for no approval; the edit a lesson later produces passes the replay gate and the challenge Peer like any other.

Session harvest. Run it after a session whose corrections nobody marked. Skip a trivial session, or one that followed its doctrine correctly. A one-off is not a lesson. The source is the session's record, not a transcript file. That record is maestro trace <id> for each work item the session touched, its failed: notes, its rework marks, the decisions it recorded with --replaces, and a short digest of the conversation written by the session itself. Hand the record to three read-only subagents in parallel, one lens each:

• Judgment. The durable principle behind a specific incident: a mistake and its correction, an owner preference, a decision and its reason, friction in a skill or a delegation, a manual step repeated often enough to encode.
• Tooling. The command, flag, path or quirk a future agent would otherwise re-derive, and every moment the owner supplied context the agent could have fetched itself.
• Divergent. What the other two lenses will miss: a decision right for the wrong reason, a check reported instead of run, a second-order effect on callers, a skill invoked late or not at all.