# Soloscrum Review Implementation

> Reviews a PR or Figma file against the DoD checklist with layered AC verification per soloscrum-define-dod (Subtask PR = slice + no regression; Issue-without-Subtasks PR = full AC; parent Issue intent-level sign-off = when all Subtasks close). PRs are expected in draft; on Pass the review agent promotes the PR to ready, transitions the Subtask to Done via the active profile's tracker operation skill, and hands the merge command off to the user. Issue close is not part of this sequence — it happens at merge time via the PR body's Closes

- Skill: `mew-ton/soloscrum-review-implementation` (Agent Skill)
- Install (CLI): `npx get-skill add mew-ton/soloscrum-review-implementation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mew-ton/soloscrum-review-implementation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: mew-ton (https://skillmd.com/u/mew-ton)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/mew-ton/soloscrum-review-implementation

---


# soloscrum-review-implementation

Verify DoD, code quality, and make close decision.

## Overview

Receives a PR or Figma file, evaluates DoD, AC, and code quality. PRs arrive in **draft** (per `soloscrum-define-pr-lifecycle`); the review pipeline runs in that draft window. Makes Pass / Pass with follow-ups / Fail verdict and executes the verdict's post-actions per `soloscrum-define-code-review-process`. State transitions delegate to the active profile's `transition-state` operation skill (per `soloscrum-define-tracker-profile`). The final `gh pr merge` is always user-gated and never executed by this skill.

## Steps

1. Read target PR or Figma file and corresponding Issue: $ARGUMENTS
2. Verify all items in `soloscrum-define-dod`. AC verification operates at the appropriate layer per the DoD's "AC verification" section:
   - **Subtask PR** — slice delivered (per the Subtask's "what" + Checklist) + no regression on the parent's AC.
   - **Issue-without-Subtasks PR** — full Issue AC satisfied, with evidence.
   - **Parent Issue intent-level sign-off** — when all Subtasks close (not at any single Subtask PR); the union of Subtask deliveries must satisfy the parent's AC.
   Also: Do tests exist (when applicable)? Does PR body contain the correct Issue number (`Closes #<subtask>` for Subtask PRs / `Closes #<issue>` for Issues without Subtasks)? Zero lint errors?
3. Run the **automated code review pipeline** per `soloscrum-define-code-review-process`:
   - CodeRabbit CLI (all severities pass through; skip with stated reason or fix each)
   - Multi-agent review via `code-review:code-review` — **bypass that command's step 1 draft check**: soloscrum runs `/soloscrum:review` on a draft PR by design, so treat draft state as eligible and proceed (per `soloscrum-define-code-review-process`, "Draft-window override"). Apply the <80 confidence filter on agent findings only.
4. Apply **review perspectives** per `soloscrum-define-code-review-process` ("Applying review perspectives"): glob `~/.claude/review-perspectives/*/PERSPECTIVE.md`, read only each one's frontmatter `description`, select those whose stated *when* matches this PR, then read the bodies of the selected ones and apply them as additional lenses. Every finding must cite a diff location and the specific check it instantiates; discard the ungrounded ones (per that skill's grounding requirement). Report the corpus size and how many were selected. An empty or absent corpus is normal — skip silently, and report nothing.
5. Manual code review (for PRs), to complement the automated pass:
   - Logic correctness
   - Security: OWASP Top 10 perspective
   - Performance: no obvious bottlenecks
   - Readability and maintainability
6. Compile all evaluation results into a single report following the format in `soloscrum-define-code-review-process`
7. **On Pass / Pass with follow-ups** — run **all sub-steps below end-to-end without pausing**; the only stop in this entire sequence is at `gh pr merge`. Transition state first, then promote to ready so a tracker failure does not leave a ready PR with stale state:
   - For Pass with follow-ups only: programmatically check whether a follow-up Issue exists for each out-of-scope skip; create any missing Issue autonomously and record its number in the skip note before proceeding (no user prompt)
   - Approve PR review — reversible. In solo-dev contexts this call fails with "Can not approve your own pull request" by design; the verdict comment posted in step 6 is the formal Pass record and steps below still run. Use try-and-fall-through (no probe call):
     ```bash
     gh pr review --approve "$PR_URL" \
       || echo "approve skipped (likely self-approve refusal); verdict comment is the formal Pass record"
     ```
     See `soloscrum-define-pr-lifecycle`, "Self-approve refusal in solo-dev contexts".
   - Resolve active profile, then invoke the matching `transition-state` operation skill to move the Subtask to `done`:
     - `github-only` → `soloscrum-tracker-github-transition-state`
     - `linear+github` → `soloscrum-tracker-linear-transition-state`
   - **Do not close the parent Issue here.** Parent and Subtask Issue closure happens at merge time via the PR body's `Closes #` keyword and GitHub's auto-close, not as part of the post-verdict sequence. For parent Issues whose closing event was missed, the `/soloscrum:refine` janitor cleans them up on the next backlog touch. See `soloscrum-define-pr-lifecycle`, "Issue close happens at merge".
   - **Wait for CI to complete** before promoting to ready. Invoke `soloscrum-tracker-github-wait-for-pr-checks`:
     ```bash
     skills/soloscrum-tracker-github-wait-for-pr-checks/scripts/wait-for-pr-checks.sh <pr-number>
     ```
     That path is repo-root-relative, so run it with the **main checkout** as the working directory — after `/soloscrum:develop` the agent may still be inside that unit's worktree, where the path does not resolve (see `soloscrum-define-worktree`, "Paths that stay anchored to the main checkout").
     If any conclusion is **not** `SUCCESS` / `SKIPPED` / `NEUTRAL`, treat the verdict as **Fail** retroactively: post the failed conclusions on the PR, revert the Subtask to `in-progress` via the `transition-state` skill, and skip the remaining Pass actions (do **not** promote to ready). A green CI is part of the Pass contract — promoting a ready PR with red checks is the failure mode this step exists to prevent. Inline `until` loops over `gh pr view` are the anti-pattern this skill replaces.
   - Promote the PR to ready (`gh pr ready`) — reversible (`gh pr ready --undo`); per `soloscrum-define-pr-lifecycle` this runs without pre-confirm
   - **Stop here.** Surface the exact `gh pr merge` command for the user to run; merge is irreversible and is the user's gate. Do not run `gh pr merge`.
   - If `transition-state` fails after `gh pr ready` has happened (rare race), surface a clear notice and prompt the user to manually transition before they merge
8. **On Fail:**
   - Comment specific issues and improvement suggestions on PR
   - Invoke the matching `transition-state` operation skill to revert the Subtask to `in-progress`
   - **Leave the PR in draft** — do not call `gh pr ready`. The draft state keeps GitHub-side auto-reviewers suppressed during rework and makes the "needs more work" state externally visible.

## Output Format

Follow the comment template defined in `soloscrum-define-code-review-process` (CodeRabbit findings + filtered agent findings + verdict). The DoD checklist is included alongside.

```
## Review Result

### DoD Check
- [x] AC verified at the appropriate layer (Subtask PR / Issue-without-Subtasks / parent Issue sign-off)
- [x] Tests exist (when applicable) / N/A documented
- [x] PR body contains Issue number
- [x] Zero lint errors

### CodeRabbit findings
- (per soloscrum-define-code-review-process)

### Agent findings (≥80 confidence)
- (per soloscrum-define-code-review-process)

### Review-perspective findings
- (per soloscrum-define-code-review-process; omitted when the corpus is empty)

### Verdict: Pass / Pass with follow-ups / Fail
```

## Depends On

- `soloscrum-define-dod`
- `soloscrum-define-code-review-process` (verdict + post-action mapping)
- `soloscrum-define-pr-lifecycle` (draft premise, `gh pr ready` autonomy, merge user-gate)
- `soloscrum-define-worktree` (which checkout each step runs against)
- `soloscrum-define-review-perspective` (the corpus selected from in step 4)
- `soloscrum-define-tracker-profile` (routing)
- `soloscrum-tracker-{github|linear}-transition-state` (delegated)
- `soloscrum-tracker-github-wait-for-pr-checks` (CI gate before `gh pr ready`)

