prr-kit 1.1.2 → 1.2.0

package/docs/assets/banner.svg

@@ -1,179 +1,47 @@
-<svg width="1200" height="300" viewBox="0 0 1200 300" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <!-- Background gradient -->
-    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#0d1117"/>
-      <stop offset="100%" style="stop-color:#161b22"/>
-    </linearGradient>
-
-    <!-- Accent gradient (purple → blue) -->
-    <linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
-      <stop offset="0%" style="stop-color:#a855f7"/>
-      <stop offset="100%" style="stop-color:#3b82f6"/>
-    </linearGradient>
-
-    <!-- Glow filter for accent line -->
-    <filter id="glow" x="-20%" y="-200%" width="140%" height="500%">
-      <feGaussianBlur stdDeviation="4" result="blur"/>
-      <feMerge>
-        <feMergeNode in="blur"/>
-        <feMergeNode in="SourceGraphic"/>
-      </feMerge>
-    </filter>
-
-    <!-- Subtle grid pattern -->
-    <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
-      <path d="M 40 0 L 0 0 0 40" fill="none" stroke="#ffffff" stroke-width="0.3" opacity="0.04"/>
-    </pattern>
-
-    <!-- Corner dot pattern -->
-    <pattern id="dots" width="20" height="20" patternUnits="userSpaceOnUse">
-      <circle cx="1" cy="1" r="1" fill="#ffffff" opacity="0.06"/>
-    </pattern>
-  </defs>
+<svg width="1200" height="280" viewBox="0 0 1200 280" xmlns="http://www.w3.org/2000/svg">
 
   <!-- Background -->
-  <rect width="1200" height="300" fill="url(#bg)"/>
-
-  <!-- Grid overlay -->
-  <rect width="1200" height="300" fill="url(#grid)"/>
-
-  <!-- Dot pattern on right side -->
-  <rect x="800" y="0" width="400" height="300" fill="url(#dots)"/>
-
-  <!-- Decorative circles (blurred, background) -->
-  <circle cx="980" cy="80" r="120" fill="#a855f7" opacity="0.06"/>
-  <circle cx="1100" cy="220" r="80" fill="#3b82f6" opacity="0.06"/>
-  <circle cx="150" cy="240" r="100" fill="#a855f7" opacity="0.04"/>
-
-  <!-- Top accent line -->
-  <rect x="0" y="0" width="1200" height="3" fill="url(#accent)" filter="url(#glow)"/>
-
-  <!-- Left vertical accent bar -->
-  <rect x="64" y="60" width="3" height="180" fill="url(#accent)" opacity="0.8" filter="url(#glow)"/>
-
-  <!-- Icon area: magnifying glass SVG path -->
-  <g transform="translate(100, 110)">
-    <circle cx="28" cy="28" r="26" fill="none" stroke="url(#accent)" stroke-width="3" opacity="0.9"/>
-    <circle cx="28" cy="28" r="18" fill="none" stroke="url(#accent)" stroke-width="1.5" opacity="0.3"/>
-    <line x1="47" y1="47" x2="62" y2="62" stroke="url(#accent)" stroke-width="4" stroke-linecap="round" opacity="0.9"/>
-    <!-- Code lines inside glass -->
-    <line x1="18" y1="23" x2="38" y2="23" stroke="#a855f7" stroke-width="2" stroke-linecap="round" opacity="0.6"/>
-    <line x1="18" y1="30" x2="32" y2="30" stroke="#3b82f6" stroke-width="2" stroke-linecap="round" opacity="0.6"/>
-    <line x1="18" y1="37" x2="36" y2="37" stroke="#a855f7" stroke-width="2" stroke-linecap="round" opacity="0.4"/>
+  <rect width="1200" height="280" fill="#000000"/>
+
+  <!-- Icon -->
+  <g transform="translate(80, 90)">
+    <circle cx="40" cy="40" r="32" fill="none" stroke="#ffffff" stroke-width="3"/>
+    <line x1="65" y1="65" x2="86" y2="86" stroke="#ffffff" stroke-width="4" stroke-linecap="round"/>
+    <line x1="26" y1="34" x2="54" y2="34" stroke="#ffffff" stroke-width="2.5" stroke-linecap="round" opacity="0.45"/>
+    <line x1="26" y1="42" x2="48" y2="42" stroke="#ffffff" stroke-width="2.5" stroke-linecap="round" opacity="0.45"/>
+    <line x1="26" y1="50" x2="52" y2="50" stroke="#ffffff" stroke-width="2.5" stroke-linecap="round" opacity="0.45"/>
   </g>
 
-  <!-- Main title -->
-  <text x="190" y="145" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
-        font-size="52" font-weight="700" letter-spacing="-1" fill="#ffffff">
-    PR Review Framework
+  <!-- Title -->
+  <text x="200" y="138"
+        font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
+        font-size="58" font-weight="700" letter-spacing="-2" fill="#ffffff">
+    PR Review Kit
   </text>
 
-  <!-- Accent underline under title -->
-  <rect x="190" y="157" width="420" height="2" fill="url(#accent)" opacity="0.5" rx="1"/>
-
-  <!-- Subtitle -->
-  <text x="192" y="192" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
-        font-size="20" font-weight="400" fill="#8b949e" letter-spacing="0.3">
-    AI-driven Pull Request review — structured, multi-perspective, actionable
+  <!-- Tagline -->
+  <text x="200" y="176"
+        font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
+        font-size="17" font-weight="400" fill="#555555" letter-spacing="0.2">
+    What if your AI actually understood your codebase before reviewing?
   </text>
 
-  <!-- Badges row -->
-  <!-- Badge 1: Claude Code -->
-  <g transform="translate(192, 218)">
-    <rect width="112" height="26" rx="13" fill="#21262d" stroke="#30363d" stroke-width="1"/>
-    <circle cx="18" cy="13" r="5" fill="#a855f7" opacity="0.9"/>
-    <text x="30" y="17.5" font-family="monospace" font-size="11" fill="#8b949e">Claude Code</text>
-  </g>
-
-  <!-- Badge 2: Cursor -->
-  <g transform="translate(314, 218)">
-    <rect width="74" height="26" rx="13" fill="#21262d" stroke="#30363d" stroke-width="1"/>
-    <circle cx="18" cy="13" r="5" fill="#3b82f6" opacity="0.9"/>
-    <text x="30" y="17.5" font-family="monospace" font-size="11" fill="#8b949e">Cursor</text>
-  </g>
+  <!-- Pills -->
+  <g transform="translate(200, 204)">
+    <rect width="130" height="28" rx="14" fill="none" stroke="#ffffff" stroke-width="1.2"/>
+    <text x="65" y="19" text-anchor="middle" font-family="monospace" font-size="11" fill="#ffffff">Stack-aware</text>
 
-  <!-- Badge 3: Windsurf -->
-  <g transform="translate(398, 218)">
-    <rect width="86" height="26" rx="13" fill="#21262d" stroke="#30363d" stroke-width="1"/>
-    <circle cx="18" cy="13" r="5" fill="#06b6d4" opacity="0.9"/>
-    <text x="30" y="17.5" font-family="monospace" font-size="11" fill="#8b949e">Windsurf</text>
-  </g>
+    <rect x="142" width="120" height="28" rx="14" fill="none" stroke="#333333" stroke-width="1.2"/>
+    <text x="202" y="19" text-anchor="middle" font-family="monospace" font-size="11" fill="#555555">Context-first</text>
 
-  <!-- Badge 4: Node.js -->
-  <g transform="translate(494, 218)">
-    <rect width="90" height="26" rx="13" fill="#21262d" stroke="#30363d" stroke-width="1"/>
-    <circle cx="18" cy="13" r="5" fill="#22c55e" opacity="0.9"/>
-    <text x="30" y="17.5" font-family="monospace" font-size="11" fill="#8b949e">Node 18+</text>
+    <rect x="274" width="136" height="28" rx="14" fill="none" stroke="#333333" stroke-width="1.2"/>
+    <text x="342" y="19" text-anchor="middle" font-family="monospace" font-size="11" fill="#555555">Any AI tool</text>
   </g>
 
-  <!-- Right side: review flow diagram -->
-  <g transform="translate(820, 55)" opacity="0.85">
-    <!-- Flow boxes -->
-    <!-- SP -->
-    <rect x="0" y="0" width="80" height="30" rx="6" fill="#21262d" stroke="#30363d" stroke-width="1"/>
-    <text x="40" y="20" text-anchor="middle" font-family="monospace" font-size="12" fill="#a855f7" font-weight="600">SP</text>
-
-    <!-- Arrow -->
-    <line x1="80" y1="15" x2="110" y2="15" stroke="#30363d" stroke-width="1.5" marker-end="url(#arr)"/>
-
-    <!-- DP -->
-    <rect x="110" y="0" width="80" height="30" rx="6" fill="#21262d" stroke="#30363d" stroke-width="1"/>
-    <text x="150" y="20" text-anchor="middle" font-family="monospace" font-size="12" fill="#3b82f6" font-weight="600">DP</text>
-
-    <!-- Row 2: review types -->
-    <!-- Vertical line down from DP -->
-    <line x1="150" y1="30" x2="150" y2="55" stroke="#30363d" stroke-width="1.5"/>
-    <!-- Horizontal line -->
-    <line x1="30" y1="55" x2="270" y2="55" stroke="#30363d" stroke-width="1.5"/>
-
-    <!-- GR -->
-    <line x1="30" y1="55" x2="30" y2="75" stroke="#30363d" stroke-width="1.5"/>
-    <rect x="-10" y="75" width="80" height="28" rx="6" fill="#21262d" stroke="#a855f7" stroke-width="1" opacity="0.8"/>
-    <text x="30" y="93" text-anchor="middle" font-family="monospace" font-size="11" fill="#a855f7">GR</text>
-
-    <!-- SR -->
-    <line x1="110" y1="55" x2="110" y2="75" stroke="#30363d" stroke-width="1.5"/>
-    <rect x="70" y="75" width="80" height="28" rx="6" fill="#21262d" stroke="#ef4444" stroke-width="1" opacity="0.8"/>
-    <text x="110" y="93" text-anchor="middle" font-family="monospace" font-size="11" fill="#ef4444">SR</text>
-
-    <!-- PR -->
-    <line x1="190" y1="55" x2="190" y2="75" stroke="#30363d" stroke-width="1.5"/>
-    <rect x="150" y="75" width="80" height="28" rx="6" fill="#21262d" stroke="#f59e0b" stroke-width="1" opacity="0.8"/>
-    <text x="190" y="93" text-anchor="middle" font-family="monospace" font-size="11" fill="#f59e0b">PR</text>
-
-    <!-- AR -->
-    <line x1="270" y1="55" x2="270" y2="75" stroke="#30363d" stroke-width="1.5"/>
-    <rect x="230" y="75" width="80" height="28" rx="6" fill="#21262d" stroke="#06b6d4" stroke-width="1" opacity="0.8"/>
-    <text x="270" y="93" text-anchor="middle" font-family="monospace" font-size="11" fill="#06b6d4">AR</text>
-
-    <!-- Converge line -->
-    <line x1="30" y1="103" x2="30" y2="130" stroke="#30363d" stroke-width="1.5"/>
-    <line x1="110" y1="103" x2="110" y2="130" stroke="#30363d" stroke-width="1.5"/>
-    <line x1="190" y1="103" x2="190" y2="130" stroke="#30363d" stroke-width="1.5"/>
-    <line x1="270" y1="103" x2="270" y2="130" stroke="#30363d" stroke-width="1.5"/>
-    <line x1="30" y1="130" x2="270" y2="130" stroke="#30363d" stroke-width="1.5"/>
-    <line x1="150" y1="130" x2="150" y2="150" stroke="#30363d" stroke-width="1.5"/>
-
-    <!-- RR -->
-    <rect x="110" y="150" width="80" height="30" rx="6" fill="#21262d" stroke="#22c55e" stroke-width="1"/>
-    <text x="150" y="170" text-anchor="middle" font-family="monospace" font-size="12" fill="#22c55e" font-weight="600">RR</text>
-
-    <!-- Arrow to PC -->
-    <line x1="190" y1="165" x2="220" y2="165" stroke="#30363d" stroke-width="1.5"/>
-
-    <!-- PC -->
-    <rect x="220" y="150" width="80" height="30" rx="6" fill="#21262d" stroke="#8b949e" stroke-width="1"/>
-    <text x="260" y="170" text-anchor="middle" font-family="monospace" font-size="12" fill="#8b949e" font-weight="600">PC</text>
-
-    <!-- Labels -->
-    <text x="40" y="-10" font-family="monospace" font-size="10" fill="#484f58">Select PR</text>
-    <text x="115" y="-10" font-family="monospace" font-size="10" fill="#484f58">Describe</text>
-    <text x="0" y="118" font-family="monospace" font-size="9" fill="#484f58">Reviews</text>
-    <text x="110" y="200" font-family="monospace" font-size="10" fill="#484f58">Report</text>
-    <text x="225" y="200" font-family="monospace" font-size="10" fill="#484f58">GitHub</text>
-  </g>
+  <!-- Command block -->
+  <rect x="820" y="104" width="280" height="52" rx="4" fill="#0d0d0d"/>
+  <text x="840" y="126" font-family="monospace" font-size="11" fill="#444444">$ npx prr-kit init</text>
+  <line x1="840" y1="134" x2="1084" y2="134" stroke="#222222" stroke-width="1"/>
+  <text x="840" y="148" font-family="monospace" font-size="11" fill="#777777">/prr-quick</text>
 
-  <!-- Bottom accent line -->
-  <rect x="0" y="297" width="1200" height="3" fill="url(#accent)" opacity="0.4"/>
 </svg>

package/docs/assets/how-it-works.svg

@@ -0,0 +1,87 @@
+<svg width="1200" height="240" viewBox="0 0 1200 240" xmlns="http://www.w3.org/2000/svg">
+
+  <!-- Background -->
+  <rect width="1200" height="240" fill="#000000"/>
+
+  <!-- Title -->
+  <text x="600" y="38" text-anchor="middle"
+        font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
+        font-size="18" font-weight="700" fill="#ffffff" letter-spacing="-0.3">How It Works</text>
+
+  <!-- ══════════ PIPELINE ══════════ -->
+
+  <!-- 01 Select PR -->
+  <g transform="translate(40, 62)">
+    <rect width="130" height="76" rx="5" fill="#0d0d0d"/>
+    <text x="65" y="22" text-anchor="middle" font-family="monospace" font-size="8" fill="#333333" letter-spacing="2">01</text>
+    <text x="65" y="48" text-anchor="middle" font-family="monospace" font-size="22" fill="#ffffff" font-weight="700">SP</text>
+    <text x="65" y="66" text-anchor="middle" font-family="-apple-system, 'Segoe UI', sans-serif" font-size="11" fill="#555555">Select PR</text>
+  </g>
+
+  <line x1="170" y1="100" x2="196" y2="100" stroke="#2a2a2a" stroke-width="1.5"/>
+  <polygon points="196,96 204,100 196,104" fill="#2a2a2a"/>
+
+  <!-- 02 Describe PR -->
+  <g transform="translate(204, 62)">
+    <rect width="130" height="76" rx="5" fill="#0d0d0d"/>
+    <text x="65" y="22" text-anchor="middle" font-family="monospace" font-size="8" fill="#333333" letter-spacing="2">02</text>
+    <text x="65" y="48" text-anchor="middle" font-family="monospace" font-size="22" fill="#ffffff" font-weight="700">DP</text>
+    <text x="65" y="66" text-anchor="middle" font-family="-apple-system, 'Segoe UI', sans-serif" font-size="11" fill="#555555">Describe PR</text>
+  </g>
+
+  <!-- dashed arrow = auto -->
+  <line x1="334" y1="100" x2="354" y2="100" stroke="#2a2a2a" stroke-width="1.5" stroke-dasharray="4,3"/>
+  <polygon points="354,96 362,100 354,104" fill="#2a2a2a"/>
+  <text x="348" y="92" text-anchor="middle" font-family="monospace" font-size="8" fill="#333333">auto</text>
+
+  <!-- 03 Collect Context (highlighted) -->
+  <g transform="translate(362, 50)">
+    <rect width="186" height="100" rx="5" fill="#0d0d0d" stroke="#ffffff" stroke-width="1.2"/>
+    <text x="12" y="20" font-family="monospace" font-size="8" fill="#333333" letter-spacing="1">03</text>
+    <text x="93" y="52" text-anchor="middle" font-family="monospace" font-size="15" fill="#ffffff" font-weight="700">Collect Context</text>
+    <text x="93" y="72" text-anchor="middle" font-family="monospace" font-size="9" fill="#444444">Reads your actual project config</text>
+    <text x="93" y="88" text-anchor="middle" font-family="monospace" font-size="9" fill="#333333">→ pr-context.yaml</text>
+  </g>
+
+  <line x1="548" y1="100" x2="568" y2="100" stroke="#2a2a2a" stroke-width="1.5"/>
+  <polygon points="568,96 576,100 568,104" fill="#2a2a2a"/>
+
+  <!-- 04 Deep Review (mystery) -->
+  <g transform="translate(576, 50)">
+    <rect width="222" height="100" rx="5" fill="#0d0d0d"/>
+    <text x="12" y="20" font-family="monospace" font-size="8" fill="#333333" letter-spacing="1">04</text>
+    <text x="111" y="52" text-anchor="middle" font-family="-apple-system, 'Segoe UI', sans-serif" font-size="13" fill="#cccccc" font-weight="600">Deep Review</text>
+    <text x="111" y="72" text-anchor="middle" font-family="monospace" font-size="9" fill="#444444">Security · Perf · Arch · Bugs</text>
+    <text x="111" y="88" text-anchor="middle" font-family="monospace" font-size="9" fill="#333333">structured findings per concern</text>
+  </g>
+
+  <line x1="798" y1="100" x2="818" y2="100" stroke="#2a2a2a" stroke-width="1.5"/>
+  <polygon points="818,96 826,100 818,104" fill="#2a2a2a"/>
+
+  <!-- 05 Report -->
+  <g transform="translate(826, 62)">
+    <rect width="130" height="76" rx="5" fill="#0d0d0d"/>
+    <text x="65" y="22" text-anchor="middle" font-family="monospace" font-size="8" fill="#333333" letter-spacing="2">05</text>
+    <text x="65" y="48" text-anchor="middle" font-family="monospace" font-size="22" fill="#ffffff" font-weight="700">RR</text>
+    <text x="65" y="66" text-anchor="middle" font-family="-apple-system, 'Segoe UI', sans-serif" font-size="11" fill="#555555">Report</text>
+  </g>
+
+  <line x1="956" y1="100" x2="976" y2="100" stroke="#2a2a2a" stroke-width="1.5"/>
+  <polygon points="976,96 984,100 976,104" fill="#2a2a2a"/>
+
+  <!-- 06 Post Comments (optional, dimmed) -->
+  <g transform="translate(984, 62)" opacity="0.4">
+    <rect width="130" height="76" rx="5" fill="#0d0d0d"/>
+    <text x="65" y="22" text-anchor="middle" font-family="monospace" font-size="8" fill="#333333" letter-spacing="2">06</text>
+    <text x="65" y="48" text-anchor="middle" font-family="monospace" font-size="22" fill="#ffffff" font-weight="700">PC</text>
+    <text x="65" y="66" text-anchor="middle" font-family="-apple-system, 'Segoe UI', sans-serif" font-size="11" fill="#555555">Post Comments</text>
+  </g>
+  <text x="1049" y="153" text-anchor="middle" font-family="monospace" font-size="8" fill="#333333">optional</text>
+
+  <!-- ══════════ Quick mode ══════════ -->
+  <rect x="40" y="178" width="400" height="30" rx="4" fill="#0d0d0d"/>
+  <text x="56" y="198" font-family="monospace" font-size="10" fill="#555555">Quick mode: </text>
+  <text x="136" y="198" font-family="monospace" font-size="10" fill="#ffffff">/prr-quick</text>
+  <text x="208" y="198" font-family="monospace" font-size="10" fill="#333333"> — one command, full pipeline</text>
+
+</svg>

package/package.json

@@ -1,60 +1,60 @@
-{
-  "name": "prr-kit",
-  "version": "1.1.2",
-  "description": "AI-driven Pull Request Review Kit — structured agent workflows for thorough, consistent code review",
-  "main": "tools/cli/prr-cli.js",
-  "bin": {
-    "prr-kit": "tools/prr-npx-wrapper.js",
-    "pr-review": "tools/prr-npx-wrapper.js"
-  },
-  "scripts": {
-    "prr:install": "node tools/cli/prr-cli.js install",
-    "prr:uninstall": "node tools/cli/prr-cli.js uninstall",
-    "prr:status": "node tools/cli/prr-cli.js status",
-    "test": "node test/test-agent-schema.js && node test/test-installation-components.js",
-    "test:schemas": "node test/test-agent-schema.js",
-    "test:install": "node test/test-installation-components.js",
-    "lint": "eslint . --ext .js,.cjs,.mjs --max-warnings=0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "files": [
-    "src/",
-    "tools/",
-    "docs/assets/"
-  ],
-  "keywords": [
-    "code-review",
-    "pull-request",
-    "ai",
-    "agent",
-    "workflow",
-    "claude",
-    "cursor",
-    "windsurf",
-    "github",
-    "gitlab"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mrquangthai278/prr-kit.git"
-  },
-  "homepage": "https://github.com/mrquangthai278/prr-kit#readme",
-  "bugs": {
-    "url": "https://github.com/mrquangthai278/prr-kit/issues"
-  },
-  "license": "MIT",
-  "dependencies": {
-    "@clack/prompts": "^0.10.0",
-    "chalk": "^4.1.2",
-    "commander": "^14.0.0",
-    "csv-parse": "^6.1.0",
-    "fs-extra": "^11.3.0",
-    "glob": "^11.0.3",
-    "yaml": "^2.7.0"
-  },
-  "devDependencies": {
-    "eslint": "^9.0.0"
-  }
-}
+{
+  "name": "prr-kit",
+  "version": "1.2.0",
+  "description": "AI-driven Pull Request Review Kit — structured agent workflows for thorough, consistent code review",
+  "main": "tools/cli/prr-cli.js",
+  "bin": {
+    "prr-kit": "tools/prr-npx-wrapper.js",
+    "pr-review": "tools/prr-npx-wrapper.js"
+  },
+  "scripts": {
+    "prr:install": "node tools/cli/prr-cli.js install",
+    "prr:uninstall": "node tools/cli/prr-cli.js uninstall",
+    "prr:status": "node tools/cli/prr-cli.js status",
+    "test": "node test/test-agent-schema.js && node test/test-installation-components.js",
+    "test:schemas": "node test/test-agent-schema.js",
+    "test:install": "node test/test-installation-components.js",
+    "lint": "eslint . --ext .js,.cjs,.mjs --max-warnings=0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "src/",
+    "tools/",
+    "docs/assets/"
+  ],
+  "keywords": [
+    "code-review",
+    "pull-request",
+    "ai",
+    "agent",
+    "workflow",
+    "claude",
+    "cursor",
+    "windsurf",
+    "github",
+    "gitlab"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrquangthai278/prr-kit.git"
+  },
+  "homepage": "https://github.com/mrquangthai278/prr-kit#readme",
+  "bugs": {
+    "url": "https://github.com/mrquangthai278/prr-kit/issues"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.10.0",
+    "chalk": "^4.1.2",
+    "commander": "^14.0.0",
+    "csv-parse": "^6.1.0",
+    "fs-extra": "^11.3.0",
+    "glob": "^11.0.3",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "eslint": "^9.0.0"
+  }
+}

package/src/core/agents/prr-master.agent.yaml

@@ -4,7 +4,7 @@ agent:
     name: "PRR Master"
     title: "PR Review Master Orchestrator"
     icon: "🔍"
-    capabilities: "PR discovery, review orchestration, report generation, workflow routing, git operations"
+    capabilities: "PR discovery, review orchestration, report generation, workflow routing, git operations, MCP tool integration, RAG context enrichment"
     hasSidecar: false
 
   persona:
@@ -18,22 +18,25 @@ agent:
       - For security-sensitive changes: always recommend security review
       - For performance-critical code: always recommend performance review
       - Keep track of which reviews have been completed in the session
+      - If MCP tools are available (Confluence, Jira, Linear, Figma, etc.), use them during context collection to enrich review quality
+      - If RAG tools are available, query for similar patterns and past decisions to provide richer context
+      - Always gracefully degrade: if external tools are unavailable, proceed with local context only — never block the review
+      - When a PM MCP is available, extract issue key from branch name and fetch acceptance criteria to use as review checklist
 
   critical_actions:
-    - "Run [CP] Collect Project Context ONCE before the first review of a new project"
+    - "Context is collected AUTOMATICALLY after Describe PR — no manual context collection needed"
     - "Run [SP] Select PR FIRST before any review — never review without knowing the exact branch/diff"
     - "After Select PR, suggest running [DP] Describe PR to understand scope before diving into review"
+    - "Context collection happens automatically after DP — it's always fresh and PR-specific"
     - "Track completed reviews and remind user of remaining uncompleted review types"
     - "For PRs touching auth, API keys, or user data: always suggest [SR] Security Review"
+    - "For feature PRs and PRs with data migration: always run [BR] Business Review to assess user impact and deployment risk"
+    - "Business Review runs LAST in the pipeline — it synthesizes technical findings into business language"
 
   menu:
     - trigger: "QR or fuzzy match on quick"
       exec: "{project-root}/_prr/prr/workflows/quick/workflow.md"
-      description: "[QR] Quick Review: Full pipeline in one command — select branch → describe → all reviews → report"
-
-    - trigger: "CP or fuzzy match on collect-project-context"
-      exec: "{project-root}/_prr/prr/workflows/0-setup/collect-project-context/workflow.md"
-      description: "[CP] Collect Project Context: Scan configs, extract rules, ask domain — run once per project"
+      description: "[QR] Quick Review: Full pipeline — select → describe → collect context → review → report"
 
     - trigger: "SP or fuzzy match on select-pr"
       exec: "{project-root}/_prr/prr/workflows/1-discover/select-pr/workflow.md"
@@ -59,6 +62,10 @@ agent:
       workflow: "{project-root}/_prr/prr/workflows/3-review/architecture-review/workflow.yaml"
       description: "[AR] Architecture Review: SOLID, layering, coupling, consistency with codebase"
 
+    - trigger: "BR or fuzzy match on business-review"
+      workflow: "{project-root}/_prr/prr/workflows/3-review/business-review/workflow.yaml"
+      description: "[BR] Business Review: User impact, business risk, feature completeness, data safety, observability"
+
     - trigger: "IC or fuzzy match on improve-code"
       workflow: "{project-root}/_prr/prr/workflows/4-improve/improve-code/workflow.yaml"
       description: "[IC] Improve Code: Concrete inline code suggestions with before/after fixes"
@@ -78,3 +85,7 @@ agent:
     - trigger: "HH or fuzzy match on help"
       exec: "{project-root}/_prr/core/tasks/help.md"
       description: "[HH] Help: Show review workflow guide and available commands"
+
+    - trigger: "CL or fuzzy match on clear or clean or reset"
+      exec: "{project-root}/_prr/core/tasks/clear.md"
+      description: "[CL] Clear: Remove context files and/or review reports from output folder"

package/src/core/tasks/clear.md

@@ -0,0 +1,140 @@
+# Clear PRR Output
+
+**Goal:** Remove prr-kit context files and/or review reports from the output folder. Useful when starting fresh, switching projects, or cleaning up after a review session.
+
+## EXECUTION
+
+### 1. Load Config
+
+Read `{project-root}/_prr/prr/config.yaml` to get `review_output` path.
+
+### 2. Scan Output Folder
+
+List all files currently in `{review_output}`:
+
+```bash
+ls "{review_output}/"
+```
+
+Group into three categories:
+
+**Context files** (session state + knowledge bases):
+- `current-pr-context.yaml` — active session state (which PR is selected)
+- `pr-*-context.yaml` — per-PR knowledge bases built during context collection
+
+**Intermediate review files** (individual review output, used by [RR] and [PC]):
+- `general-review-*.md`
+- `security-review-*.md`
+- `performance-review-*.md`
+- `architecture-review-*.md`
+- `business-review-*.md`
+- `improve-code-*.md`
+- `pr-description-*.md`
+
+**Review reports** (final compiled reports):
+- `review-*.md` — final review reports generated by [RR]
+
+### 3. Display What Exists
+
+Show the user exactly what will be affected:
+
+```
+🗂️ PRR Output — {review_output}
+
+Context files ({n}):
+  • current-pr-context.yaml
+  • pr-feature-auth-...-context.yaml
+  • pr-feature-search-...-context.yaml
+  ... (list all pr-*.yaml)
+
+Intermediate review files ({k}):
+  • general-review-2026-02-21.md
+  • security-review-2026-02-21.md
+  • pr-description-2026-02-21.md
+  ... (list all intermediate review files)
+
+Review reports ({m}):
+  • review-feature-auth-indexeddb-migration-2026-02-21.md
+  • review-feature-add-search-functionality-2026-02-21.md
+  ... (list all review-*.md)
+```
+
+If output folder is already empty or doesn't exist:
+```
+✅ Nothing to clear — output folder is already empty.
+```
+Then stop.
+
+### 4. Ask Scope
+
+Ask the user what to clear:
+
+```
+What would you like to clear?
+
+  [1] All          — context files + intermediate review files + review reports
+  [2] Context only — clear session state and knowledge bases (keep reports)
+  [3] Reports only — clear intermediate review files + final review reports (keep context)
+  [4] Cancel       — do nothing
+```
+
+Wait for user input.
+
+### 5. Execute Deletion
+
+**If [1] All:**
+```bash
+rm -f "{review_output}/current-pr-context.yaml"
+rm -f "{review_output}"/pr-*-context.yaml
+rm -f "{review_output}"/general-review-*.md
+rm -f "{review_output}"/security-review-*.md
+rm -f "{review_output}"/performance-review-*.md
+rm -f "{review_output}"/architecture-review-*.md
+rm -f "{review_output}"/business-review-*.md
+rm -f "{review_output}"/improve-code-*.md
+rm -f "{review_output}"/pr-description-*.md
+rm -f "{review_output}"/review-*.md
+```
+
+**If [2] Context only:**
+```bash
+rm -f "{review_output}/current-pr-context.yaml"
+rm -f "{review_output}"/pr-*-context.yaml
+```
+
+**If [3] Reports only:**
+```bash
+rm -f "{review_output}"/general-review-*.md
+rm -f "{review_output}"/security-review-*.md
+rm -f "{review_output}"/performance-review-*.md
+rm -f "{review_output}"/architecture-review-*.md
+rm -f "{review_output}"/business-review-*.md
+rm -f "{review_output}"/improve-code-*.md
+rm -f "{review_output}"/pr-description-*.md
+rm -f "{review_output}"/review-*.md
+```
+
+**If [4] Cancel:**
+```
+❌ Cancelled — nothing was deleted.
+```
+Stop.
+
+### 6. Confirm Deletion
+
+Verify files are gone and report:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Clear complete
+
+Deleted:
+  🗑️  Context files: {n_ctx} file(s) removed
+  🗑️  Review reports: {n_rpt} file(s) removed
+
+Output folder: {review_output}
+Status: clean
+
+Ready for a fresh review session.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```