Skip to content

Add code-review and submit skills, stabilize plugin#32

Open
larf311 wants to merge 14 commits intomainfrom
worktree-tmp-initial-code-review
Open

Add code-review and submit skills, stabilize plugin#32
larf311 wants to merge 14 commits intomainfrom
worktree-tmp-initial-code-review

Conversation

@larf311
Copy link
Contributor

@larf311 larf311 commented Feb 26, 2026

What

Adds two new user-facing skills (code-review, submit) and completes several housekeeping changes: promoting the plugin from beta to stable, reorganizing internals, centralizing attribution, and adding a root package.json for npm installability.

Why

The code-review skill is the shared review logic for both local (/submit) and CI (dev-review-agent) workflows — a two-layer AI-assisted review system designed in docs/plans/2026-02-26-code-review-design.md. The submit skill is the local developer flow from "done coding" to "draft PR ready." The organizational changes (internal/ directory, command renames, attribution consolidation) reduce user-facing surface area and token waste.

How to review

  1. Skills firstskills/code-review/SKILL.md and skills/submit/SKILL.md are the core additions. Review the three-pass review structure, confidence scoring design, and submit flow steps.
  2. Smoke teststests/smoke/validate-*.sh were updated for the new skills, the internal/user-facing split, and centralized attribution. All 4 suites pass (92/92 checks).
  3. Organizational changes — prior commits moved agents/skills to internal/, renamed commands to drop shipwright- prefix, and consolidated attribution into THIRD_PARTY_NOTICES. These are mostly file moves.

Pre-submit review

Local code-review skill (3-pass with separate agents) found 3 blockers and 1 warning, all pre-existing on the branch:

  • validate-commands.sh not updated for renamed command files — fixed
  • Internal skills attribution check not updated after moving to THIRD_PARTY_NOTICES — fixed
  • brownfield-analysis missing from ORIGINAL_SKILLS — fixed
  • promote.md stale shipwright-beta reference — fixed

larf311 and others added 14 commits February 26, 2026 09:42
Design for a two-layer AI-assisted review system: local submit
flow (/shipwright:submit) and CI automation. Covers the code-review
skill, PR description generation, and GitHub Action workflow.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Remove the skip-review override from the submit command design.
Review always runs; developers can still proceed past blockers
after seeing results.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add implementation plan with 6 tasks: code-review skill, submit
  command, CI workflow, and smoke test updates
- Update design doc: fix loop is developer-driven (select which
  findings to auto-fix) instead of automatic

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…atch

CI review component builds on existing dev-review-agent GitHub Action
rather than a new implementation. The code-review skill in Shipwright
is the single source of truth, consumed by dev-review-agent as a
git-based npm dependency pinned to a version tag.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
15-task plan across 4 phases with TDD, exact file paths, and
complete code for both Shipwright and dev-review-agent repos.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…on plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Mirrors the independent scoring rationale — isolation prevents
cross-contamination between passes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Update validate-commands.sh for renamed command files (dropped shipwright- prefix)
- Remove stale attribution check from internal skills loop (moved to THIRD_PARTY_NOTICES)
- Add brownfield-analysis to ORIGINAL_SKILLS (attribution centralized)
- Fix stale shipwright-beta reference in promote.md

Found by running the code-review skill during submit flow.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@larf311 larf311 changed the title Add code review system design and implementation plan Add code-review and submit skills, stabilize plugin Feb 26, 2026
@larf311 larf311 requested a review from owaism February 26, 2026 22:28
@larf311 larf311 marked this pull request as ready for review February 26, 2026 22:28
@larf311
Copy link
Contributor Author

larf311 commented Feb 26, 2026

I'm not sure about checking in the plans. Seems messy but I left them for this one. Let me know if you want me to remove them.

Also, I'm pretty unsure about including the pre-submit review. I'll probably remove that but I left it b/c it was interesting for now. Definitely lots of room for improving the prompt but I think it's a good start.

@owaism
Copy link
Collaborator

owaism commented Feb 26, 2026

I like the PR Description a lot. I agree, we may want to remove the Pre-submit review section.

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.

2 participants