legendai 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Akash Munshi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# Legend
+
+> Autonomous agent pipeline — type `legend` in any repo.
+
+Legend watches a Slack channel for Linear issue links, then runs a 6-stage AI agent pipeline to analyze, plan, implement, review, and ship code — fully autonomously.
+
+## How It Works
+
+```
+Slack message with Linear issue URL
+        ↓
+   ┌─────────┐
+   │ Analyze  │  Read-only codebase scan
+   └────┬─────┘
+        ↓
+   ┌─────────┐
+   │  Plan    │  Write implementation plan
+   └────┬─────┘
+        ↓
+   ┌──────────────┐
+   │ Review Plan   │  Approve or revise (loops)
+   └────┬──────────┘
+        ↓
+   ┌─────────┐
+   │ Develop  │  Implement in worktree, push PR
+   └────┬─────┘
+        ↓
+   ┌──────────────┐
+   │ Code Review   │  Test + lint + review (loops)
+   └────┬──────────┘
+        ↓
+   ┌───────────┐
+   │ Close Out  │  Reply in Slack, comment on Linear
+   └────────────┘
+```
+
+## Prerequisites
+
+Legend requires the following tools installed and authenticated on your system:
+
+| Tool | Install | Purpose |
+|------|---------|---------|
+| **Node.js ≥ 18** | [nodejs.org](https://nodejs.org/) | Runtime |
+| **Claude Code CLI** | `npm install -g @anthropic-ai/claude-code` | AI agent engine |
+| **GitHub CLI (`gh`)** | [cli.github.com](https://cli.github.com/) | PR creation & reviews |
+| **Git** | Comes with most systems | Version control |
+
+You also need:
+- A **Slack workspace** with a bot token (Socket Mode)
+- A **Linear** API key
+- A **Gemini** API key (for plan review)
+
+## Installation
+
+```bash
+npm install -g legend-cli
+```
+
+Or try it without installing:
+
+```bash
+npx legend-cli
+```
+
+## Quick Start
+
+### 1. Set up in your project
+
+```bash
+cd your-project
+legend setup
+```
+
+The interactive wizard will walk you through connecting Slack, Linear, GitHub, and configuring your repos.
+
+### 2. Start watching
+
+```bash
+legend
+```
+
+Legend will watch your configured Slack channel. When someone posts a Linear issue link, the pipeline starts automatically.
+
+### 3. That's it
+
+Legend will:
+- Analyze the codebase to understand context
+- Write an implementation plan
+- Self-review the plan (with configurable review cycles)
+- Implement the changes in a separate git worktree
+- Create a pull request
+- Run tests, lint, and build — fixing issues automatically
+- Submit a GitHub PR review
+- Reply in Slack and comment on the Linear issue
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `legend` | Start the pipeline (watches Slack) |
+| `legend setup` | Run the interactive setup wizard |
+| `legend status` | Show current pipeline status |
+| `legend runs` | List past pipeline runs |
+| `legend config` | Display current configuration |
+| `legend reset` | Clear config and re-setup |
+
+### Flags
+
+| Flag | Description |
+|------|-------------|
+| `--verbose` | Show full Claude Code turn-by-turn output |
+| `--quiet` | Suppress all logs except errors and the dashboard |
+
+## Configuration
+
+Config is stored in `.legend/config.json` (gitignored) in your project root. It includes:
+
+- **Workspace** — project name
+- **Repos** — one or more repos with base branch, test/build/lint commands
+- **Linear** — API key, team ID
+- **Slack** — bot token, app token, channel
+- **GitHub** — authenticated user
+- **Gemini** — API key for plan review
+- **Claude** — model selection
+- **Pipeline** — max review cycles, concurrency
+
+## Multi-Repo Support
+
+Legend supports mono-repos and multi-repo workspaces. During setup, it auto-discovers git repos in your working directory and lets you configure each one independently.
+
+## Architecture
+
+```
+bin/legend.ts              — CLI entry point (Commander)
+src/cli/                   — Setup wizard, dashboard, sub-commands
+src/config/                — Config schema and store
+src/agents/runner.ts       — Claude Code subprocess invocation
+src/agents/prompts/*.md    — Per-stage prompt templates
+src/pipeline/              — Orchestrator state machine, worktree, queue
+src/integrations/          — Slack, Linear, GitHub API clients
+src/utils/                 — Logger, pre-flight checks, theme
+```
+
+### Pipeline Artifacts
+
+Each run persists artifacts to `.legend/runs/<ISSUE-ID>/`:
+- `analysis.md` — codebase analysis
+- `plan.md` — implementation plan
+- `review.md` — plan review feedback
+- `code-review.md` — code review feedback
+
+## Development
+
+```bash
+git clone https://github.com/akashmunshi/legend-cli.git
+cd legend-cli
+npm install
+npm run dev        # Run with tsx (no compile step)
+npm run build      # Compile to dist/
+npm link           # Make `legend` available globally for testing
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Built by [Akash Munshi](mailto:akash@trysudosu.com)

package/dist/bin/legend.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=legend.d.ts.map

package/dist/bin/legend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend.d.ts","sourceRoot":"","sources":["../../bin/legend.ts"],"names":[],"mappings":""}

package/dist/bin/legend.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import ora from "ora";
+import { runPreflightChecks } from "../src/utils/checks.js";
+import { configExists, loadConfig } from "../src/config/store.js";
+import { runSetupWizard } from "../src/cli/setup.js";
+import { startPipeline } from "../src/pipeline/orchestrator.js";
+import { log } from "../src/utils/logger.js";
+import { t } from "../src/utils/theme.js";
+import { showStatus, listRuns, showConfig, resetConfig } from "../src/cli/commands.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Works from both bin/ (dev) and dist/bin/ (compiled)
+function findPkg() {
+    for (const rel of ["..", "../.."]) {
+        try {
+            return JSON.parse(readFileSync(path.join(__dirname, rel, "package.json"), "utf-8"));
+        }
+        catch { }
+    }
+    throw new Error("package.json not found");
+}
+const pkg = findPkg();
+const BANNER = `
+   █████       ██████████   █████████  ██████████ ██████   █████ ██████████  
+ ░░███       ░░███░░░░░█  ███░░░░░███░░███░░░░░█░░██████ ░░███ ░░███░░░░███ 
+  ░███        ░███  █ ░  ███     ░░░  ░███  █ ░  ░███░███ ░███  ░███   ░░███
+  ░███        ░██████   ░███          ░██████    ░███░░███░███  ░███    ░███
+  ░███        ░███░░█   ░███    █████ ░███░░█    ░███ ░░██████  ░███    ░███
+  ░███      █ ░███ ░   █░░███  ░░███  ░███ ░   █ ░███  ░░█████  ░███    ███ 
+  ███████████ ██████████ ░░█████████  ██████████ █████  ░░█████ ██████████  
+ ░░░░░░░░░░░ ░░░░░░░░░░   ░░░░░░░░░  ░░░░░░░░░░ ░░░░░    ░░░░░ ░░░░░░░░░░   
+`;
+function printBanner(config) {
+    // ASCII art in brand yellow
+    for (const line of BANNER.split("\n")) {
+        if (line.trim())
+            console.log(t.brand(line));
+    }
+    console.log(t.dim(`${" ".repeat(72)}v${pkg.version}`));
+    console.log();
+    console.log(t.fg("  Autonomous Agent Pipeline"));
+    console.log(t.dim("  Built by Akash · akash@trysudosu.com"));
+    console.log();
+    if (config) {
+        const repoNames = config.repos.map(r => r.name).join(", ");
+        const rows = [
+            ["Project", config.workspace.name],
+            ["Repos", repoNames],
+            ["Channel", `#${config.slack.channelName}`],
+            ["Model", config.claude.model],
+        ];
+        for (const [key, value] of rows) {
+            console.log(`  ${t.dim(key.padEnd(10))}${t.green(value)}`);
+        }
+        console.log();
+    }
+}
+function printPreflightResults(checks) {
+    if (!checks.passed) {
+        console.log(`  ${t.error("✖ Preflight failed")}`);
+        console.log();
+        // Show failures
+        const failures = Object.entries(checks.details).filter(([, v]) => !v.found);
+        if (failures.length > 0) {
+            console.log(t.dim("    Missing:"));
+            for (const msg of checks.missing) {
+                // Split "X not found. Install via: Y" into name and instruction
+                const dotIdx = msg.indexOf(".");
+                const name = dotIdx >= 0 ? msg.slice(0, dotIdx) : msg;
+                const instruction = dotIdx >= 0 ? msg.slice(dotIdx + 1).trim() : "";
+                console.log(`      ${t.red("•")} ${name}${instruction ? t.dim(` — ${instruction}`) : ""}`);
+            }
+            console.log();
+        }
+        // Show successes
+        const successes = Object.entries(checks.details).filter(([, v]) => v.found);
+        if (successes.length > 0) {
+            console.log(t.dim("    Found:"));
+            for (const [name, detail] of successes) {
+                const version = detail.version ? ` ${detail.version}` : "";
+                console.log(`      ${t.success("✓")} ${name}${t.dim(version)}`);
+            }
+            console.log();
+        }
+    }
+}
+const program = new Command();
+program
+    .name("legend")
+    .description("Autonomous agent pipeline for your codebase")
+    .version(pkg.version);
+// Default command — just `legend`
+program
+    .option("--verbose", "Show full Claude Code turn-by-turn output")
+    .option("--quiet", "Suppress all logs except errors and the dashboard")
+    .action(async (options) => {
+    const checks = await runPreflightChecks();
+    const repoRoot = process.cwd();
+    const hasConfig = configExists(repoRoot);
+    // Print banner (with config info if available)
+    if (hasConfig) {
+        const config = loadConfig(repoRoot);
+        printBanner(config);
+    }
+    else {
+        printBanner();
+    }
+    if (!checks.passed) {
+        printPreflightResults(checks);
+        process.exit(1);
+    }
+    if (!hasConfig) {
+        console.log(t.dim("  First time here? Let's set you up.\n"));
+        await runSetupWizard(repoRoot);
+    }
+    const config = loadConfig(repoRoot);
+    log.init(repoRoot);
+    log.verbose = !!options.verbose;
+    log.quiet = !!options.quiet;
+    // Show idle spinner while watching
+    const spinner = ora({
+        text: t.dim(`Watching #${config.slack.channelName} for Linear issues...`),
+        prefixText: " ",
+        color: "yellow",
+    }).start();
+    try {
+        await startPipeline(config, repoRoot, !!options.verbose);
+    }
+    finally {
+        spinner.stop();
+    }
+});
+program
+    .command("setup")
+    .description("Re-run the setup wizard")
+    .action(async () => {
+    printBanner();
+    await runSetupWizard(process.cwd());
+});
+program
+    .command("status")
+    .description("Show current pipeline status")
+    .action(() => showStatus(process.cwd()));
+program
+    .command("runs")
+    .description("List past pipeline runs")
+    .action(() => listRuns(process.cwd()));
+program
+    .command("config")
+    .description("Show current config")
+    .action(() => showConfig(process.cwd()));
+program
+    .command("reset")
+    .description("Clear config and re-setup")
+    .action(async () => resetConfig(process.cwd()));
+program.parse();
+//# sourceMappingURL=legend.js.map

package/dist/bin/legend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend.js","sourceRoot":"","sources":["../../bin/legend.ts"],"names":[],"mappings":"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"}

package/dist/bin/postinstall.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Post-install message — printed after `npm install -g legend-cli`.
+ * This is a courtesy message, not a hard gate. The real preflight
+ * check happens when the user runs `legend` or `legend setup`.
+ */
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/bin/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../../bin/postinstall.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/bin/postinstall.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * Post-install message — printed after `npm install -g legend-cli`.
+ * This is a courtesy message, not a hard gate. The real preflight
+ * check happens when the user runs `legend` or `legend setup`.
+ */
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const YELLOW = "\x1b[33m";
+const GREEN = "\x1b[32m";
+const CYAN = "\x1b[36m";
+console.log();
+console.log(`  ${YELLOW}${BOLD}Legend${RESET} installed successfully.`);
+console.log();
+console.log(`  ${DIM}Before running, make sure you have:${RESET}`);
+console.log(`    ${GREEN}•${RESET} Claude Code CLI  ${DIM}— npm i -g @anthropic-ai/claude-code${RESET}`);
+console.log(`    ${GREEN}•${RESET} GitHub CLI (gh)   ${DIM}— https://cli.github.com/${RESET}`);
+console.log(`    ${GREEN}•${RESET} Node.js ≥ 18      ${DIM}— https://nodejs.org/${RESET}`);
+console.log();
+console.log(`  ${CYAN}Get started:${RESET}  cd your-project && legend setup`);
+console.log();
+export {};
+//# sourceMappingURL=postinstall.js.map

package/dist/bin/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../../bin/postinstall.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,IAAI,GAAG,SAAS,CAAC;AACvB,MAAM,GAAG,GAAG,SAAS,CAAC;AACtB,MAAM,MAAM,GAAG,UAAU,CAAC;AAC1B,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,IAAI,GAAG,UAAU,CAAC;AAExB,OAAO,CAAC,GAAG,EAAE,CAAC;AACd,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,GAAG,IAAI,SAAS,KAAK,0BAA0B,CAAC,CAAC;AACxE,OAAO,CAAC,GAAG,EAAE,CAAC;AACd,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,sCAAsC,KAAK,EAAE,CAAC,CAAC;AACnE,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,KAAK,qBAAqB,GAAG,uCAAuC,KAAK,EAAE,CAAC,CAAC;AACzG,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,KAAK,sBAAsB,GAAG,4BAA4B,KAAK,EAAE,CAAC,CAAC;AAC/F,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,KAAK,sBAAsB,GAAG,wBAAwB,KAAK,EAAE,CAAC,CAAC;AAC3F,OAAO,CAAC,GAAG,EAAE,CAAC;AACd,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,eAAe,KAAK,mCAAmC,CAAC,CAAC;AAC9E,OAAO,CAAC,GAAG,EAAE,CAAC"}

package/dist/src/agents/prompts/analyzer.md

@@ -0,0 +1,54 @@
+# Codebase Analyzer
+
+You are a codebase analyst. Your job is to analyze the repository to understand how to implement the given Linear issue.
+
+## Issue
+- **ID**: {{issueId}}
+- **Title**: {{issueTitle}}
+- **Description**: {{issueDescription}}
+- **Labels**: {{issueLabels}}
+
+## Workspace Repositories
+
+{{repoList}}
+
+## Image Descriptions
+
+The following images were found in the issue and analyzed:
+
+{{imageDescriptions}}
+
+## File Attachments
+
+{{attachmentPaths}}
+
+## Instructions
+
+1. Explore the codebase structure to understand the project layout, tech stack, and patterns
+2. If multiple repositories are listed above, explore each to understand how they relate to the issue
+3. Identify the files and modules most relevant to this issue
+4. Understand existing patterns, naming conventions, and architectural decisions
+5. Identify dependencies and potential risks for implementing this issue
+6. Determine the issue type (UI, API, infrastructure, refactoring, bug fix, etc.)
+
+## Output
+
+Respond with your analysis containing these sections:
+
+- **Summary**: One-paragraph overview of what needs to be done
+- **Issue Type**: UI / API / Infrastructure / Refactoring / Bug Fix
+- **Target Repos**: Which repository/repositories need changes and why (list each by name)
+- **Relevant Files**: List of files that will need to be read or modified, with brief explanation of each
+- **Existing Patterns**: Key patterns in the codebase that the implementation should follow
+- **Dependencies**: External or internal dependencies that affect this work
+- **Risks**: Potential issues or edge cases to watch for
+- **Estimated Complexity**: Low / Medium / High with brief justification
+
+Do NOT make any code changes. You are read-only.
+
+## Constraints
+
+- Your text response IS the output. The pipeline saves it automatically. Do NOT create or write files.
+- Do NOT read, glob, or reference anything inside `.claude/`, `.legend/`, or `node_modules/` directories.
+- Only analyze issue **{{issueId}}**. Ignore any other issue IDs you encounter in the codebase.
+- Focus only on the project source code.

package/dist/src/agents/prompts/code-reviewer.md

@@ -0,0 +1,72 @@
+# Code Reviewer & Tester
+
+You are a code reviewer and test runner. Your job is to review the PR changes and run tests to verify correctness.
+
+## Issue
+- **ID**: {{issueId}}
+- **Title**: {{issueTitle}}
+
+## Repository
+
+You are reviewing the **{{repoName}}** repository.
+
+## Implementation Plan
+
+{{planContent}}
+
+## PR URL
+
+{{prUrl}}
+
+## Commands
+- **Test**: `{{testCommand}}`
+- **Build**: `{{buildCommand}}`
+- **Lint**: `{{lintCommand}}`
+
+## Instructions
+
+### Step 1: Run Tests & Build
+
+1. Run the test command: `{{testCommand}}`
+2. Run the build command: `{{buildCommand}}`
+3. Run the lint command (if configured): `{{lintCommand}}`
+4. Capture all output — note any failures, warnings, or errors
+
+### Step 2: Review the Code
+
+1. Get the PR diff: `gh pr diff {{prUrl}}`
+2. Review every changed file against the implementation plan
+3. Check for:
+   - **Correctness**: Does the code do what the plan says?
+   - **Edge cases**: Are error conditions handled?
+   - **Code quality**: Is it consistent with existing patterns?
+   - **Test coverage**: Are the changes adequately tested?
+   - **Scope**: Are there any unrelated changes?
+   - **Security**: Are there any obvious security issues?
+
+### Step 3: Submit Review
+
+Based on your findings, submit a review on the PR:
+
+- If tests pass AND code looks good:
+  `gh pr review {{prUrl}} --approve --body "<summary of review>"`
+  
+- If tests fail OR code needs changes:
+  `gh pr review {{prUrl}} --request-changes --body "<detailed feedback>"`
+
+### Step 4: Save Review Locally
+
+Respond with your full review containing:
+
+- **Verdict**: `APPROVED` or `CHANGES_REQUESTED` (first line)
+- **Test Results**: Pass/fail summary with relevant output
+- **Build Results**: Pass/fail
+- **Lint Results**: Pass/fail (if applicable)
+- **Code Review**: Detailed feedback on the changes
+- **Action Items** (if CHANGES_REQUESTED): Numbered list of specific things to fix
+
+## Constraints
+
+- Your text response IS the output. The pipeline saves it automatically.
+- Do NOT read, glob, or reference anything inside `.claude/`, `.legend/`, or `node_modules/` directories.
+- Only review changes for issue **{{issueId}}**. Ignore any other issue IDs you encounter in the codebase.

package/dist/src/agents/prompts/developer.md

@@ -0,0 +1,67 @@
+# Developer
+
+You are a developer agent. Your job is to implement code changes according to the plan.
+
+## Issue
+- **ID**: {{issueId}}
+- **Title**: {{issueTitle}}
+
+## Repository
+
+You are working in the **{{repoName}}** repository.
+
+## Implementation Plan
+
+{{planContent}}
+
+## Working Directory
+
+You are working in a git worktree at: `{{worktreePath}}`
+Branch: `{{branchName}}`
+
+## Build & Lint Commands
+- **Build**: `{{buildCommand}}`
+- **Lint**: `{{lintCommand}}`
+
+## Image Descriptions
+
+The following images were found in the issue and analyzed:
+
+{{imageDescriptions}}
+
+## File Attachments
+
+The following files were downloaded from the issue. You can read and process these files directly.
+
+{{attachmentPaths}}
+
+## Instructions
+
+1. Follow the implementation plan step by step
+2. Implement all changes as specified
+3. Run the build command to verify compilation
+4. Run the lint command (if configured) to verify code style
+5. Commit your changes with a descriptive message: `feat({{issueId}}): <description>`
+6. Push the branch: `git push origin {{branchName}}`
+
+{{#if reviewFeedback}}
+## Review Feedback to Address
+
+{{reviewFeedback}}
+
+Address each piece of feedback. Make the requested changes, then commit and push.
+{{/if}}
+
+## Rules
+
+- Follow existing code patterns and conventions in the repository
+- Do not make changes outside the scope of the plan
+- Write clean, well-structured code
+- If the build fails, fix the errors before committing
+- Each commit should be atomic and well-described
+
+## Constraints
+
+- Do NOT read, glob, or reference anything inside `.claude/`, `.legend/`, or `node_modules/` directories.
+- Only implement changes for issue **{{issueId}}**. Ignore any other issue IDs you encounter in the codebase.
+- Do NOT create files in `.claude/` — all your work goes in the source code as specified by the plan.

package/dist/src/agents/prompts/plan-reviewer.md

@@ -0,0 +1,43 @@
+# Plan Reviewer
+
+You are a plan reviewer. Your job is to critically evaluate the implementation plan against the issue requirements and the actual codebase.
+
+## Issue
+- **ID**: {{issueId}}
+- **Title**: {{issueTitle}}
+
+## Analysis
+
+{{analysisContent}}
+
+## Instructions
+
+1. Read the implementation plan from `{{planPath}}`
+2. Validate the plan against the codebase — verify that:
+   - Referenced files actually exist (or are correctly marked as new)
+   - Function signatures and APIs mentioned in the plan match reality
+   - The approach is consistent with existing codebase patterns
+3. Check for completeness:
+   - All requirements from the issue are addressed
+   - Edge cases are considered
+   - Test strategy is adequate
+4. Check for risks:
+   - Are there unnecessary changes that could break existing functionality?
+   - Is the scope appropriate (not too broad, not too narrow)?
+
+## Output
+
+Respond with your review containing:
+
+- **Verdict**: `APPROVED` or `CHANGES_REQUESTED` (must be the first line)
+- **Summary**: Overall assessment (2-3 sentences)
+- **Issues Found** (if CHANGES_REQUESTED): Numbered list of specific problems
+- **Suggestions**: Optional improvements that aren't blocking
+
+If the plan is solid and addresses the requirements correctly, approve it. Only request changes for real problems — missing requirements, incorrect file references, or approaches that would break existing functionality.
+
+## Constraints
+
+- Your text response IS the output. The pipeline saves it automatically. Do NOT create or write files.
+- Do NOT read, glob, or reference anything inside `.claude/`, `.legend/`, or `node_modules/` directories (except the plan file at `{{planPath}}`).
+- Only review the plan for issue **{{issueId}}**. Ignore any other issue IDs you encounter in the codebase.