delta
Re-run the placement audit and report only what MOVED since the last run, above a noise budget. Declined findings stay declined. Use when: 'what changed since the last placement audit', 'placement delta', 're-run the instruction-placement audit', 'anything new to move', 'did any rule glob break', 'weekly instruction-placement check', or from a scheduled lane. Read-only. Realign still owns every change.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 30
- Forks
- 7
01 前言 Front Matter
- shell
- bash
- metadata
- { "summary": "Report only what moved since the last placement audit", "workflow-stage": "anytime" }
- description
- Re-run the placement audit and report only what MOVED since the last run, above a noise budget. Declined findings stay declined. Use when: 'what changed since the last placement audit', 'placement delta', 're-run the instruction-placement audit', 'anything new to move', 'did any rule glob break', 'weekly instruction-placement check', or from a scheduled lane. Read-only. Realign still owns every change.
- allowed-tools
- [ "Bash(${CLAUDE_PLUGIN_ROOT}/scripts/precompute.sh:*)", "Bash(${CLAUDE_PLUGIN_ROOT}/scripts/detect.sh:*)", "Bash(${CLAUDE_PLUGIN_ROOT}/scripts/glob-tools.sh:*)", "Bash(${CLAUDE_PLUGIN_ROOT}/scripts/render-index.sh:*)", "Read", "Grep", "Glob", "Write" ]
- argument-hint
- [--since <ISO date>] [--noise-budget <n>]
- user-invocable
- true
- disable-model-invocation
- false
03 SKILL.md 正文
Arguments. [--since <ISO date>] [--noise-budget <n>]. Default: since the artifact's last run
Pre-computed context
!"${CLAUDE_PLUGIN_ROOT}/scripts/precompute.sh" audit 2>/dev/null || echo "- Orientation unavailable"
Purpose
A full audit is worth running rarely and reading carefully. This is the lane for the other times: it answers what moved, so a repeat run costs attention proportional to actual change.
The failure it prevents is specific. An audit re-run that re-presents the same forty findings the operator already worked through trains them to skim, and a skimmed report is how a bad migration gets approved. Reporting only movement keeps the signal survivable on a cadence.
Read these first
| Read | For |
|---|---|
../../context/findings-artifact.md |
Where the spine baseline and the findings artifact live, the status vocabulary, re-run merge semantics, the baseline-capture obligation, and the finding-id constituents a suppression entry is keyed by |
../../reference/consumer-config.md |
The suppression surface: its layers, its per-key merge, the policy-floor inversion, and the report obligations |
../../context/routing-rubric.md |
Only when a genuinely new candidate needs classifying |
This skill does not restate the merge semantics, the baseline's shape, the suppression entry format, or the home. Those documents own them; a second statement is a second drift.
Two inputs, two homes, and the reason they are different files
The spine baseline is the comparison input: a snapshot of the previous run's detector spine, in
the baselines/ slot the lifecycle artifact protocol names
(../../reference/artifact-protocol.md), branch-keyed, at
the home findings-artifact.md defines. Memory tier and checkout-local, which is right for it: a
spine is recomputed next run, and one from another checkout describes a tree this one lacks.
The suppression surface is where an operator's decline lives: the tracked
.claude/instruction-placement.md, resolved across the three cascade layers. It is tracked because
that is the only mechanism that crosses checkouts: git moves the file, and a memory-tier baseline
never reaches another worktree. Read it, honor every entry it merges to, and
never write it: realign owns that write, behind its per-item gate.
A decline in the baseline would be a per-checkout fact, and the operator gets asked again from the next worktree. That is the bug this lane exists downstream of.
What counts as movement
Five shapes, in report order. Everything else is suppressed.
| Shape | Trigger | Why it matters |
|---|---|---|
new |
A candidate with no prior finding | The only shape that needs fresh classification |
changed |
A finding whose source content changed since the last run | Its line range is stale; realign would excise the wrong text |
broken-glob |
A rule glob the baseline recorded valid that does not resolve now |
The rule stopped firing, silently, and nobody was told. A transition, so it needs the stored verdict |
index-drift |
The index no longer matches the rules on disk | Deferred surfaces go unnamed: nothing tells an agent they exist |
stale |
A finding whose source no longer exists | The content was moved or deleted outside this plugin |
broken-glob is the shape that most justifies a cadence: a glob breaks when the code it described
is renamed, an ordinary refactor nowhere near the rules tree, with no signal at the time and nothing
else noticing between check runs.
What is deliberately NOT movement
- A finding the operator already decided on.
declinedstays declined and is never re-proposed;appliedis not re-reported as new. Resurrecting a decision is how an operator learns to stop reading. - Content edited without changing its meaning for placement. A reworded sentence in a section whose scope and class are unchanged is not movement. Compare what the classification depends on, not the bytes.
- Findings below the noise budget. Default: suppress
newfindings whose confidence is low and whose released line count is trivial, and report the count. A delta that hides its own filtering is the thing it was built to avoid.
Workflow
Each step names what "done" looks like, so a partial run is visible rather than assumed complete.
-
Resolve the home, read this branch's spine baseline and findings artifact, and resolve the suppression surface across its three layers; a missing surface is the ordinary no-suppressions state. All four baseline/artifact combinations resolve explicitly, none an error:
Baseline Artifact Disposition present present The ordinary cycle. Compare against the stored spine. present absent A realignor a cleanup removed the artifact. Compare against the spine, and say the report carries no statuses this cycle.absent present Bootstrap. The commonest shape after a first audit, and after any first run in a fresh worktree. Run the detector and capture its output as this cycle's baseline; report only what the artifact can settle, and say the cycle is a bootstrap.absent absent Say so and route to the full audit rather than silently running one. A bootstrap does not build its spine out of the artifact. The artifact holds classified candidates and held-back records, not every
SECTIONandRULEthe detector emits, so a spine derived from it is partial and the next cycle reports every record it never carried asnew. The detector's output is the only complete spine, so a bootstrap captures that. It reports only what the artifact can settle:changedandstaleover the findings it carries. It reports nonew(with no prior spine every record is unmatched, and a candidate audit considered and rejected is indistinguishable from one that appeared since) and nobroken-glob(that class is a transition from a storedvalidverdict, and the artifact records a proposed glob for a candidate, never a prior verdict for an existing rule).Say the cost out loud, because this is the one cycle that can absorb a finding unreported. A candidate that arose between the
auditand this bootstrap enters the captured spine without ever being reported, and no later cycle sees it as movement. That is the one sanctioned exception to the hard rule below, and it is bounded by the artifact's age: name that age in the report, and where the artifact is old enough that the tree has moved on, route to a fullauditinstead of bootstrapping. A stale bootstrap trades a silent loss for a saved sweep, which is the wrong way round.A fresh worktree legitimately has no baseline, and in every row it still honors every entry the suppression surface carries. Done when: the row is named in the report, and the merged suppression set is resolved with each entry's contributing layer.
-
Run the detector and diff its
SECTIONandRULErecords against the baseline's spine. Done when: every current record is matched to a prior record or marked unmatched. -
Classify each difference into one of the five shapes. Only a
newshape needs the rubric. Done when: no difference is left unclassified. An unclassified difference is a reporting gap. -
Re-validate every glob, not only the previously-valid ones, and compare each result against the verdict the baseline's
RULErow stored.validto invalid isbroken-glob; invalid to invalid is still-broken and counts as suppressed, not as movement. Done when: the validator has run over everyRULErecord, and each carries both its stored verdict and this run's. -
Check index sync and reachability. Done when: both verdicts are recorded, since they are independent questions.
-
Derive each surviving finding's
anchor/v1andfinding_idwithdetect.sh identity:"${CLAUDE_PLUGIN_ROOT}/scripts/detect.sh" identity --file <path> --start <n> --lane <lane> --destination <rung>, never by hand, and suppress every one the merged surface carries; also suppress what this branch's artifact records asdeclinedorapplied. Done when: no suppressed id appears in the report under any shape, and every entry that did not suppress (personal-only, malformed, or not evaluated this run) is listed with its layer. -
Report movement, then the suppressed count and the suppression section, then a one-line "nothing else moved". Done when: the report states a number for both moved and suppressed.
-
Merge what this run discovered into this branch's findings artifact, per its re-run merge semantics, before step 9, always. A
newfinding and a re-derivedchangedline range are the run's only durable output forrealign, which reads the artifact and never the spine. Skip this and the discovery is lost twice over:realignhas nothing to act on, and the next cycle's spine already contains the record, so it is no longer movement and is never reported again. Statuses stay the operator's: write records, never aStatus, with the one exception the artifact contract fixes: anacceptedfinding whose source changed resets topending, since an acceptance is scoped to the text the operator read andrealignexcises by range. A finding the suppression surface covers is not merged in aspending. Done when: every reportednewfinding exists in the artifact aspendingwith itsSuppression key, everychangedfinding's line range is the one this run derived, and nochangedfinding is leftaccepted. -
Capture this run's spine over the stored baseline. The run must have reached this step to earn the capture; the slice scaffolding
findings-artifact.mdrequires (the memory root's.gitignore, the sliceINDEX.md, the branch home and itsbaselines/directory) is created by the same first memory-tier write when absent. Done when: the capture is written, or the run stopped early and the stored baseline is untouched.
Reporting
Lead with the count of moved items and the window. When nothing moved, say that plainly, with the window and the suppressed count, and stop. A delta run whose honest answer is "nothing changed" should be short and complete, not a page of reassurance.
Never pad a quiet run by re-listing standing findings to look useful.
Hard rules
- Read-only on the repository. Every write is memory tier and never committed: the refreshed
findings artifact, the spine baseline, and the slice scaffolding. It writes
records, never a
Status(bar the one reset the artifact contract fixes), and never writes the suppression surface, a tracked filerealignowns behind the per-item gate. Every change to the repository belongs torealign. - Never resurrect a declined finding. Not as
new, not aschanged, not "for review", and not because this run is on a different branch or in a different checkout from the one where the decline was recorded. The surface makes that possible; honoring it is not optional. - Never suppress silently. The suppressed count and the suppression section are part of the report, always, including every entry that did not suppress and why.
- Never re-classify an unchanged finding. If its source content did not change, its classification stands. Re-deriving it invites drift between runs for no new information.
- Only the both-absent row routes out. With either the baseline or the artifact in hand there is a comparison to make, since an artifact alone bootstraps. With neither there is nothing to report movement against, and this skill is not a full audit.
- Never advance the baseline past an unrecorded discovery. The merge happens first, every cycle. Capturing the spine first leaves a baseline that says the finding is old while no artifact record says it exists. Nothing errors, and the finding is gone from both sides. The bootstrap row is the one sanctioned exception, and it is required to say so in its report.
Next
- Findings moved:
/instruction-placement:realign. It applies the moved findings the operator accepts. - Quiet run: none. Nothing moved, so there is nothing to apply.
Gotchas
- A quiet run is the expected outcome, not a failed one. The pull toward finding something to justify the run is what makes a cadence lane useless. A short answer that states the window and the suppressed count is the whole report.
- "Nothing touched the rules folder" does not make glob re-validation unnecessary. Globs break from refactors elsewhere. Skipping validation on that reasoning misses the single shape that most justifies the cadence.
- The baseline is disposable and the suppression surface is not; do not confuse their jobs. The baseline is memory tier, branch-keyed, and invisible from any other checkout; a fresh worktree legitimately has none, and with an artifact present that is the bootstrap row rather than a bug. A decline on the tracked surface is still in force in that worktree, because git carried the file. Reporting a suppressed finding as new because the baseline was absent is the failure this split exists to prevent.
- A capture at the wrong moment is a silently useless lane. Capture at the end, after the comparison. Capturing first compares this run against itself and reports nothing forever, with no error to show for it.
- A
changedfinding's stale line range is the dangerous part.realignexcises by that range, so reportingchangedwithout re-deriving the range hands the apply lane a number that points at the wrong text.
04 同仓库更多 Skills
track
Backlog reads through the bound tracker: search open and closed items, view one item with its comments and state history. Use when another skill searches or reads tracker items.
reviewer-media
Reviewer media for one pull request: decides whether it needs a narrated walkthrough, builds the storyboard from /review:explain-change's digest, has /explainer-video:produce render it and hands the manifest to /source-control:pull-request media. Use when asked for 'reviewer media', 'a walkthrough video for this PR', 'a produced video of this change', or when pull-request ready or monitor hands a PR over.
route
Model and effort per agent role (orchestrator, worker, verifier, retrieval) for a multi-agent run, resolved through the bundled defaults and the user, team and personal override config layers into fenced JSON with single-agent and fan-out variants and the layer behind each value. Use when asked 'which model for the subagents', 'route the roles' or 'model routing', or before a skill passes a role's model on a spawn.
route
Model and effort per agent role (orchestrator, worker, verifier, retrieval) for a multi-agent run, resolved through the bundled defaults and the user, team and personal override config layers into fenced JSON with single-agent and fan-out variants and the layer behind each value. Use when asked 'which model for the subagents', 'route the roles' or 'model routing', or before a skill passes a role's model on a spawn.
principles
Module-design vocabulary for architecture findings, and the checks built on it. Use when: 'what is a deep module', 'what is a seam', 'deep vs shallow module', 'what is the deletion test', 'leverage and locality', 'module design vocabulary', 'which word do we use for X in architecture findings'. Scanning a codebase for friction is /architecture:improve.
write
Structured five-field bug report (title, steps to reproduce, expected vs actual, justified severity, suggested fix location) from an informal description, read-only. Use when the user names a defect they observed, or asks for one written up ('report a bug', 'file a bug', 'write this up as a bug').