Review Code

Overview

Perform adversarial AI-assisted code review on a pull request or branch changes using Builder/Critic separation with dual-contract validation (Spec + Constitution).

Definitions

• {PR_KEY}: Pull Request identifier (e.g., PR-12, #12, 12). Can be specified as:
  • Full format: PR-12 or #12
  • Numeric only: 12
  • The command should accept any format and normalize it for API calls (extract numeric ID)
• {BRANCH_NAME}: Branch name to review (e.g., feat/FB-12, main, develop)
  • Can be local branch or remote branch
  • Format: {type}/{TASK_KEY} for feature branches (consistent with other commands)
• {FEATURE_DOMAIN}: Kebab-case feature name for Spec lookup (e.g., user-authentication, skill-audit)
  • Determines which Spec to read from specs/{FEATURE_DOMAIN}/spec.md
  • May be extracted from branch name, PR title, or Jira issue context
• PR (Pull Request): A GitHub pull request containing proposed changes to merge into a branch
  • Referenced using {PR_KEY} format (e.g., PR-12, #12, or 12)