Skip to content

Add scope-quick and ship-quick for the review-fix loop - #7

Merged
tobrun merged 1 commit into
mainfrom
quick-skills
Oct 7, 2026
Merged

tobrun merged 1 commit into
mainfrom
quick-skills

Conversation

@tobrun

@tobrun tobrun commented Oct 7, 2026

Copy link
Copy Markdown
Owner

Summary

After build and ship, a blocked review had one recommended path: run the full scope again, then the full ship to re-check the fixes.
Both are far heavier than fixing a few findings needs.
This adds two minimal skills to the dev plugin and points ship and build at them for plain defects.

  • scope-quick: turns the Blockers of the latest ship review, or a small request, into change sets in spec.md for build. No interview, no argued decisions, no subagents, no ledger work or HTML. It loops the existing lint-spec.py and stops with a pointer to scope when a finding needs a decision or scope change.
  • ship-quick: one validation run at the diff's impact, one read-only reviewer, then a PR update followed to green. The reviewer marks each previous finding fixed or still open and reads only the diff since the last review for new blockers. No gauntlet, no lens panel, no fix loop.

Changes to existing behaviour

  • ship's review report records the reviewed head commit on its Base: line, so a quick run can diff from it. Older reviews have no head, so the first ship-quick after one reads the whole branch diff.
  • ship and build recommend scope-quick, build, ship-quick for plain defects; scope stays the path for findings that need a decision.
  • plan-layout.md lists the new writers of spec.md, review_N.md and pr.md.
  • The dev plugin and the Pi package go from 3.7.0 to 3.8.0.
  • Docs, the Codex generator, the regenerated plugins/, and a comprehension eval file per skill cover the new skills. The opencode permission block also gains the missing scope-review and reflect entries.

Testing

  • scripts/validate.sh passes locally.
  • A decision-less spec in the shape scope-quick prescribes lints clean, and so does a change set appended after built ones.
  • Neither skill has been run end to end yet; skills are human-invoked, so that trial follows the merge.

🤖 Generated with Claude Code

…fixes

A blocked ship review had one recommended path: a full scope run, then
a full ship run to re-check the fixes. Both are far heavier than fixing
a few findings needs.

scope-quick writes minimal change sets from the latest review's
Blockers, or from a small request, with no interview, argued decisions
or subagents, looping the existing lint-spec.py. ship-quick re-ships
with one validation run and one reviewer that checks the previous
findings and the diff since the last review, then updates the pull
request and follows it to green - no gauntlet, panel or fix loop.

ship's review report now records the reviewed head commit so a quick
run can diff from it, and ship and build recommend the quick loop for
plain defects. Bumps the dev plugin to 3.8.0.
@tobrun
tobrun merged commit 95e15bf into main Oct 7, 2026
4 checks passed
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.

1 participant