multi-review

Files (1)

• SKILL.md

SKILL.md (first lines)

# Multiple Code Reviewers

This command performs a comprehensive code review using specialized sub-agents.

## Step 1: Setup and detect tk

Run these commands sequentially in a **single Bash call** to prepare the environment and detect tk:
```bash
mkdir -p .code-review
rm -f .code-review/*.md
touch .code-review/changed-files.txt
TK_AVAILABLE=false
if command -v tk >/dev/null 2>&1; then
  TK_AVAILABLE=true
fi
echo "TK_AVAILABLE=$TK_AVAILABLE"
```

## Step 2: Determine review scope

Parse `$ARGUMENTS` to determine what to review. Set two variables: the file list in `.code-review/changed-files.txt` and `REVIEW_CMD` (passed to reviewers).

- **No arguments** (default): Review uncommitted changes
  ```bash
  git status --porcelain | awk '{print $NF}' > .code-review/changed-files.txt
  ```
  `REVIEW_CMD=git diff`

- **Commit references** (e.g., "last 3 commits", "since abc123", "HEAD~5"):
  Determine the appropriate base ref from the user's intent, then:
  ```bash
  git diff --name-only <base-ref> > .code-review/changed-files.txt
  ```
  `REVIEW_CMD=git diff <base-ref> --`

- **Specific files** (e.g., "Review src/auth.py src/models.py"):
  Write the specified file paths to `.code-review/changed-files.txt` (one per line).
  `REVIEW_CMD=FULL_FILE`

It's CRUCIAL that reviewers ONLY analyze files listed in .code-review/changed-files.txt and NOTHING ELSE.

## Step 3: Collect CLAUDE.md context

Collect CLAUDE.md files from the project root and from directories containing changed files. This content is passed to reviewers so they can check for project convention violations.

Run this to build `.code-review/claude-md-context.txt`:
```bash
> .code-review/claude-md-context.txt
[ -f CLAUDE.md ] && { echo "=== CLAUDE.md (root) ==="; cat CLAUDE.md; echo; } >> .code-review/claude-md-context.txt
while IFS= read -r file; do
  dir=$(dirname "$file")
  if [ "$dir" != "." ] && [ -f "$dir/CLAUDE.md" ]; then
    echo "=== CLAUDE.md ($dir) ===" >> .code-review/claude-md-context.txt
    cat "$dir/CLAUDE.md" >> .code-review/claude-md-context.txt
    echo >> .code-review/claude-md-context.txt
  fi
done < .code-review/changed-files.txt
```

If the resulting file is empty (no CLAUDE.md files found), delete it so reviewers know there is no context:
```bash
[ ! -s .code-review/claude-md-context.txt ] && rm -f .code-review/claude-md-context.txt
```

## Step 4: tk mode setup (if TK_AVAILABLE)

If `TK_AVAILABLE` is true:

1. Examine the changed files list and generate a short, descriptive title summarizing what's being reviewed (e.g., "Review: Auth module refactor" or "Review: API endpoint updates and test fixes").
2. Create an epic with a timestamp for uniqueness:
```bash
EPIC_ID=$(tk create "<generated title> (<YYYY-MM-DD HH:MM>)" -t epic -p 2 --tags code-review -d "<brief summary of changes being reviewed>")
```
3. Note the `EPIC_ID` for passing to sub-agents.

## Step 5: Launch reviewers

If there are files to review, use the Task tool to invoke these specialized reviewers in parallel.

Include `REVIEW_CMD=<command>` in each prompt so reviewers know how to examine files.

### tk mode (TK_AVAILABLE=true)

Pass the epic ID and review command to each sub-agent via the prompt string:

1. Invoke the code-reviewer-1 sub-agent:
```
Task: Review code for logical correctness
Prompt: TK_MODE=true EPIC_ID=<epic_id> REVIEW_CMD=<review_cmd> -- Review ONLY files in .code-review/changed-files.txt - do NOT examine any other files
SubagentType: code-reviewer-1
```

2. Invoke the code-reviewer-2 sub-agent:
```
Task: Review code for performance
Prompt: TK_MODE=true EPIC_ID=<epic_id> REVIEW_CMD=<review_cmd> -- Review ONLY files in .code-review/changed-files.txt - do NOT examine any other files
SubagentType: code-reviewer-2
```

3. Invoke the code-reviewer-3 sub-agent:
```
Task: Review code for readability
Prompt: TK_MODE=true EPIC_ID=<epic_id> REVIEW_CMD=<review_cmd> -- Review ONLY files in .code-review/changed-files.txt - do NOT examine any other files
SubagentType: code-reviewer-3
```

4. Invoke the security-reviewer sub-agent:
```
Task: Review code for security issues
Prompt: TK_MODE=true EPIC_ID=<epic_id> REVIEW_CMD=<review_cmd> -- Review ONLY files in .code-review/changed-files.txt - do NOT examine any other files
SubagentType: security-reviewer
```

### File mode (TK_AVAILABLE=false)

Pass the review command without tk parameters:

1. Invoke the code-reviewer-1 sub-agent:
```

From phobologic/claude_code, MIT.

More from phobologic/claude_code