@chief-clancy/brief 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Clapperton
+
+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/bin/brief.js

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+
+/**
+ * Brief installer — CLI entry point for `npx @chief-clancy/brief`.
+ *
+ * Self-contained installer that copies the brief slash command, workflow,
+ * and devil's advocate agent prompt to the Claude Code commands directory.
+ * No dependencies on @chief-clancy/core or @chief-clancy/terminal.
+ */
+import {
+  copyFileSync,
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+} from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { fileURLToPath } from 'node:url';
+
+// ---------------------------------------------------------------------------
+// ANSI helpers (inlined — no external dependencies)
+// ---------------------------------------------------------------------------
+
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const blue = (s) => `\x1b[1;34m${s}\x1b[0m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+
+// ---------------------------------------------------------------------------
+// Resolve package metadata and source directories
+// ---------------------------------------------------------------------------
+
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+
+const briefRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+
+const sources = {
+  commandsDir: join(briefRoot, 'src', 'commands'),
+  workflowsDir: join(briefRoot, 'src', 'workflows'),
+  agentsDir: join(briefRoot, 'src', 'agents'),
+};
+
+// ---------------------------------------------------------------------------
+// Environment
+// ---------------------------------------------------------------------------
+
+const homeDir = process.env.HOME ?? process.env.USERPROFILE;
+
+if (!homeDir) {
+  console.error(red('  Error: Could not determine home directory.'));
+  process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// CLI flag parsing
+// ---------------------------------------------------------------------------
+
+/** @param {readonly string[]} args */
+function parseFlag(args) {
+  if (args.includes('--global')) return 'global';
+  if (args.includes('--local')) return 'local';
+  return null;
+}
+
+const flag = parseFlag(process.argv.slice(2));
+const nonInteractive = flag !== null;
+
+// ---------------------------------------------------------------------------
+// Prompt helpers
+// ---------------------------------------------------------------------------
+
+const rl = createInterface({ input: process.stdin, output: process.stdout });
+
+/** @param {string} label */
+const ask = (label) => new Promise((resolve) => rl.question(label, resolve));
+
+// ---------------------------------------------------------------------------
+// Installer
+// ---------------------------------------------------------------------------
+
+/** @param {string} path */
+function rejectSymlink(path) {
+  try {
+    if (lstatSync(path).isSymbolicLink()) {
+      throw new Error(`Symlink rejected: ${path}`);
+    }
+  } catch (err) {
+    if (err.code !== 'ENOENT') throw err;
+  }
+}
+
+/** @param {string} src @param {string} dest */
+function copyChecked(src, dest) {
+  rejectSymlink(dest);
+  copyFileSync(src, dest);
+}
+
+/** Inline workflow @-references into command files (global mode only). */
+function inlineWorkflow(commandsDest, workflowsDest) {
+  const WORKFLOW_REF = /^@\.claude\/clancy\/workflows\/([^/\\]+\.md)\r?$/gm;
+  const cmdPath = join(commandsDest, 'brief.md');
+  const content = readFileSync(cmdPath, 'utf8');
+  const resolved = content.replace(WORKFLOW_REF, (match, fileName) => {
+    const wfPath = join(workflowsDest, fileName);
+    if (!existsSync(wfPath)) return match;
+    return readFileSync(wfPath, 'utf8');
+  });
+
+  if (resolved !== content) {
+    rejectSymlink(cmdPath);
+    writeFileSync(cmdPath, resolved);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Mode selection
+// ---------------------------------------------------------------------------
+
+const MODE_MAP = { 1: 'global', 2: 'local', global: 'global', local: 'local' };
+
+/** Prompt the user for global/local and return the mode (or exit on bad input). */
+async function chooseMode() {
+  console.log(blue('  Where would you like to install?'));
+  console.log('');
+  console.log(
+    `  1) Global  ${dim('(~/.claude)')}   — available in all projects`,
+  );
+  console.log(`  2) Local   ${dim('(./.claude)')}  — this project only`);
+  console.log('');
+  const raw = await ask(cyan('  Choice [1]: '));
+  const key = (raw || '1').trim().toLowerCase();
+  const resolved = MODE_MAP[key];
+
+  if (resolved) return resolved;
+
+  console.log(red('\n  Invalid choice. Run npx @chief-clancy/brief again.'));
+  rl.close();
+  process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function main() {
+  console.log('');
+  console.log(blue('  Clancy Brief'));
+  console.log(
+    `  ${bold(`v${pkg.version}`)}${dim('  Strategic brief generator for Claude Code.')}`,
+  );
+  console.log('');
+
+  const mode = flag ?? (await chooseMode());
+
+  if (flag) {
+    console.log(dim(`  Mode: ${flag} (--${flag} flag)`));
+  }
+
+  const cwd = process.cwd();
+  const baseDir =
+    mode === 'global' ? join(homeDir, '.claude') : join(cwd, '.claude');
+
+  const commandsDest = join(baseDir, 'commands', 'clancy');
+  const workflowsDest = join(baseDir, 'clancy', 'workflows');
+  const agentsDest = join(baseDir, 'clancy', 'agents');
+
+  console.log(dim(`  Installing to: ${commandsDest}`));
+
+  // Create directories
+  mkdirSync(commandsDest, { recursive: true });
+  mkdirSync(workflowsDest, { recursive: true });
+  mkdirSync(agentsDest, { recursive: true });
+
+  // Copy files
+  copyChecked(
+    join(sources.commandsDir, 'brief.md'),
+    join(commandsDest, 'brief.md'),
+  );
+  copyChecked(
+    join(sources.workflowsDir, 'brief.md'),
+    join(workflowsDest, 'brief.md'),
+  );
+  copyChecked(
+    join(sources.agentsDir, 'devils-advocate.md'),
+    join(agentsDest, 'devils-advocate.md'),
+  );
+
+  // Inline workflows for global mode
+  if (mode === 'global') {
+    inlineWorkflow(commandsDest, workflowsDest);
+  }
+
+  // Write version marker
+  const versionPath = join(commandsDest, 'VERSION.brief');
+  rejectSymlink(versionPath);
+  writeFileSync(versionPath, pkg.version);
+
+  // Success
+  console.log('');
+  console.log(green('  ✓ Clancy Brief installed successfully.'));
+  console.log('');
+  console.log('  Command available:');
+  console.log(
+    `      ${cyan('/clancy:brief')}  ${dim('Generate a strategic brief for a feature')}`,
+  );
+  console.log('');
+  console.log('  Next steps:');
+  console.log(`    1. Open a project in Claude Code`);
+  console.log(`    2. Run: ${cyan('/clancy:brief "Your feature idea"')}`);
+  console.log('');
+  console.log(
+    dim('  For the full pipeline (tickets, planning, implementation):'),
+  );
+  console.log(dim(`    npx chief-clancy`));
+  console.log('');
+
+  rl.close();
+}
+
+main().catch((err) => {
+  console.error(red(`\n  Error: ${err.message}`));
+  rl.close();
+  process.exit(1);
+});

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @chief-clancy/brief
+ *
+ * Strategic brief generator for Claude Code — grill, decompose, and
+ * document feature ideas. Ships the `/clancy:brief` slash command
+ * and a lightweight installer.
+ */
+export declare const PACKAGE_NAME: "@chief-clancy/brief";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAG,qBAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @chief-clancy/brief
+ *
+ * Strategic brief generator for Claude Code — grill, decompose, and
+ * document feature ideas. Ships the `/clancy:brief` slash command
+ * and a lightweight installer.
+ */
+export const PACKAGE_NAME = '@chief-clancy/brief';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,qBAA8B,CAAC"}

package/dist/installer/install.d.ts

@@ -0,0 +1,64 @@
+/** The install target — global (`~/.claude`) or local (`./.claude`). */
+export type BriefInstallMode = 'global' | 'local';
+/** All resolved destination paths for a brief installation. */
+export type BriefInstallPaths = {
+    readonly commandsDest: string;
+    readonly workflowsDest: string;
+    readonly agentsDest: string;
+};
+/** Source directories within the npm package. */
+type BriefInstallSources = {
+    readonly commandsDir: string;
+    readonly workflowsDir: string;
+    readonly agentsDir: string;
+};
+/**
+ * File system operations the installer performs.
+ *
+ * `mkdir` must be idempotent (recursive, ignoring EEXIST).
+ */
+type BriefInstallerFs = {
+    readonly exists: (path: string) => boolean;
+    readonly readFile: (path: string) => string;
+    readonly writeFile: (path: string, content: string) => void;
+    readonly mkdir: (path: string) => void;
+    readonly copyFile: (src: string, dest: string) => void;
+    /** Must return `false` (not throw) when the path does not exist. */
+    readonly isSymlink: (path: string) => boolean;
+};
+/** Options for {@link runBriefInstall}. */
+export type RunBriefInstallOptions = {
+    readonly mode: BriefInstallMode;
+    readonly paths: BriefInstallPaths;
+    readonly sources: BriefInstallSources;
+    readonly version: string;
+    readonly fs: BriefInstallerFs;
+};
+/**
+ * Parse `--global` / `--local` from CLI arguments.
+ *
+ * @param args - CLI arguments (typically `process.argv.slice(2)`).
+ * @returns The install mode, or `null` if no flag was provided.
+ */
+export declare const parseBriefInstallFlag: (args: readonly string[]) => BriefInstallMode | null;
+/**
+ * Compute all destination paths for a brief installation.
+ *
+ * @param mode - Global or local install target.
+ * @param homeDir - The user's home directory.
+ * @param cwd - The current working directory.
+ * @returns All resolved destination paths.
+ */
+export declare const resolveBriefInstallPaths: (mode: BriefInstallMode, homeDir: string, cwd: string) => BriefInstallPaths;
+/**
+ * Run the brief installation pipeline.
+ *
+ * Copies command, workflow, and agent files to the target directory.
+ * For global mode, inlines workflow content into the command file.
+ * Writes a VERSION.brief marker with the package version.
+ *
+ * @param options - All dependencies and configuration.
+ */
+export declare const runBriefInstall: (options: RunBriefInstallOptions) => void;
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/installer/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/installer/install.ts"],"names":[],"mappings":"AAaA,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElD,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,iDAAiD;AACjD,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,KAAK,gBAAgB,GAAG;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,gBAAgB,CAAC;CAC/B,CAAC;AAsBF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,SAAS,MAAM,EAAE,KACtB,gBAAgB,GAAG,IAKrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,gBAAgB,EACtB,SAAS,MAAM,EACf,KAAK,MAAM,KACV,iBASF,CAAC;AA4EF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,IA6BjE,CAAC"}

package/dist/installer/install.js

@@ -0,0 +1,135 @@
+/**
+ * Brief installer — self-contained module for `npx @chief-clancy/brief`.
+ *
+ * Copies the brief slash command, workflow, and devil's advocate agent
+ * prompt to the Claude Code commands directory. No hooks, bundles,
+ * manifests, role filtering, or board configuration.
+ */
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Command files shipped with the brief package. */
+const COMMAND_FILES = ['brief.md'];
+/** Workflow files shipped with the brief package. */
+const WORKFLOW_FILES = ['brief.md'];
+/** Agent files shipped with the brief package. */
+const AGENT_FILES = ['devils-advocate.md'];
+/** Matches `@.claude/clancy/workflows/<filename>.md` on its own line. */
+const WORKFLOW_REF = /^@\.claude\/clancy\/workflows\/([^/\\]+\.md)\r?$/gm;
+// ---------------------------------------------------------------------------
+// Pure functions
+// ---------------------------------------------------------------------------
+/**
+ * Parse `--global` / `--local` from CLI arguments.
+ *
+ * @param args - CLI arguments (typically `process.argv.slice(2)`).
+ * @returns The install mode, or `null` if no flag was provided.
+ */
+export const parseBriefInstallFlag = (args) => {
+    if (args.includes('--global'))
+        return 'global';
+    if (args.includes('--local'))
+        return 'local';
+    return null;
+};
+/**
+ * Compute all destination paths for a brief installation.
+ *
+ * @param mode - Global or local install target.
+ * @param homeDir - The user's home directory.
+ * @param cwd - The current working directory.
+ * @returns All resolved destination paths.
+ */
+export const resolveBriefInstallPaths = (mode, homeDir, cwd) => {
+    const baseDir = mode === 'global' ? join(homeDir, '.claude') : join(cwd, '.claude');
+    return {
+        commandsDest: join(baseDir, 'commands', 'clancy'),
+        workflowsDest: join(baseDir, 'clancy', 'workflows'),
+        agentsDest: join(baseDir, 'clancy', 'agents'),
+    };
+};
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Throw if the given path is a symlink (ENOENT is swallowed). */
+const rejectSymlink = (path, isSymlink) => {
+    if (isSymlink(path)) {
+        throw new Error(`Symlink rejected: ${path}`);
+    }
+};
+/** Copy a list of files from src dir to dest dir with symlink protection. */
+const copyFiles = (options) => {
+    const { files, srcDir, destDir, fs } = options;
+    fs.mkdir(destDir);
+    files.forEach((file) => {
+        const src = join(srcDir, file);
+        const dest = join(destDir, file);
+        if (!fs.exists(src)) {
+            throw new Error(`Source file not found: ${src}`);
+        }
+        rejectSymlink(dest, fs.isSymlink);
+        fs.copyFile(src, dest);
+    });
+};
+/**
+ * Inline workflow content into command files (global mode only).
+ *
+ * Replaces `@.claude/clancy/workflows/<name>.md` references with the
+ * actual workflow content so global installs work without project-relative
+ * @-file resolution.
+ */
+const inlineWorkflow = (commandsDest, workflowsDest, fs) => {
+    COMMAND_FILES.forEach((file) => {
+        const cmdPath = join(commandsDest, file);
+        const content = fs.readFile(cmdPath);
+        const resolved = content.replace(WORKFLOW_REF, (match, fileName) => {
+            const wfPath = join(workflowsDest, fileName);
+            return fs.exists(wfPath) ? fs.readFile(wfPath) : match;
+        });
+        if (resolved !== content) {
+            rejectSymlink(cmdPath, fs.isSymlink);
+            fs.writeFile(cmdPath, resolved);
+        }
+    });
+};
+// ---------------------------------------------------------------------------
+// Main pipeline
+// ---------------------------------------------------------------------------
+/**
+ * Run the brief installation pipeline.
+ *
+ * Copies command, workflow, and agent files to the target directory.
+ * For global mode, inlines workflow content into the command file.
+ * Writes a VERSION.brief marker with the package version.
+ *
+ * @param options - All dependencies and configuration.
+ */
+export const runBriefInstall = (options) => {
+    const { mode, paths, sources, version, fs } = options;
+    copyFiles({
+        files: COMMAND_FILES,
+        srcDir: sources.commandsDir,
+        destDir: paths.commandsDest,
+        fs,
+    });
+    copyFiles({
+        files: WORKFLOW_FILES,
+        srcDir: sources.workflowsDir,
+        destDir: paths.workflowsDest,
+        fs,
+    });
+    copyFiles({
+        files: AGENT_FILES,
+        srcDir: sources.agentsDir,
+        destDir: paths.agentsDest,
+        fs,
+    });
+    if (mode === 'global') {
+        inlineWorkflow(paths.commandsDest, paths.workflowsDest, fs);
+    }
+    const versionPath = join(paths.commandsDest, 'VERSION.brief');
+    rejectSymlink(versionPath, fs.isSymlink);
+    fs.writeFile(versionPath, version);
+};
+//# sourceMappingURL=install.js.map

package/dist/installer/install.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@chief-clancy/brief",
+  "version": "0.1.0",
+  "description": "Strategic brief generator for Claude Code — grill, decompose, and document feature ideas",
+  "author": "Alex Clapperton",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pushedskydiver/chief-clancy.git",
+    "directory": "packages/brief"
+  },
+  "homepage": "https://github.com/Pushedskydiver/chief-clancy#readme",
+  "bugs": {
+    "url": "https://github.com/Pushedskydiver/chief-clancy/issues"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "brief",
+    "strategy",
+    "slash-commands",
+    "developer-tools"
+  ],
+  "type": "module",
+  "bin": {
+    "clancy-brief": "./bin/brief.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "src/commands",
+    "src/workflows",
+    "src/agents"
+  ],
+  "scripts": {
+    "build": "rm -rf dist tsconfig.build.tsbuildinfo && tsc --project tsconfig.build.json && tsc-alias --project tsconfig.build.json",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/agents/agents.test.ts

@@ -0,0 +1,49 @@
+/**
+ * Structural tests for brief agent prompt files.
+ *
+ * Verifies the agents directory contains the expected prompt files
+ * that the brief workflow's AI-grill phase depends on.
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+import { describe, expect, it } from 'vitest';
+
+const AGENTS_DIR = fileURLToPath(new URL('.', import.meta.url));
+
+const EXPECTED_AGENTS = ['devils-advocate.md'];
+
+describe('agents directory structure', () => {
+  it('contains exactly the expected agent files', () => {
+    const agents = readdirSync(AGENTS_DIR)
+      .filter((f) => f.endsWith('.md'))
+      .sort();
+
+    expect(agents).toEqual([...EXPECTED_AGENTS].sort());
+  });
+
+  it('all agent files start with a heading', () => {
+    const issues: string[] = [];
+
+    EXPECTED_AGENTS.forEach((file) => {
+      const content = readFileSync(new URL(file, import.meta.url), 'utf8');
+      const firstLine = content.split('\n')[0]?.trim() ?? '';
+
+      if (!firstLine.startsWith('#')) {
+        issues.push(file);
+      }
+    });
+
+    expect(issues).toEqual([]);
+  });
+
+  it('devils-advocate.md contains confidence classification', () => {
+    const content = readFileSync(
+      new URL('devils-advocate.md', import.meta.url),
+      'utf8',
+    );
+
+    expect(content).toContain('Answerable');
+    expect(content).toContain('Open Questions');
+  });
+});

package/src/agents/devils-advocate.md

@@ -0,0 +1,54 @@
+# Devil's Advocate Agent
+
+You are the devil's advocate agent for Clancy's strategist role. Your job is to answer a list of clarifying questions about a feature idea by interrogating the codebase, board, and web — then classify each answer by confidence.
+
+You receive 10-15 clarifying questions generated during the AI-grill phase of `/clancy:brief --afk`. You must answer them autonomously. Never ask the human for input — this runs in AFK mode with no human present.
+
+## Instructions
+
+1. Work through each question one at a time. For every question, investigate before answering — never guess.
+2. Interrogate three sources in order of preference:
+   - **Codebase**: use Glob, Grep, and Read to explore affected areas, check `.clancy/docs/`, read existing patterns. Use real file paths and code snippets as evidence.
+   - **Board**: check the parent ticket, related tickets, and existing children for context. Look for conflicting requirements.
+   - **Web**: when the question involves external technology, third-party integrations, or industry patterns, use WebSearch and WebFetch.
+3. Challenge your own answers. If the codebase says one thing but the ticket description says another, flag the conflict — do not silently pick one.
+4. Follow self-generated follow-ups within the same pass. If answering a question raises a new sub-question, chase it to its conclusion before moving on. Example: "Should this support SSO?" → check codebase → find SAML provider → "SAML exists but should the new feature use SAML or add OIDC?" → check web → resolve or flag.
+5. Be RELENTLESS. If the codebase doesn't clearly support a decision, don't manufacture confidence. Put it in Open Questions.
+6. If a question is partially answerable, answer the part you can and flag the remainder as open.
+
+## How to classify
+
+- **Answerable** (>80% confidence, clear codebase precedent or unambiguous external evidence) → include in Discovery section with source tag.
+- **Conflicting** (codebase says X, ticket says Y, or two sources disagree) → include in Open Questions with the conflict described.
+- **Not answerable** (business decision, ambiguous requirements, money/legal/compliance, no evidence in any source) → include in Open Questions for PO review.
+
+## Output format
+
+Return exactly two markdown sections:
+
+```markdown
+## Discovery
+
+Q: [question]
+A: [answer with evidence]. (Source: codebase|board|web)
+
+Q: [question]
+A: [answer]. (Source: codebase)
+
+## Open Questions
+
+- [ ] [question that couldn't be resolved — with reason]
+- [ ] [question with conflicting evidence — conflict described]
+```
+
+Every answer in Discovery must cite its source: `(Source: codebase)`, `(Source: board)`, `(Source: web)`, or `(Source: codebase, web)` for combined evidence.
+
+---
+
+## Rules
+
+- NEVER ask the human questions. You are running autonomously.
+- Single pass — no multi-round conversation loop. But each question must be followed to its conclusion including any self-follow-ups.
+- Every answer must include real file paths, code snippets, ticket references, or URLs as evidence. No hand-waving.
+- When you find no evidence at all, say so explicitly and classify as Open Questions.
+- Prefer specificity over breadth. One concrete file path beats three vague claims.

package/src/commands/brief.md

@@ -0,0 +1,29 @@
+# /clancy:brief
+
+Generate a strategic brief for a feature idea. Researches the codebase, grills you (or itself) on requirements, and produces a decomposition into actionable tickets.
+
+Accepts optional arguments:
+
+- **Board ticket:** `/clancy:brief PROJ-123`, `/clancy:brief #42`, `/clancy:brief ENG-42` — brief from a board ticket
+- **Inline text:** `/clancy:brief "Add dark mode"` — brief from a description
+- **From file:** `/clancy:brief --from docs/rfc.md` — brief from a local file
+- **Batch mode:** `/clancy:brief 3` — brief up to 3 tickets from the queue
+- **Fresh start:** `--fresh` — discard existing brief and start over
+- **Force web research:** `--research` — include web research in analysis
+- **AFK mode:** `--afk` — use AI-grill instead of human grill
+- **Epic hint:** `--epic PROJ-50 "Add dark mode"` — set parent for approve step
+- **List briefs:** `--list` — show inventory of existing briefs
+
+Examples:
+
+- `/clancy:brief` — interactive mode (prompt for idea)
+- `/clancy:brief PROJ-200` — brief a Jira ticket
+- `/clancy:brief #42` — brief a GitHub issue
+- `/clancy:brief ENG-42` — brief a Linear issue
+- `/clancy:brief "Add dark mode support"` — brief from inline text
+- `/clancy:brief --afk PROJ-200` — brief with AI-grill (no human questions)
+- `/clancy:brief --list` — show all briefs
+
+@.claude/clancy/workflows/brief.md
+
+Follow the brief workflow above. Research the codebase, conduct the grill phase, generate the brief, and save it locally. Do not create tickets — briefing only.