mustard-claude 3.0.11 → 3.0.12

package/README.md

@@ -26,10 +26,10 @@
 
 Mustard sets up a `.claude/` folder that turns Claude Code into a structured development pipeline:
 
-- **14 pipeline skills** — feature, bugfix, scan, resume, approve, complete, git, maint, task, knowledge, skill, status, scan-format, agent-prompt template
-- **9 enforcement hooks** — bash safety, file guard, registry validation, guard verification, auto-format, pre-compact, session cleanup, subagent tracking, RTK rewrite
+- **15 pipeline skills** — feature, bugfix, scan, resume, approve, complete, git, maint, task, knowledge, skill, status, scan-format, agent-prompt template, stats
+- **12 enforcement hooks** — bash safety, file guard, registry validation, guard verification, auto-format, pre-compact, session cleanup, subagent tracking, RTK rewrite, session memory, review gate, metrics tracker
 - **6 bundled skills** — design-craft, react-best-practices, senior-architect, skill-creator, commit-workflow, pipeline-execution
-- **3 sync scripts** — subproject detection, entity registry sync, statusline
+- **8 utility scripts** — subproject detection, entity registry sync, statusline, memory persistence, diff context, knowledge base, metrics collection
 - **Token economy** — auto-installs [RTK](https://github.com/rtk-ai/rtk) to reduce token consumption by 60-90% on CLI outputs
 - **Monorepo + single repo** — works with any project structure
 
@@ -101,6 +101,8 @@ The CLI is a **one-time setup tool**. All intelligence lives in the skills and h
 | `mustard init` | Copy `.claude/` structure into current project |
 | `mustard update` | Update core files (preserves user customizations) |
 | `mustard auto-update` | Check npm for newer version and install |
+| `mustard add <template>` | Install a community template |
+| `mustard review --pr <N>` | Review a pull request (local or CI mode) |
 | `mustard --version` | Show installed version |
 | `mustard --help` | Show help |
 
@@ -144,6 +146,40 @@ The CLI is a **one-time setup tool**. All intelligence lives in the skills and h
 | `--check-only` | Only check for updates, do not install |
 | `-y, --yes` | Skip confirmation prompts |
 
+### `mustard add`
+
+| Option | Description |
+|--------|-------------|
+| `-f, --force` | Overwrite existing files |
+
+**Sources:**
+- GitHub: `github.com/mustard-templates/{name}`
+- npm: `mustard-template-{name}`
+
+**Usage:**
+```bash
+mustard add template:dotnet-clean-arch
+mustard add template:nextjs-app-router
+```
+
+### `mustard review`
+
+| Option | Description |
+|--------|-------------|
+| `--pr <number>` | PR number to review (required) |
+| `--ci` | CI mode: post as PR comment, exit 1 on critical issues |
+
+**Requirements:** `gh` (GitHub CLI) and `claude` CLI must be installed.
+
+**Usage:**
+```bash
+# Interactive review
+mustard review --pr 42
+
+# CI mode (for GitHub Actions)
+mustard review --ci --pr 42
+```
+
 ## What Gets Installed
 
 ```
@@ -166,6 +202,7 @@ The CLI is a **one-time setup tool**. All intelligence lives in the skills and h
 │   ├── knowledge/SKILL.md             #   /knowledge — notes, audit, reports
 │   ├── skill/SKILL.md                 #   /skill — manage skills
 │   ├── status/SKILL.md                #   /status — project status
+│   ├── stats/SKILL.md                 #   /stats — pipeline metrics
 │   └── templates/agent-prompt/SKILL.md #  Agent prompt template
 ├── hooks/                             # Enforcement hooks
 │   ├── rtk-rewrite.js                 #   Rewrites Bash commands through RTK
@@ -177,11 +214,24 @@ The CLI is a **one-time setup tool**. All intelligence lives in the skills and h
 │   ├── pre-compact.js                 #   Saves state before compaction
 │   ├── session-cleanup.js             #   Cleans up on session end
 │   ├── subagent-tracker.js            #   Tracks agent lifecycle
+│   ├── session-memory.js              #   Injects persistent memory on session start
+│   ├── review-gate.js                 #   Pre-commit validation (fail-open)
+│   ├── metrics-tracker.js             #   Tracks pipeline API calls and retries
 │   └── __tests__/hooks.test.js        #   Hook tests
 ├── scripts/
 │   ├── sync-detect.js                 #   Detects subprojects + roles
 │   ├── sync-registry.js               #   Generates entity-registry.json
-│   └── statusline.js                  #   Claude Code statusline
+│   ├── statusline.js                  #   Claude Code statusline
+│   ├── memory-persist.js              #   Persists decisions/lessons across sessions
+│   ├── memory-write.js                #   Writes agent memory entries
+│   ├── diff-context.js                #   Generates git diff summary for agents
+│   ├── knowledge-update.js            #   Updates project knowledge base
+│   └── metrics-collect.js             #   Collects and displays pipeline metrics
+├── memory/                            # Persistent memory (auto-created)
+│   ├── decisions.json                 #   Decisions across pipelines
+│   └── lessons.json                   #   Lessons learned
+├── knowledge.json                     # Evolutionary knowledge base
+├── metrics/                           # Pipeline metrics archive
 └── skills/                            # Bundled skills
     ├── design-craft/                  #   UI design methodology
     ├── react-best-practices/          #   React/Next.js optimization (40+ rules)
@@ -203,6 +253,7 @@ The CLI is a **one-time setup tool**. All intelligence lives in the skills and h
 | `/approve` | Approve spec for implementation |
 | `/resume` | Resume interrupted pipeline |
 | `/complete` | Finalize or cancel pipeline |
+| `/stats` | Show pipeline metrics and token savings |
 
 ### Operations
 
@@ -269,7 +320,7 @@ After `/scan`, the pipeline commands (`/feature`, `/bugfix`) have full context t
   PLAN — create spec with tasks per agent (Light: inline, Full: /approve)
      │
      ▼
-  EXECUTE — dispatch agents per wave (DB+Backend ∥, Frontend after)
+  EXECUTE — dispatch agents per wave (DB+Backend ∥, Frontend after or parallel if safe)
      │
      ▼
   REVIEW — mandatory review per subproject (SOLID, patterns, i18n, ...)
@@ -301,6 +352,38 @@ Mustard integrates [RTK (Rust Token Killer)](https://github.com/rtk-ai/rtk) as c
 
 RTK only applies to Bash tool calls. Claude Code's built-in tools (Read, Grep, Glob) are already optimized and bypass the hook.
 
+## Persistent Memory
+
+Mustard maintains lightweight persistent memory across sessions:
+
+- **Decisions** — architectural and implementation decisions are saved to `.claude/memory/decisions.json`
+- **Lessons** — what went wrong and the correction applied, saved to `.claude/memory/lessons.json`
+- **Knowledge base** — patterns, conventions, and entities discovered across pipelines, saved to `.claude/knowledge.json`
+
+Memory is automatically:
+- **Injected** into each new session and every dispatched agent
+- **Capped** at 50 entries (memory) / 200 entries (knowledge) — oldest pruned
+- **Never cleaned** by session cleanup — persists until manually removed
+
+This gives 80% of the benefit of a database-backed system with zero infrastructure.
+
+## CI Integration
+
+Review PRs automatically in your CI pipeline:
+
+```bash
+# In GitHub Actions
+mustard review --ci --pr ${{ github.event.pull_request.number }}
+```
+
+CI mode:
+- Fetches PR diff via `gh pr diff`
+- Runs Claude review with project guards and rules
+- Posts review as PR comment
+- Exits with code 1 if CRITICAL issues found (fails the build)
+
+Requires `gh` and `claude` CLI in the CI environment.
+
 ## Supported Projects
 
 Mustard is **framework-agnostic**. The CLI just copies templates. `/scan` handles detection:

package/dist/cli.js

@@ -3,6 +3,8 @@ import { createRequire } from 'node:module';
 import { initCommand } from './commands/init.js';
 import { updateCommand } from './commands/update.js';
 import { autoUpdateCommand } from './commands/auto-update.js';
+import { addCommand } from './commands/add.js';
+import { reviewCommand } from './commands/review.js';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
 export function run() {
@@ -28,6 +30,17 @@ export function run() {
         .option('--check-only', 'Only check for updates, do not install')
         .option('-y, --yes', 'Skip confirmation prompts')
         .action(autoUpdateCommand);
+    program
+        .command('add <template>')
+        .description('Install a community template (e.g., mustard add template:dotnet-clean-arch)')
+        .option('-f, --force', 'Overwrite existing files')
+        .action(addCommand);
+    program
+        .command('review')
+        .description('Review a pull request (local or CI mode)')
+        .option('--ci', 'CI mode: post review as PR comment, exit 1 on critical issues')
+        .option('--pr <number>', 'PR number to review')
+        .action(reviewCommand);
     program.parse();
 }
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE/C,MAAM,UAAU,GAAG;IACjB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,WAAW,CAAC,sDAAsD,CAAC;SACnE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CAAC,aAAa,EAAE,sDAAsD,CAAC;SAC7E,MAAM,CAAC,WAAW,EAAE,2BAA2B,CAAC;SAChD,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvB,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,aAAa,EAAE,8BAA8B,CAAC;SACrD,MAAM,CAAC,aAAa,CAAC,CAAC;IAEzB,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,cAAc,EAAE,wCAAwC,CAAC;SAChE,MAAM,CAAC,WAAW,EAAE,2BAA2B,CAAC;SAChD,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAE7B,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE/C,MAAM,UAAU,GAAG;IACjB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,WAAW,CAAC,sDAAsD,CAAC;SACnE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CAAC,aAAa,EAAE,sDAAsD,CAAC;SAC7E,MAAM,CAAC,WAAW,EAAE,2BAA2B,CAAC;SAChD,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvB,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,aAAa,EAAE,8BAA8B,CAAC;SACrD,MAAM,CAAC,aAAa,CAAC,CAAC;IAEzB,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,cAAc,EAAE,wCAAwC,CAAC;SAChE,MAAM,CAAC,WAAW,EAAE,2BAA2B,CAAC;SAChD,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAE7B,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,6EAA6E,CAAC;SAC1F,MAAM,CAAC,aAAa,EAAE,0BAA0B,CAAC;SACjD,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtB,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,MAAM,EAAE,+DAA+D,CAAC;SAC/E,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;SAC9C,MAAM,CAAC,aAAa,CAAC,CAAC;IAEzB,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/commands/add.d.ts

@@ -0,0 +1,8 @@
+export interface AddOptions {
+    force?: boolean;
+}
+/**
+ * Add command - installs a community template into the current project's .claude/ directory.
+ * Sources: GitHub (mustard-templates/{name}) or npm (mustard-template-{name}).
+ */
+export declare function addCommand(templateSpec: string, options: AddOptions): Promise<void>;

package/dist/commands/add.js

@@ -0,0 +1,191 @@
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, basename, relative, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
+import { tmpdir } from 'node:os';
+/**
+ * Add command - installs a community template into the current project's .claude/ directory.
+ * Sources: GitHub (mustard-templates/{name}) or npm (mustard-template-{name}).
+ */
+export async function addCommand(templateSpec, options) {
+    // Parse template spec: "template:name" or just "name"
+    const name = templateSpec.replace(/^template:/, '');
+    if (!name || name.includes('..') || /[^a-zA-Z0-9_-]/.test(name)) {
+        console.error(`❌ Invalid template name: "${name}". Use alphanumeric, hyphens, underscores only.`);
+        process.exit(1);
+    }
+    const cwd = process.cwd();
+    const claudeDir = join(cwd, '.claude');
+    if (!existsSync(claudeDir)) {
+        console.error('❌ No .claude/ directory found. Run `mustard init` first.');
+        process.exit(1);
+    }
+    console.log(`📦 Installing template: ${name}`);
+    const tmpDir = join(tmpdir(), `mustard-template-${name}-${Date.now()}`);
+    try {
+        // Attempt 1: clone from GitHub
+        const repoUrl = `https://github.com/mustard-templates/${name}.git`;
+        console.log(`📥 Fetching from ${repoUrl}...`);
+        let fetchedDir = tmpDir;
+        try {
+            execSync(`git clone --depth 1 "${repoUrl}" "${tmpDir}"`, {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 30000,
+            });
+        }
+        catch {
+            // Attempt 2: npm package
+            console.log(`  GitHub repo not found. Trying npm: mustard-template-${name}...`);
+            try {
+                mkdirSync(tmpDir, { recursive: true });
+                execSync(`npm pack mustard-template-${name} --pack-destination "${tmpDir}"`, {
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    timeout: 30000,
+                });
+                const tgz = readdirSync(tmpDir).find(f => f.endsWith('.tgz'));
+                if (tgz) {
+                    execSync(`tar -xzf "${join(tmpDir, tgz)}" -C "${tmpDir}"`, {
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                    });
+                    // npm pack extracts to a "package" subdirectory
+                    const packageDir = join(tmpDir, 'package');
+                    if (existsSync(packageDir)) {
+                        fetchedDir = packageDir;
+                    }
+                }
+            }
+            catch {
+                console.error(`❌ Template "${name}" not found on GitHub or npm.`);
+                console.log('\nAvailable sources:');
+                console.log(`  GitHub: github.com/mustard-templates/${name}`);
+                console.log(`  npm:    mustard-template-${name}`);
+                process.exit(1);
+            }
+        }
+        // Read manifest
+        const manifestPath = join(fetchedDir, 'mustard-template.json');
+        let manifest;
+        if (existsSync(manifestPath)) {
+            manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+        }
+        else {
+            // Auto-detect known .claude/ subdirectories
+            manifest = {
+                name,
+                version: '0.0.0',
+                files: detectFiles(fetchedDir),
+            };
+        }
+        console.log(`📋 Template: ${manifest.name} v${manifest.version}`);
+        if (manifest.description)
+            console.log(`   ${manifest.description}`);
+        // Copy files
+        let copied = 0;
+        let skipped = 0;
+        for (const filePattern of manifest.files) {
+            const src = join(fetchedDir, filePattern);
+            if (!existsSync(src))
+                continue;
+            const destBase = join(claudeDir, filePattern);
+            if (statSync(src).isDirectory()) {
+                const files = walkDir(src);
+                for (const file of files) {
+                    const rel = relative(src, file);
+                    const dest = join(destBase, rel);
+                    if (existsSync(dest) && !options.force) {
+                        console.log(`  Skipping existing: ${join(filePattern, rel)}`);
+                        skipped++;
+                        continue;
+                    }
+                    mkdirSync(dirname(dest), { recursive: true });
+                    writeFileSync(dest, readFileSync(file));
+                    console.log(`  Copied: ${join(filePattern, rel)}`);
+                    copied++;
+                }
+            }
+            else {
+                if (existsSync(destBase) && !options.force) {
+                    console.log(`  Skipping existing: ${filePattern}`);
+                    skipped++;
+                    continue;
+                }
+                mkdirSync(dirname(destBase), { recursive: true });
+                writeFileSync(destBase, readFileSync(src));
+                console.log(`  Copied: ${filePattern}`);
+                copied++;
+            }
+        }
+        // Merge hook additions into settings.json
+        if (manifest.hooks_additions && manifest.hooks_additions.length > 0) {
+            const settingsPath = join(claudeDir, 'settings.json');
+            if (existsSync(settingsPath)) {
+                try {
+                    const settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+                    const hooks = (settings.hooks ?? {});
+                    settings.hooks = hooks;
+                    for (const hook of manifest.hooks_additions) {
+                        const event = hook.event;
+                        if (!hooks[event])
+                            hooks[event] = [];
+                        // Skip if hook command already registered
+                        const alreadyExists = hooks[event].some(h => h.hooks?.some(hh => hh.command === hook.command));
+                        if (!alreadyExists) {
+                            hooks[event].push({
+                                matcher: hook.matcher,
+                                hooks: [
+                                    {
+                                        type: 'command',
+                                        command: hook.command,
+                                        timeout: hook.timeout ?? 5,
+                                    },
+                                ],
+                            });
+                            console.log(`  Registered hook: ${event} -> ${basename(hook.command)}`);
+                        }
+                    }
+                    writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+                }
+                catch (err) {
+                    process.stderr.write(`  Could not merge hooks into settings.json: ${err.message}\n`);
+                }
+            }
+        }
+        console.log(`\nTemplate installed: ${copied} file(s) copied, ${skipped} skipped.`);
+        if (skipped > 0)
+            console.log('Use --force to overwrite existing files.');
+    }
+    finally {
+        // Cleanup tmp directory
+        try {
+            execSync(`rm -rf "${tmpDir}"`, { stdio: ['pipe', 'pipe', 'pipe'] });
+        }
+        catch {
+            try {
+                execSync(`rmdir /s /q "${tmpDir}"`, { stdio: ['pipe', 'pipe', 'pipe'] });
+            }
+            catch {
+                // Best-effort cleanup — ignore failure
+            }
+        }
+    }
+}
+function detectFiles(dir) {
+    const knownSubdirs = ['commands', 'skills', 'hooks', 'context', 'scripts'];
+    return knownSubdirs.filter(p => existsSync(join(dir, p)));
+}
+function walkDir(dir) {
+    const results = [];
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === '.git' || entry.name === 'node_modules')
+                continue;
+            results.push(...walkDir(full));
+        }
+        else {
+            results.push(full);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/review.d.ts

@@ -0,0 +1,6 @@
+interface ReviewOptions {
+    ci?: boolean;
+    pr?: string;
+}
+export declare function reviewCommand(options: ReviewOptions): Promise<void>;
+export {};

package/dist/commands/review.js

@@ -0,0 +1,143 @@
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export async function reviewCommand(options) {
+    const prNumber = options.pr;
+    if (!prNumber) {
+        console.error('Error: PR number required. Usage: mustard review --pr <number>');
+        process.exit(1);
+    }
+    // Verify gh CLI is available
+    try {
+        execSync('gh --version', { stdio: 'ignore' });
+    }
+    catch {
+        console.error('Error: GitHub CLI (gh) is required. Install from https://cli.github.com/');
+        process.exit(1);
+    }
+    // Verify claude CLI is available
+    try {
+        execSync('claude --version', { stdio: 'ignore' });
+    }
+    catch {
+        console.error('Error: Claude CLI is required. Install from https://docs.anthropic.com/');
+        process.exit(1);
+    }
+    console.log(`Reviewing PR #${prNumber}${options.ci ? ' (CI mode)' : ''}...`);
+    try {
+        // Fetch PR info
+        const prInfo = execSync(`gh pr view ${prNumber} --json title,body,additions,deletions,changedFiles,baseRefName,headRefName`, {
+            encoding: 'utf8',
+            timeout: 15000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        const pr = JSON.parse(prInfo);
+        // Fetch PR diff
+        const diff = execSync(`gh pr diff ${prNumber}`, {
+            encoding: 'utf8',
+            timeout: 30000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        // Truncate diff if too large (max ~50k chars for Claude context)
+        const maxDiffChars = 50000;
+        let truncatedDiff = diff;
+        if (diff.length > maxDiffChars) {
+            truncatedDiff = diff.slice(0, maxDiffChars) + '\n\n... (diff truncated, showing first 50k chars)';
+        }
+        // Load guards if available
+        let guards = '';
+        const cwd = process.cwd();
+        const guardsPath = join(cwd, '.claude', 'commands', 'guards.md');
+        if (existsSync(guardsPath)) {
+            try {
+                guards = readFileSync(guardsPath, 'utf8').slice(0, 3000);
+            }
+            catch { /* non-critical — proceed without guards */ }
+        }
+        // Load CLAUDE.md for project rules
+        let projectRules = '';
+        const claudeMdPath = join(cwd, 'CLAUDE.md');
+        if (existsSync(claudeMdPath)) {
+            try {
+                projectRules = readFileSync(claudeMdPath, 'utf8').slice(0, 2000);
+            }
+            catch { /* non-critical — proceed without project rules */ }
+        }
+        // Build review prompt
+        const prompt = buildReviewPrompt(pr, truncatedDiff, guards, projectRules);
+        // Run Claude for review (both modes use --print for non-interactive output)
+        const reviewResult = execSync(`claude --print "${escapeForShell(prompt)}"`, {
+            encoding: 'utf8',
+            timeout: 120000,
+            maxBuffer: 10 * 1024 * 1024,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        console.log('\nReview Result:\n');
+        console.log(reviewResult);
+        // In CI mode, post review as PR comment
+        if (options.ci && reviewResult.trim()) {
+            try {
+                const commentBody = `## Automated Review (Mustard)\n\n${reviewResult}`;
+                execSync(`gh pr comment ${prNumber} --body "${escapeForShell(commentBody)}"`, {
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    timeout: 15000,
+                    windowsHide: true,
+                });
+                console.log(`\nReview posted as comment on PR #${prNumber}`);
+            }
+            catch (err) {
+                process.stderr.write(`Warning: Could not post review comment: ${err.message}\n`);
+            }
+            // Exit with code based on review severity
+            if (/\bCRITICAL\b/i.test(reviewResult)) {
+                console.log('Critical issues found.');
+                process.exit(1);
+            }
+        }
+        console.log('Review complete.');
+    }
+    catch (err) {
+        console.error(`Error: Review failed: ${err.message}`);
+        process.exit(1);
+    }
+}
+function buildReviewPrompt(pr, diff, guards, projectRules) {
+    const additions = pr.additions;
+    const deletions = pr.deletions;
+    const changedFiles = pr.changedFiles;
+    const title = pr.title;
+    const body = pr.body;
+    const baseRefName = pr.baseRefName;
+    const headRefName = pr.headRefName;
+    const parts = [
+        'Review this pull request for code quality, security, and correctness.',
+        '',
+        `## PR: ${title}`,
+        `Base: ${baseRefName} <- Head: ${headRefName}`,
+        `Changes: +${additions} -${deletions} (${changedFiles} files)`,
+        '',
+    ];
+    if (body) {
+        parts.push('## Description', body, '');
+    }
+    if (projectRules) {
+        parts.push('## Project Rules', projectRules, '');
+    }
+    if (guards) {
+        parts.push("## Guards (DO/DON'T rules)", guards, '');
+    }
+    parts.push('## Review Checklist', '- [ ] No security vulnerabilities (injection, XSS, secrets)', '- [ ] Code follows project conventions', '- [ ] No unnecessary complexity', '- [ ] Error handling is appropriate', '- [ ] No breaking changes without migration', '', '## Diff', '```diff', diff, '```', '', 'Provide a structured review with:', '1. **Summary**: What this PR does (1-2 sentences)', '2. **Issues**: List of issues found (CRITICAL / WARNING / INFO)', '3. **Suggestions**: Improvements (optional)', '4. **Verdict**: APPROVE / REQUEST_CHANGES / COMMENT');
+    return parts.join('\n');
+}
+function escapeForShell(str) {
+    // Escape for double-quoted shell string
+    return str
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\$/g, '\\$')
+        .replace(/`/g, '\\`');
+}
+//# sourceMappingURL=review.js.map

package/dist/commands/review.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustard-claude",
-  "version": "3.0.11",
+  "version": "3.0.12",
   "description": "Framework-agnostic CLI for Claude Code project setup",
   "type": "module",
   "bin": {

package/templates/commands/mustard/bugfix/SKILL.md

@@ -15,6 +15,10 @@ Autonomous pipeline to diagnose and fix bugs. Zero context-switch — never ask
 ### ANALYZE (diagnose + assess)
 
 1. **AUTO-SYNC:** `node .claude/scripts/sync-registry.js`
+
+### Diff Context (automatic)
+Run `node .claude/scripts/diff-context.js` to capture the current git state. Include the output in the agent prompt as `{diff_context}` so agents know what has already changed.
+
 2. **DIAGNOSE:** Dispatch Explore agent:
    - Scoped Grep searches with specific path + pattern for the error/symptom
    - Trace callers/callees via Grep in relevant directories

package/templates/commands/mustard/complete/SKILL.md

@@ -33,10 +33,35 @@ If ANY gate fails: do NOT mark complete → report what failed + suggest fix. If
 6. **Pipeline State — cleanup:**
    - Extract `spec-name` from the spec directory (e.g. `2026-02-26-linked-services-card`)
    - **Delete** `.claude/.pipeline-states/{spec-name}.json` (removes from statusline)
-6b. **Token Economy — RTK report (if available):**
+6b. **Knowledge Capture:**
+   - Review patterns discovered during this pipeline
+   - For each significant pattern/convention/entity discovered:
+     ```bash
+     echo '{"type":"pattern","name":"...","description":"...","source":"{spec-name}"}' | node .claude/scripts/knowledge-update.js
+     ```
+   - Focus on: naming conventions used, architectural decisions, integration patterns
+   - Skip trivial or already-known patterns
+
+6c. **Token Economy — RTK report (if available):**
    - Run `rtk gain --all --format json` via Bash
    - If RTK available: extract `saved_tokens` and `savings_pct`
    - Include in output block below
+6d. **Metrics Archive:**
+   - Read metrics from `.claude/.pipeline-states/{spec-name}.json`
+   - If metrics exist, ensure `.claude/metrics/` directory exists
+   - Save to `.claude/metrics/{spec-name}.json`:
+     ```json
+     {
+       "name": "{spec-name}",
+       "completedAt": "{ISO timestamp}",
+       "durationMs": "{calculated from startedAt to now}",
+       "apiCalls": "{from metrics}",
+       "retries": "{from metrics}",
+       "toolBreakdown": "{from metrics}",
+       "rtkSavings": { "saved": N, "pct": N }
+     }
+     ```
+   - If no metrics in state file, skip silently
 7. **Output — visual feedback:**
 
    ```

package/templates/commands/mustard/feature/SKILL.md

@@ -15,6 +15,10 @@ Starts the pipeline to implement a feature or enhancement. Self-contained: ANALY
 ### ANALYZE Phase
 
 **Auto-sync (silent):** `node .claude/scripts/sync-registry.js`
+
+### Diff Context (automatic)
+Run `node .claude/scripts/diff-context.js` to capture the current git state. Include the output in the agent prompt as `{diff_context}` so agents know what has already changed.
+
 1. Read `pipeline-config.md` — agents, wave transitions, model selection
 2. Read `entity-registry.json` via Grep for the specific entity name (e.g. `"Contract":`) — NEVER read the full JSON. Entity found? infer layers. Not found? all layers.
 3. Determine layers from signals:
@@ -65,6 +69,9 @@ Record scope for PLAN phase branching.
    - Summary, Entity Info, Files, Tasks, Dependencies
    - Tasks organized by `### {Agent} Agent (Wave {N})`
    - 3-8 checkboxed steps per agent, decomposed by operation type (NOT by file)
+   - If a frontend task has NO dependency on new backend endpoints or types, mark it as `(parallel-safe)` in the spec header:
+     `### Frontend Agent (Wave 1, parallel-safe)`
+     This allows the orchestrator to dispatch it alongside backend in Wave 1.
 2. Add checkpoint fields: `Status: draft`, `Phase: PLAN`, `Scope: full`, `Checkpoint: {now}`
 3. Create `.claude/.pipeline-states/{spec-name}.json`: `specName`, `status: "active"`, `phase: 2`, `phaseName: "PLAN"`, `scope: "full"`
 4. Elegance Check: 3+ files or complex logic → "Is there a more elegant approach?"
@@ -103,7 +110,7 @@ When user chooses "Approve and implement now":
 3. Read `pipeline-config.md` for agent config. For `entity-registry.json`: Grep for specific entity block only
 4. Match recipes by title via Grep on `{subproject}/.claude/commands/recipes.md` — do NOT read full file. Extract recipe number + pattern refs
 5. Identify relevant skills for `{recommended_skills}`: list skill names most relevant to the task (e.g., `api-endpoint-wiring, api-dto-validation`). Agents use these as hints — Claude natively decides which to load based on descriptions
-6. Dispatch agents (wave rules: DB+Backend parallel, Frontend after Backend). Agent prompt includes `{recommended_skills}` as skill hints — agents read SKILL.md of relevant skills before implementing
+6. Dispatch agents (wave rules: DB+Backend parallel, Frontend after Backend UNLESS spec marks task as `(parallel-safe)` — see `pipeline-config.md` Parallel Rules). Agent prompt includes `{recommended_skills}` as skill hints — agents read SKILL.md of relevant skills before implementing
 7. Wave transitions between waves (from `pipeline-config.md`)
 8. On return: validate (build/type-check), update spec `[ ]` → `[x]` (line-by-line edits, NEVER copy entire spec blocks as old_string)
 8b. **Agent Memory:** After agents return and spec is updated, write agent memory: `echo '{"agent_type":"{type}","wave":{N},"pipeline":"{spec-name}","summary":"{what agent did}","details":{...}}' | node .claude/scripts/memory-write.js` — one per agent. Skip if single-wave pipeline (no downstream agents to benefit).