Skip to content

fix(done-check): narrow subagent-skip to formatting-only - #128

Merged
ultimatile merged 1 commit into
mainfrom
fix/125-done-check-subagent-skip
Jul 22, 2026
Merged

fix(done-check): narrow subagent-skip to formatting-only#128
ultimatile merged 1 commit into
mainfrom
fix/125-done-check-subagent-skip

Conversation

@ultimatile

@ultimatile ultimatile commented Jul 22, 2026

Copy link
Copy Markdown
Owner

Summary

done-check's "When to skip the subagent" note skipped the mechanical-lane subagent on pure renames and file moves. But paired-artifact-drift is a mechanical-lane item whose N/A criterion excludes "the diff renames / removes nothing" and explicitly covers module-structure changes ("the moved file") — so a rename or file move is exactly the case that item exists to catch. Skipping the subagent there dropped the one mechanical check the change itself triggers.

This narrows the skip condition to formatting-only (whitespace, list renumbering, table padding), matching todo-check's current skip note. Anything else — a rename, signature, or doc change — now runs the subagent, which decides each item's applicability from the item's own body rather than the skip note trying to enumerate triggers.

Closes #125.

Changes

  • skills/done-check/SKILL.md — narrow the "When to skip the subagent (step 2)" condition to formatting-only; drop the "pure renames" / "file moves" skip clause.
  • .claude-plugin/marketplace.json — version bump 2026.7.232026.7.24.

Notes

Scoped to the skip condition only. It does not change how the skip path fills the audit table's mechanical-lane rows when a diff is formatting-only; that question, together with a matching one in todo-check, is tracked separately in #127.

Summary by CodeRabbit

  • Chores

    • Updated the marketplace version from 2026.7.23 to 2026.7.24.
  • Documentation

    • Clarified when completion checks should be skipped, limiting exceptions to strictly formatting-only changes without semantic impact.

The skip note listed "Pure renames" and "file moves with no content
change" as wasted overhead. But paired-artifact-drift is mechanical-lane
and its N/A criterion excludes "the diff renames / removes nothing" — and
it explicitly covers module-structure changes ("the moved file"). So a
pure rename or file move triggers it; skipping the subagent there skips
the one mechanical item the change itself requires.

Narrow the condition to formatting-only, mirroring todo-check's current
skip note (#126 made it coarse: formatting-only skips, everything else
dispatches, without enumerating what a rename triggers).

Closes #125.
@coderabbitai

coderabbitai Bot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 3e221cb5-d137-4deb-be3f-0e381dbecf4d

📥 Commits

Reviewing files that changed from the base of the PR and between 2008619 and 42abd59.

📒 Files selected for processing (2)
  • .claude-plugin/marketplace.json
  • skills/done-check/SKILL.md

📝 Walkthrough

Walkthrough

The marketplace manifest version is updated to 2026.7.24, and the done-check guidance narrows when its step-2 subagent may be skipped.

Changes

Marketplace manifest update

Layer / File(s) Summary
Marketplace version bump
.claude-plugin/marketplace.json
The manifest version changes from 2026.7.23 to 2026.7.24.

Done-check subagent rule

Layer / File(s) Summary
Formatting-only skip condition
skills/done-check/SKILL.md
Step 2 is skipped only for formatting-only changes without semantic content changes, including whitespace, list renumbering, and table padding.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Poem

A rabbit reviews the rules tonight,
Formatting skips, but names stay bright.
The version hops to twenty-four,
Done-check guards each change once more.
thump thump—the patch is right!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning The marketplace.json version bump is unrelated to #125 and appears to be an extra change outside the issue's scope. Move the version bump to a separate PR or link an issue that explicitly covers the release-manifest update.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: restricting done-check's subagent skip to formatting-only diffs.
Linked Issues check ✅ Passed The updated skip rule matches #125 by limiting skips to formatting-only changes and running the subagent for other semantic diffs.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/125-done-check-subagent-skip

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 Checkov (3.3.8)
.claude-plugin/marketplace.json

Traceback (most recent call last):
File "/usr/local/bin/checkov", line 2, in
from checkov.main import Checkov
ModuleNotFoundError: No module named 'checkov'


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ultimatile
ultimatile merged commit eac675f into main Jul 22, 2026
1 check passed
ultimatile added a commit that referenced this pull request Jul 24, 2026
)

The skip path let both runners skip the mechanical-lane subagent on a
formatting-only diff, on the premise that such a diff raises no
mechanical concern. That premise is false: paired-artifact-drift's
new-comment sweep, public-doc-durability's always-concern local-path
rule, and ported-code-attribution's declared-port signal all key on the
state of the touched text, not only what the diff newly introduces, so a
formatting-only diff touching their surface can raise a real concern the
skip would miss.

Delete the skip path from both runners; the mechanical subagent is
always dispatched. This subsumes the labeling bug the skip caused
(mechanical rows marked N/A from lane tags, overriding item-body
authority) with no new status token or downstream vocabulary change.

Supersedes the skip machinery from #126 and #128. Closes #127.
@ultimatile
ultimatile deleted the fix/125-done-check-subagent-skip branch July 27, 2026 20:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

done-check's subagent skip condition contradicts paired-artifact-drift's own rename trigger

1 participant