Review Package Creator
Bundle current work into a self-contained zip with a contextual README and review prompt, ready to hand off to any external reviewer.
Phase 1: Gather Requirements
Ask the user two questions using AskUserQuestion:
Question 1: Review Type
- Header: "Review type"
- Question: "What type of review do you need?"
- Options:
1. Code review — Line-by-line feedback on implementation, bugs, edge cases, best practices 2. Architecture review — High-level feedback on patterns, structure, design decisions 3. Both — Comprehensive review covering code and architecture
Question 2: Specific Concerns
- Header: "Focus areas"
- Question: "Any specific concerns you want the reviewer to address?"
- multiSelect: true
- Options:
1. General review — No specific focus, broad feedback welcome 2. Performance — Efficiency, optimization opportunities 3. Security — Vulnerabilities, input validation, auth patterns 4. Maintainability — Code clarity, complexity, future extensibility
Wait for responses before proceeding.
Phase 2: Analyze Codebase
Spawn the analyzer agent:
- subagent_type:
review-package-analyzer - prompt: Include focus area ($ARGUMENTS or "current work"), review type from Phase 1, and project root (cwd).
Wait for the agent to return its structured analysis.
Phase 3: Generate README
Generate a unique suffix for temp files (e.g., timestamp: date +%s). Use this for all temp paths in subsequent phases.
Read references/readme-guide.md for structure guidelines. Write the README to /tmp/review-readme-{suffix}.md.
Adapt the README to the project — don't fill in a rigid template mechanically. The guide provides the sections and priorities; use judgment about what to emphasize based on the review type and analysis results.
Phase 4: Create File List
Extract all file paths from the analysis (Core, Related, Tests, Config). Write one path per line to /tmp/review-filelist-{suffix}.txt.
Phase 5: Create Package
Locate the packaging script:
find ~/.claude -path "*/review-package/scripts/create-review-zip.sh" -type f 2>/dev/null | head -1Run it:
/path/to/create-review-zip.sh \
"$(pwd)" \
"/tmp/review-readme-{suffix}.md" \
"/tmp/review-filelist-{suffix}.txt" \
"review-package-$(date +%Y%m%d-%H%M%S)"Phase 6: Generate Instructional Prompt
Read references/prompt-guide.md for the template. Customize based on review type, focus areas, and concerns from the analysis.
Write to /tmp/review-prompt-{suffix}.md and copy to clipboard:
cat /tmp/review-prompt-{suffix}.md | pbcopyPhase 7: Report
Tell the user: zip location, file counts (core/related/tests), display the instructional prompt inline, and list next steps (open a new chat with any AI model, paste prompt, upload zip). Mention the prompt is on the clipboard and saved to the temp path.
Clean up temp files (keep the prompt file):
rm -f /tmp/review-readme-{suffix}.md /tmp/review-filelist-{suffix}.txtNotes
- If $ARGUMENTS is empty, the analyzer auto-detects current work from git status and recent changes
- For non-git projects, the analyzer falls back to recently-modified files
- The package is self-contained — the reviewer needs no other context
- Files are copied with directory structure preserved
- Binary files and build artifacts are excluded automatically