Code Review

Two Modes

Task Mode (Uncommitted Files)

Reviews only uncommitted files in the working directory. Use for work-in-progress code before committing.

Command: bash skills/code-review/scripts/review-run.sh task

How it works:

• •Scans all uncommitted files (git status shows as modified/untracked)
• •Sends files to CodeRabbit for review
• •Saves results to .ada/data/reviews/task-review-{timestamp}.md

PR Mode (All Files vs Main)

Reviews all changed files in the current branch compared to the main branch. Use for complete PR review.

Command: bash skills/code-review/scripts/review-run.sh pr

How it works:

• •Compares current branch against main branch (or configured base branch)
• •Reviews all changed files in the diff
• •Saves results to .ada/data/reviews/pr-review-{timestamp}.md

Tools

• •ada::review:task - Review uncommitted changes
• •ada::review:pr - Review all PR files vs main branch
• •ada::review:read - Read latest review results
• •ada::review:cleanup - Clean up old review files

Workflow

Task Mode Workflow

1. •Make code changes: Edit files without committing
2. •Run review: Execute bash skills/code-review/scripts/review-run.sh task
   • •CodeRabbit analyzes uncommitted files
   • •Review is saved to .ada/data/reviews/
3. •Read results: Run bash skills/code-review/scripts/review-read.sh to view the latest review
   • •Shows issues, suggestions, and code quality feedback
4. •Address issues: Fix bugs, security issues, or code quality problems
5. •Re-review (optional): Run ada::review:task again to verify fixes
6. •Finalize: Run ada::agent:finalize to ensure code quality before committing

PR Mode Workflow

1. •Ensure branch is ready: Make sure all changes are committed
2. •Run review: Execute bash skills/code-review/scripts/review-run.sh pr
   • •CodeRabbit compares branch against main
   • •Reviews all changed files in the PR
3. •Read results: Run bash skills/code-review/scripts/review-read.sh to view the latest review
4. •Address issues: Fix all critical issues before merging
5. •Finalize: Run ada::agent:finalize and bash skills/docs-check/scripts/check-docs.sh to ensure completeness
6. •Clean up (optional): Run bash skills/code-review/scripts/review-cleanup.sh to remove old review files

Reading Review Results

Use bash skills/code-review/scripts/review-read.sh to display the most recent review:

• •Shows review content with issues and suggestions
• •Displays statistics (files reviewed, issues found)
• •Lists files that were reviewed

Examples

# Task mode
bash skills/code-review/scripts/review-run.sh task
bash skills/code-review/scripts/review-read.sh

# PR mode
bash skills/code-review/scripts/review-run.sh pr
bash skills/code-review/scripts/review-read.sh

# Complete workflow
bash skills/code-review/scripts/review-run.sh task && bash skills/code-review/scripts/review-read.sh
bash skills/code-quality/scripts/finalize.sh agent
bash skills/docs-check/scripts/check-docs.sh

References

• •Documentation Guide - For when to document changes

Output

Review results are saved to .ada/data/reviews/ directory:

• •{type}-review-{timestamp}.md - Review content
• •{type}-review-{timestamp}.json - Metadata with statistics

Integration with Other Skills

• •Run ada::code-quality after review to ensure reviewed code meets quality standards
• •Run ada::docs:check after review to ensure documentation is updated with code changes
• •Use ada::pr-review to manage GitHub PR comments after CodeRabbit review

Best Practices

• •Run task reviews frequently during development
• •Run PR reviews before submitting PRs
• •Address review issues before finalizing
• •Use ada::review:cleanup periodically to manage disk space
• •Combine with ada::code-quality and ada::docs:check for complete workflow