@chief-clancy/brief 0.2.0 → 0.3.1

package/README.md

@@ -52,15 +52,36 @@ Briefs are saved to `.clancy/briefs/` in your project.
 
 ## Board ticket mode (optional)
 
-To brief from board tickets and push approved briefs back to the board without installing the full pipeline:
+To brief from board tickets without installing the full pipeline:
 
 1. Run `/clancy:board-setup` in Claude Code
 2. Follow the prompts to configure your board credentials
-3. Run `/clancy:brief #42` (or your board's ticket format) to brief from an existing ticket
-4. Run `/clancy:approve-brief <slug>` to convert an approved brief into child tickets on your board (creates one ticket per row in the brief's decomposition table, links dependencies, and posts a tracking summary)
+3. Run `/clancy:brief #42` (or your board's ticket format)
 
 Credentials are stored in `.clancy/.env` and are per-project (not global).
 
+Supported boards: Jira, GitHub Issues, Linear, Shortcut, Notion, Azure DevOps.
+
+## Approving briefs
+
+The brief package ships `/clancy:approve-brief` so the approval gate works without the full pipeline. The behaviour depends on the install mode.
+
+### Standalone (no board)
+
+`/clancy:approve-brief` requires board credentials. Approve-brief's job is to create child tickets ON the board, so without a board there is nothing for it to do. Run `/clancy:board-setup` first to configure your board, then re-run `/clancy:approve-brief`.
+
+### Standalone+board (board credentials but no full pipeline)
+
+`/clancy:approve-brief <slug>` walks the brief's decomposition table, creates one child ticket per row on the board (in topological/dependency order), links dependencies, and posts a tracking summary as a comment on the parent ticket. Each child ticket gets a pipeline label so downstream queue commands (`/clancy:plan`, `/clancy:implement`) know which queue picks it up.
+
+In standalone+board mode, child tickets default to `CLANCY_LABEL_PLAN` (default `clancy:plan`), even though `CLANCY_ROLES` is unset — passing `--skip-plan` overrides this and forces `CLANCY_LABEL_BUILD` (default `clancy:build`) instead. This is the **single-source-of-truth pipeline label rule**: standalone+board users have installed both `@chief-clancy/brief` and `@chief-clancy/plan` as standalone packages and clearly intend to use plan, so the workflow defaults to the planning queue rather than the build queue.
+
+Partial failures stop immediately. The brief file's approve marker tracks which rows already shipped to the board, so re-running `/clancy:approve-brief` resumes from where the previous run stopped — it never duplicates a ticket.
+
+### Terminal mode (full pipeline)
+
+Existing behaviour, unchanged. The pipeline label respects `CLANCY_ROLES`: if `planner` is enabled (or `CLANCY_ROLES` is unset, indicating a global install), child tickets get `CLANCY_LABEL_PLAN`; if `planner` is explicitly excluded, child tickets get `CLANCY_LABEL_BUILD` (the terminal user has opted out of the planning queue). The `--skip-plan` flag overrides both and forces the build label.
+
 ## Full pipeline
 
 `@chief-clancy/brief` covers brief generation and ticket creation from briefs. For planning and the full development pipeline (autopilot, implementation, review), install the complete Clancy package:

package/bin/brief.js

@@ -39,6 +39,9 @@ const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
 
 const briefRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+const scanRoot = join(
+  dirname(require.resolve('@chief-clancy/scan/package.json')),
+);
 
 const sources = {
   commandsDir: join(briefRoot, 'src', 'commands'),
@@ -87,6 +90,15 @@ const ask = (label) => new Promise((resolve) => rl.question(label, resolve));
 const COMMAND_FILES = ['approve-brief.md', 'board-setup.md', 'brief.md'];
 const WORKFLOW_FILES = ['approve-brief.md', 'board-setup.md', 'brief.md'];
 const AGENT_FILES = ['devils-advocate.md'];
+const SCAN_AGENT_FILES = [
+  'arch-agent.md',
+  'concerns-agent.md',
+  'design-agent.md',
+  'quality-agent.md',
+  'tech-agent.md',
+];
+const SCAN_COMMAND_FILES = ['map-codebase.md', 'update-docs.md'];
+const SCAN_WORKFLOW_FILES = ['map-codebase.md', 'update-docs.md'];
 
 // ---------------------------------------------------------------------------
 // Installer
@@ -113,12 +125,13 @@ function copyChecked(src, dest) {
 function inlineWorkflows(commandsDest, workflowsDest) {
   const WORKFLOW_REF = /^@\.claude\/clancy\/workflows\/([^/\\]+\.md)\r?$/gm;
 
-  COMMAND_FILES.forEach((file) => {
+  [...COMMAND_FILES, ...SCAN_COMMAND_FILES].forEach((file) => {
     const cmdPath = join(commandsDest, file);
     const content = readFileSync(cmdPath, 'utf8');
     const resolved = content.replace(WORKFLOW_REF, (match, fileName) => {
       const wfPath = join(workflowsDest, fileName);
       if (!existsSync(wfPath)) return match;
+      rejectSymlink(wfPath);
       return readFileSync(wfPath, 'utf8');
     });
 
@@ -156,39 +169,14 @@ async function chooseMode() {
 }
 
 // ---------------------------------------------------------------------------
-// Main
+// Install helpers
 // ---------------------------------------------------------------------------
 
-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());
+/** Copy all brief + scan files and write version marker. */
+function installFiles(dest, mode) {
+  const { commandsDest, workflowsDest, agentsDest } = dest;
 
-  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
+  // Brief files
   COMMAND_FILES.forEach((f) =>
     copyChecked(join(sources.commandsDir, f), join(commandsDest, f)),
   );
@@ -199,17 +187,26 @@ async function main() {
     copyChecked(join(sources.agentsDir, f), join(agentsDest, f)),
   );
 
-  // Inline workflows for global mode
-  if (mode === 'global') {
-    inlineWorkflows(commandsDest, workflowsDest);
-  }
+  // Scan files (agents, commands, workflows from @chief-clancy/scan)
+  SCAN_AGENT_FILES.forEach((f) =>
+    copyChecked(join(scanRoot, 'src', 'agents', f), join(agentsDest, f)),
+  );
+  SCAN_COMMAND_FILES.forEach((f) =>
+    copyChecked(join(scanRoot, 'src', 'commands', f), join(commandsDest, f)),
+  );
+  SCAN_WORKFLOW_FILES.forEach((f) =>
+    copyChecked(join(scanRoot, 'src', 'workflows', f), join(workflowsDest, f)),
+  );
+
+  if (mode === 'global') inlineWorkflows(commandsDest, workflowsDest);
 
-  // Write version marker
   const versionPath = join(commandsDest, 'VERSION.brief');
   rejectSymlink(versionPath);
   writeFileSync(versionPath, pkg.version);
+}
 
-  // Success
+/** Print the install success output. */
+function printSuccess() {
   console.log('');
   console.log(green('  ✓ Clancy Brief installed successfully.'));
   console.log('');
@@ -223,10 +220,19 @@ async function main() {
   console.log(
     `      ${cyan('/clancy:board-setup')}    ${dim('Configure board credentials (optional)')}`,
   );
+  console.log(
+    `      ${cyan('/clancy:map-codebase')}   ${dim('Scan codebase and generate .clancy/docs/')}`,
+  );
+  console.log(
+    `      ${cyan('/clancy:update-docs')}    ${dim('Refresh .clancy/docs/ incrementally')}`,
+  );
   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(
+    `    2. Optional: ${cyan('/clancy:map-codebase')} ${dim('for richer briefs')}`,
+  );
+  console.log(`    3. Run: ${cyan('/clancy:brief "Your feature idea"')}`);
   console.log('');
   console.log(dim('  Want to brief from board tickets?'));
   console.log(dim(`    Run: ${cyan('/clancy:board-setup')}`));
@@ -236,6 +242,42 @@ async function main() {
   );
   console.log(dim(`    npx chief-clancy`));
   console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// 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}`));
+
+  mkdirSync(commandsDest, { recursive: true });
+  mkdirSync(workflowsDest, { recursive: true });
+  mkdirSync(agentsDest, { recursive: true });
+
+  installFiles({ commandsDest, workflowsDest, agentsDest }, mode);
+  printSuccess();
 
   rl.close();
 }

package/dist/installer/install.d.ts

@@ -11,6 +11,9 @@ type BriefInstallSources = {
     readonly commandsDir: string;
     readonly workflowsDir: string;
     readonly agentsDir: string;
+    readonly scanAgentsDir: string;
+    readonly scanCommandsDir: string;
+    readonly scanWorkflowsDir: string;
 };
 /**
  * File system operations the installer performs.

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

@@ -1 +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;AA8BF;;;;;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"}
+{"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;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC,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;AA6CF;;;;;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;AA+EF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,IA+CjE,CAAC"}

package/dist/installer/install.js

@@ -23,6 +23,18 @@ const WORKFLOW_FILES = [
 ];
 /** Agent files shipped with the brief package. */
 const AGENT_FILES = ['devils-advocate.md'];
+/** Scan agent files from @chief-clancy/scan. */
+const SCAN_AGENT_FILES = [
+    'arch-agent.md',
+    'concerns-agent.md',
+    'design-agent.md',
+    'quality-agent.md',
+    'tech-agent.md',
+];
+/** Scan command files from @chief-clancy/scan. */
+const SCAN_COMMAND_FILES = ['map-codebase.md', 'update-docs.md'];
+/** Scan workflow files from @chief-clancy/scan. */
+const SCAN_WORKFLOW_FILES = ['map-codebase.md', 'update-docs.md'];
 /** Matches `@.claude/clancy/workflows/<filename>.md` on its own line. */
 const WORKFLOW_REF = /^@\.claude\/clancy\/workflows\/([^/\\]+\.md)\r?$/gm;
 // ---------------------------------------------------------------------------
@@ -69,6 +81,7 @@ const rejectSymlink = (path, isSymlink) => {
 /** Copy a list of files from src dir to dest dir with symlink protection. */
 const copyFiles = (options) => {
     const { files, srcDir, destDir, fs } = options;
+    rejectSymlink(destDir, fs.isSymlink);
     fs.mkdir(destDir);
     files.forEach((file) => {
         const src = join(srcDir, file);
@@ -88,12 +101,15 @@ const copyFiles = (options) => {
  * @-file resolution.
  */
 const inlineWorkflow = (commandsDest, workflowsDest, fs) => {
-    COMMAND_FILES.forEach((file) => {
+    [...COMMAND_FILES, ...SCAN_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;
+            rejectSymlink(wfPath, fs.isSymlink);
+            if (!fs.exists(wfPath))
+                return match;
+            return fs.readFile(wfPath);
         });
         if (resolved !== content) {
             rejectSymlink(cmdPath, fs.isSymlink);
@@ -133,6 +149,24 @@ export const runBriefInstall = (options) => {
         destDir: paths.agentsDest,
         fs,
     });
+    copyFiles({
+        files: SCAN_AGENT_FILES,
+        srcDir: sources.scanAgentsDir,
+        destDir: paths.agentsDest,
+        fs,
+    });
+    copyFiles({
+        files: SCAN_COMMAND_FILES,
+        srcDir: sources.scanCommandsDir,
+        destDir: paths.commandsDest,
+        fs,
+    });
+    copyFiles({
+        files: SCAN_WORKFLOW_FILES,
+        srcDir: sources.scanWorkflowsDir,
+        destDir: paths.workflowsDest,
+        fs,
+    });
     if (mode === 'global') {
         inlineWorkflow(paths.commandsDest, paths.workflowsDest, fs);
     }

package/dist/installer/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/installer/install.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/installer/install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAkDjC,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,oDAAoD;AACpD,MAAM,aAAa,GAAG;IACpB,kBAAkB;IAClB,gBAAgB;IAChB,UAAU;CACF,CAAC;AAEX,qDAAqD;AACrD,MAAM,cAAc,GAAG;IACrB,kBAAkB;IAClB,gBAAgB;IAChB,UAAU;CACF,CAAC;AAEX,kDAAkD;AAClD,MAAM,WAAW,GAAG,CAAC,oBAAoB,CAAU,CAAC;AAEpD,gDAAgD;AAChD,MAAM,gBAAgB,GAAG;IACvB,eAAe;IACf,mBAAmB;IACnB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;CACP,CAAC;AAEX,kDAAkD;AAClD,MAAM,kBAAkB,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAU,CAAC;AAE1E,mDAAmD;AACnD,MAAM,mBAAmB,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAU,CAAC;AAE3E,yEAAyE;AACzE,MAAM,YAAY,GAAG,oDAAoD,CAAC;AAE1E,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,IAAuB,EACE,EAAE;IAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC;IAE7C,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,IAAsB,EACtB,OAAe,EACf,GAAW,EACQ,EAAE;IACrB,MAAM,OAAO,GACX,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAEtE,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC;QACjD,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;QACnD,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;KAC9C,CAAC;AACJ,CAAC,CAAC;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,kEAAkE;AAClE,MAAM,aAAa,GAAG,CACpB,IAAY,EACZ,SAAiC,EAC3B,EAAE;IACR,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC,CAAC;AASF,6EAA6E;AAC7E,MAAM,SAAS,GAAG,CAAC,OAAyB,EAAQ,EAAE;IACpD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IAC/C,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;IACrC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAElB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAEjC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;QAClC,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,cAAc,GAAG,CACrB,YAAoB,EACpB,aAAqB,EACrB,EAAoB,EACd,EAAE;IACR,CAAC,GAAG,aAAa,EAAE,GAAG,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAC9B,YAAY,EACZ,CAAC,KAAK,EAAE,QAAgB,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YAC7C,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;YACpC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YAErC,OAAO,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC,CACF,CAAC;QAEF,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;YACrC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAA+B,EAAQ,EAAE;IACvE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IAEtD,SAAS,CAAC;QACR,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,OAAO,CAAC,WAAW;QAC3B,OAAO,EAAE,KAAK,CAAC,YAAY;QAC3B,EAAE;KACH,CAAC,CAAC;IACH,SAAS,CAAC;QACR,KAAK,EAAE,cAAc;QACrB,MAAM,EAAE,OAAO,CAAC,YAAY;QAC5B,OAAO,EAAE,KAAK,CAAC,aAAa;QAC5B,EAAE;KACH,CAAC,CAAC;IACH,SAAS,CAAC;QACR,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,OAAO,CAAC,SAAS;QACzB,OAAO,EAAE,KAAK,CAAC,UAAU;QACzB,EAAE;KACH,CAAC,CAAC;IACH,SAAS,CAAC;QACR,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,OAAO,CAAC,aAAa;QAC7B,OAAO,EAAE,KAAK,CAAC,UAAU;QACzB,EAAE;KACH,CAAC,CAAC;IACH,SAAS,CAAC;QACR,KAAK,EAAE,kBAAkB;QACzB,MAAM,EAAE,OAAO,CAAC,eAAe;QAC/B,OAAO,EAAE,KAAK,CAAC,YAAY;QAC3B,EAAE;KACH,CAAC,CAAC;IACH,SAAS,CAAC;QACR,KAAK,EAAE,mBAAmB;QAC1B,MAAM,EAAE,OAAO,CAAC,gBAAgB;QAChC,OAAO,EAAE,KAAK,CAAC,aAAa;QAC5B,EAAE;KACH,CAAC,CAAC;IAEH,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,cAAc,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAC9D,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;IACzC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chief-clancy/brief",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Strategic brief generator for Claude Code — grill, decompose, and document feature ideas",
   "author": "Alex Clapperton",
   "license": "MIT",
@@ -39,6 +39,9 @@
     "src/workflows",
     "src/agents"
   ],
+  "dependencies": {
+    "@chief-clancy/scan": "0.2.0"
+  },
   "scripts": {
     "build": "rm -rf dist tsconfig.build.tsbuildinfo && tsc --project tsconfig.build.json && tsc-alias --project tsconfig.build.json",
     "test": "vitest run",

package/src/agents/devils-advocate.md

@@ -8,7 +8,7 @@ You receive 10-15 clarifying questions generated during the AI-grill phase of `/
 
 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.
+   - **Codebase**: use Glob, Grep, and Read to explore affected areas, check `.clancy/docs/` if available, 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.

package/src/workflows/approve-brief.md

@@ -8,39 +8,60 @@ Approve a reviewed strategic brief by creating child tickets on the board, linki
 
 ## Step 1 — Preflight checks
 
-1. Check `.clancy/` exists and `.clancy/.env` is present. If not:
+### 1. Detect installation context
 
-   ```
-   .clancy/ not found. Run /clancy:init to set up Clancy first.
-   ```
+Check for `.clancy/.env`:
 
-   Stop.
+- **Absent** → **standalone mode**. The brief package has been installed via `npx @chief-clancy/brief` but board credentials have never been configured. There is nothing approve-brief can do without a board (its job is to create tickets ON the board), so stop with:
 
-2. Source `.clancy/.env` and check board credentials are present.
+  ```
+  No board credentials found. Run /clancy:board-setup first to configure your board, then re-run /clancy:approve-brief.
+  ```
 
-3. Check `CLANCY_ROLES` includes `strategist` (or env var is unset, which indicates a global install where all roles are available). If `CLANCY_ROLES` is set but does not include `strategist`:
+  Stop.
 
-   ```
-   The Strategist role is not enabled. Add "strategist" to CLANCY_ROLES in .clancy/.env or run /clancy:settings.
-   ```
+- **Present** → continue to `.clancy/clancy-implement.js` check below.
 
-   Stop.
+If `.clancy/.env` is present, check for `.clancy/clancy-implement.js`:
 
-4. Branch freshness check:
+- **Present** → **terminal mode**. Full Clancy pipeline installed.
+- **Absent** → **standalone+board mode**. Board credentials available via `/clancy:board-setup`. Brief and plan are installed as standalone packages but the full pipeline (`clancy-implement.js`) is not.
 
-   ```bash
-   git fetch origin
-   ```
+The detected install mode is captured for Step 6's pipeline label decision.
 
-   Compare HEAD with `origin/$CLANCY_BASE_BRANCH`. If behind:
+### 2. Terminal-mode preflight (skip in standalone+board mode)
 
-   **AFK mode** (`--afk` flag or `CLANCY_MODE=afk`): auto-pull without prompting.
+If in **terminal mode** (`.clancy/.env` present AND `.clancy/clancy-implement.js` present):
 
-   **Interactive mode:**
+a. Source `.clancy/.env` and check board credentials are present.
 
-   ```
-   Behind by N commits. [1] Pull latest  [2] Continue  [3] Abort
-   ```
+b. Check `CLANCY_ROLES` includes `strategist` (or env var is unset, which indicates a global install where all roles are available). If `CLANCY_ROLES` is set but does not include `strategist`:
+
+```
+The Strategist role is not enabled. Add "strategist" to CLANCY_ROLES in .clancy/.env or run /clancy:settings.
+```
+
+Stop.
+
+### 3. Standalone+board preflight (only in standalone+board mode)
+
+If in **standalone+board mode**, source `.clancy/.env` and check board credentials are present (same presence check as the terminal-mode preflight above — an empty or partial `.clancy/.env` should fail loudly here, not later in Step 6/7). Standalone+board users came in via `npx @chief-clancy/brief` and `/clancy:board-setup`, so they have no `CLANCY_ROLES` configured and the strategist role check above does not apply.
+
+### 4. Branch freshness check (all modes)
+
+```bash
+git fetch origin
+```
+
+Compare HEAD with `origin/$CLANCY_BASE_BRANCH`. If behind:
+
+**AFK mode** (`--afk` flag or `CLANCY_MODE=afk`): auto-pull without prompting.
+
+**Interactive mode:**
+
+```
+Behind by N commits. [1] Pull latest  [2] Continue  [3] Abort
+```
 
 ---
 
@@ -298,14 +319,20 @@ Continue — omit parent fields from creation payloads. No tracking comment will
 
 Platform-specific pre-creation lookups.
 
-### GitHub
+### Pipeline label selection rule (applies to all six platforms below)
+
+Every child ticket gets exactly one pipeline label. The label determines which queue picks the ticket up downstream (`/clancy:plan` for the planning queue, `/clancy:implement` for the build queue). The selection rule, in order of precedence:
 
-**Pipeline label for children — this is mandatory, always apply a pipeline label to every child ticket.** Determine which label to use:
+1. `--skip-plan` flag is set → use `CLANCY_LABEL_BUILD` from `.clancy/.env` if set, otherwise `clancy:build`. The user has explicitly opted out of the planning queue for this run.
+2. Install mode is **standalone+board** (Step 1 detected this) → use `CLANCY_LABEL_PLAN` from `.clancy/.env` if set, otherwise `clancy:plan`. Standalone+board users have installed both `@chief-clancy/brief` and `@chief-clancy/plan` as standalone packages and clearly intend to use plan, even though they have no `CLANCY_ROLES` configured.
+3. Install mode is **terminal** AND `CLANCY_ROLES` includes `planner` (or `CLANCY_ROLES` is unset, indicating a global install where all roles are available) → use `CLANCY_LABEL_PLAN` from `.clancy/.env` if set, otherwise `clancy:plan`.
+4. Install mode is **terminal** AND `CLANCY_ROLES` is set but does NOT include `planner` → use `CLANCY_LABEL_BUILD` from `.clancy/.env` if set, otherwise `clancy:build`. The terminal user has explicitly opted out of the planning queue by not enabling the planner role.
+
+This rule replaces the per-platform fallthrough that used to live in each of the six platform subsections below. Each subsection now applies the rule rather than re-enumerating it. Apply the chosen label to each child ticket, creating it first only on platforms that require explicit label creation (the per-platform subsections below document which platforms auto-create vs require pre-creation).
+
+### GitHub
 
-- `--skip-plan` flag → use `CLANCY_LABEL_BUILD` from `.clancy/.env` if set, otherwise `clancy:build`
-- Planner role enabled (`CLANCY_ROLES` includes `planner`) → use `CLANCY_LABEL_PLAN` from `.clancy/.env` if set, otherwise `clancy:plan`
-- Planner role NOT enabled → use `CLANCY_LABEL_BUILD` from `.clancy/.env` if set, otherwise `clancy:build`
-  Ensure the label exists on the board (create it if missing), then add it to each child ticket.
+**Pipeline label for children — mandatory.** Apply the pipeline label per the rule above to every child ticket.
 
 **Labels to apply per ticket:**
 
@@ -362,7 +389,7 @@ Set CLANCY_BRIEF_ISSUE_TYPE in .clancy/.env.
 
 Stop.
 
-**Pipeline label for children — mandatory, same logic as GitHub.** Use `CLANCY_LABEL_PLAN` or `CLANCY_LABEL_BUILD` from `.clancy/.env` (defaults: `clancy:plan` / `clancy:build`). Always apply to every child ticket.
+**Pipeline label for children — mandatory.** Apply the pipeline label per the rule at the top of Step 6. Defaults: `clancy:plan` / `clancy:build`. Always apply to every child ticket.
 
 **Labels:** Jira auto-creates labels — no pre-creation needed. Apply: the pipeline label determined above, `clancy:afk` or `clancy:hitl`. `CLANCY_LABEL` is NOT applied to children when pipeline labels are active.
 
@@ -404,7 +431,7 @@ query {
 }
 ```
 
-**Pipeline label for children — mandatory, same logic as GitHub/Jira.** Use `CLANCY_LABEL_PLAN` or `CLANCY_LABEL_BUILD` from `.clancy/.env` (defaults: `clancy:plan` / `clancy:build`). Always apply to every child ticket.
+**Pipeline label for children — mandatory.** Apply the pipeline label per the rule at the top of Step 6. Defaults: `clancy:plan` / `clancy:build`. Always apply to every child ticket.
 
 For each required label (the pipeline label, `component:{CLANCY_COMPONENT}`, `clancy:afk`, `clancy:hitl`): search by exact name. `CLANCY_LABEL` is NOT applied to children when pipeline labels are active. If not found in team labels, check workspace labels:
 
@@ -448,7 +475,7 @@ curl -s \
 
 If the specified type is not found, stop with the available types listed.
 
-**Pipeline tag for children — mandatory, same logic as other boards.** Use `CLANCY_LABEL_PLAN` or `CLANCY_LABEL_BUILD` from `.clancy/.env` (defaults: `clancy:plan` / `clancy:build`). Tags are applied via the `System.Tags` field (semicolon-delimited).
+**Pipeline tag for children — mandatory.** Apply the pipeline tag determined by the rule at the top of Step 6. Defaults: `clancy:plan` / `clancy:build`. Tags are applied via the `System.Tags` field (semicolon-delimited).
 
 **Tags:** Azure DevOps auto-creates tags — no pre-creation needed. Apply: the pipeline tag, `clancy:afk` or `clancy:hitl`. `CLANCY_LABEL` is NOT applied to children when pipeline tags are active.
 
@@ -467,7 +494,7 @@ Use `authenticatedUser.providerDisplayName` for the `System.AssignedTo` field.
 
 **Story type:** Shortcut creates stories by default. Use `story_type` field if needed (`feature`, `bug`, `chore` — default: `feature`).
 
-**Pipeline label for children — mandatory, same logic as other boards.** Use `CLANCY_LABEL_PLAN` or `CLANCY_LABEL_BUILD` from `.clancy/.env` (defaults: `clancy:plan` / `clancy:build`).
+**Pipeline label for children — mandatory.** Apply the pipeline label per the rule at the top of Step 6. Defaults: `clancy:plan` / `clancy:build`.
 
 **Labels:** Resolve label IDs via `GET /api/v3/labels`. If the required label does not exist, create it:
 
@@ -494,7 +521,7 @@ Use `id` as the `owner_ids` value for story creation.
 
 ### Notion
 
-**Pipeline label for children — mandatory, same logic as other boards.** Use `CLANCY_LABEL_PLAN` or `CLANCY_LABEL_BUILD` from `.clancy/.env` (defaults: `clancy:plan` / `clancy:build`). Labels are applied via multi-select properties.
+**Pipeline label for children — mandatory.** Apply the pipeline label per the rule at the top of Step 6. Defaults: `clancy:plan` / `clancy:build`. Labels are applied via multi-select properties.
 
 **Labels:** Notion auto-creates multi-select options when first used — no pre-creation needed. Apply: the pipeline label, `clancy:afk` or `clancy:hitl`. `CLANCY_LABEL` is NOT applied to children when pipeline labels are active.
 

package/src/workflows/brief.md

@@ -582,7 +582,7 @@ Same relentless energy as the human grill, but directed at the strategist itself
    - The path to the agent prompt: `.claude/clancy/agents/devils-advocate.md`
 
 3. The devil's advocate agent answers each question by INTERROGATING ITS SOURCES:
-   - **Codebase:** explore affected areas, read `.clancy/docs/`, check existing patterns. Don't assume — look.
+   - **Codebase:** explore affected areas, read `.clancy/docs/` if available, check existing patterns. Don't assume — look.
    - **Board:** parent ticket, related tickets, existing children. Check for conflicting requirements.
    - **Web:** when the question involves external technology, patterns, or third-party integrations. Same trigger as Step 6: `--research` flag forces it, otherwise judgement-based.
 
@@ -695,7 +695,7 @@ Web research agent (adds 1 to the count above, max 4 total):
 
 ### What agents explore
 
-- `.clancy/docs/` — STACK.md, ARCHITECTURE.md, CONVENTIONS.md, TESTING.md, DESIGN-SYSTEM.md
+- `.clancy/docs/` (if available) — STACK.md, ARCHITECTURE.md, CONVENTIONS.md, TESTING.md, DESIGN-SYSTEM.md
 - Affected code areas via Glob + Read
 - Board for duplicates/related tickets (text-match against title):
   - **GitHub:** `GET /repos/$GITHUB_REPO/issues?state=open&per_page=30` and text-match

package/src/workflows/workflows.test.ts

@@ -55,6 +55,204 @@ describe('workflows directory structure', () => {
   });
 });
 
+// ---------------------------------------------------------------------------
+// approve-brief Step 1 install-mode preflight assertions
+// ---------------------------------------------------------------------------
+
+describe('approve-brief Step 1 install-mode preflight', () => {
+  const content = readFileSync(
+    new URL('approve-brief.md', import.meta.url),
+    'utf8',
+  );
+
+  it('detects three installation states', () => {
+    expect(content).toContain('standalone mode');
+    expect(content).toContain('standalone+board mode');
+    expect(content).toContain('terminal mode');
+  });
+
+  it('uses the same env-var probes as approve-plan and plan workflows', () => {
+    // Schema-pair contract: must mirror approve-plan.md and plan.md exactly.
+    expect(content).toContain('.clancy/.env');
+    expect(content).toContain('.clancy/clancy-implement.js');
+  });
+
+  it('hard-stops in standalone mode with the board-setup message', () => {
+    expect(content).toContain('No board credentials found');
+    expect(content).toContain('Run /clancy:board-setup first');
+  });
+
+  it('does NOT use the old /clancy:init standalone hard-stop', () => {
+    expect(content).not.toContain('Run /clancy:init to set up Clancy first');
+  });
+
+  it('terminal-mode preflight gates the strategist role check', () => {
+    expect(content).toContain(
+      '### 2. Terminal-mode preflight (skip in standalone+board mode)',
+    );
+    expect(content).toContain('CLANCY_ROLES` includes `strategist`');
+  });
+
+  it('standalone+board preflight notes the strategist role check does not apply', () => {
+    expect(content).toContain(
+      '### 3. Standalone+board preflight (only in standalone+board mode)',
+    );
+    expect(content).toContain('strategist role check above does not apply');
+  });
+
+  it('captures the install mode for Step 6 to read', () => {
+    expect(content).toContain(
+      "The detected install mode is captured for Step 6's pipeline label decision",
+    );
+  });
+});
+
+// ---------------------------------------------------------------------------
+// approve-brief Step 6 pipeline label selection rule
+// ---------------------------------------------------------------------------
+
+describe('approve-brief Step 6 pipeline label selection rule', () => {
+  const content = readFileSync(
+    new URL('approve-brief.md', import.meta.url),
+    'utf8',
+  );
+
+  it('has the preamble heading at the top of Step 6', () => {
+    expect(content).toContain(
+      '### Pipeline label selection rule (applies to all six platforms below)',
+    );
+  });
+
+  it('preamble enumerates rule 1 — --skip-plan flag uses build label', () => {
+    expect(content).toMatch(
+      /1\. `--skip-plan` flag is set → use `CLANCY_LABEL_BUILD`/,
+    );
+  });
+
+  it('preamble enumerates rule 2 — standalone+board uses plan label', () => {
+    expect(content).toMatch(
+      /2\. Install mode is \*\*standalone\+board\*\*[^\n]*→ use `CLANCY_LABEL_PLAN`/,
+    );
+  });
+
+  it('preamble enumerates rule 3 — terminal + planner enabled uses plan label', () => {
+    expect(content).toMatch(
+      /3\. Install mode is \*\*terminal\*\* AND `CLANCY_ROLES` includes `planner`[^\n]*→ use `CLANCY_LABEL_PLAN`/,
+    );
+  });
+
+  it('preamble enumerates rule 4 — terminal + planner not enabled uses build label', () => {
+    expect(content).toMatch(
+      /4\. Install mode is \*\*terminal\*\* AND `CLANCY_ROLES` is set but does NOT include `planner` → use `CLANCY_LABEL_BUILD`/,
+    );
+  });
+
+  it('GitHub subsection delegates to the preamble (no inline 3-rule fallthrough)', () => {
+    expect(content).toContain(
+      'Apply the pipeline label per the rule above to every child ticket',
+    );
+    // The old per-platform fallthrough must be gone — no leftover
+    // "Planner role enabled" / "Planner role NOT enabled" lines anywhere.
+    expect(content).not.toContain('Planner role enabled');
+    expect(content).not.toContain('Planner role NOT enabled');
+  });
+
+  it('all five non-GitHub platform subsections delegate to the preamble', () => {
+    // Each non-GitHub platform must reference the preamble explicitly
+    // and must NOT use the old "same logic as GitHub/other boards" wording.
+    expect(content).not.toContain('same logic as GitHub');
+    expect(content).not.toContain('same logic as other boards');
+
+    // GitHub uses "above"; the other 5 use "at the top of Step 6". Of those
+    // 5, four are "pipeline label per the rule" (Jira, Linear, Shortcut,
+    // Notion) and one is "pipeline tag determined by the rule" (Azure
+    // DevOps, which uses System.Tags rather than labels).
+    const labelDelegations = content.match(
+      /Apply the pipeline label per the rule at the top of Step 6/g,
+    );
+    const tagDelegations = content.match(
+      /Apply the pipeline tag determined by the rule at the top of Step 6/g,
+    );
+
+    expect(labelDelegations).not.toBeNull();
+    expect(labelDelegations?.length).toBe(4);
+    expect(tagDelegations).not.toBeNull();
+    expect(tagDelegations?.length).toBe(1);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// approve-brief test permissiveness audit
+// ---------------------------------------------------------------------------
+
+describe('approve-brief test regex permissiveness audit', () => {
+  // These tests guard against the `\\?d` class of trap from
+  // feedback_workflow_md_gotchas.md by walking through the simplest wrong
+  // inputs that the regexes above SHOULD reject.
+  const content = readFileSync(
+    new URL('approve-brief.md', import.meta.url),
+    'utf8',
+  );
+
+  /**
+   * Slice the workflow content between two literal markers, asserting both
+   * markers are present AND the end marker comes after the start marker.
+   * Without these guards a missing marker would return -1 from indexOf,
+   * which slice() interprets as a negative index — that produces a
+   * substring counted from the END of the file and silently passes
+   * (or silently fails) the body assertions for the wrong reason. Per
+   * Copilot finding on PR #222 + the test permissiveness audit discipline.
+   */
+  const sliceBetween = (start: string, end: string): string => {
+    const startIdx = content.indexOf(start);
+    const endIdx = content.indexOf(end);
+
+    expect(startIdx, `start marker not found: ${start}`).toBeGreaterThanOrEqual(
+      0,
+    );
+    expect(endIdx, `end marker not found: ${end}`).toBeGreaterThanOrEqual(0);
+    expect(endIdx, `end marker before start marker`).toBeGreaterThan(startIdx);
+
+    return content.slice(startIdx, endIdx);
+  };
+
+  it('rule-2 body does NOT contain a swapped label', () => {
+    // Sanity check: rule 2 must reference CLANCY_LABEL_PLAN, not _BUILD.
+    // If someone accidentally swapped the labels in the preamble, the
+    // existing rule-2 assertion above would still match the heading; this
+    // assertion makes the swap fail loudly.
+    const rule2ToRule3 = sliceBetween(
+      '2. Install mode is **standalone+board**',
+      '3. Install mode is **terminal** AND `CLANCY_ROLES` includes `planner`',
+    );
+
+    expect(rule2ToRule3).not.toContain('CLANCY_LABEL_BUILD');
+  });
+
+  it('rule-3 body does NOT contain a swapped label', () => {
+    // Symmetric to rule-2 / rule-4. Rule 3 must reference CLANCY_LABEL_PLAN.
+    const rule3ToRule4 = sliceBetween(
+      '3. Install mode is **terminal** AND `CLANCY_ROLES` includes `planner`',
+      '4. Install mode is **terminal** AND `CLANCY_ROLES` is set but does NOT include `planner`',
+    );
+
+    expect(rule3ToRule4).not.toContain('CLANCY_LABEL_BUILD');
+  });
+
+  it('rule-4 body does NOT contain a swapped label', () => {
+    // Symmetric to the rule-2 check: rule 4 must reference
+    // CLANCY_LABEL_BUILD, not _PLAN. Slice from rule-4 to the rule-block
+    // terminator paragraph (the "This rule replaces..." line that follows
+    // rule 4 in the preamble).
+    const rule4ToTerminator = sliceBetween(
+      '4. Install mode is **terminal** AND `CLANCY_ROLES` is set but does NOT include `planner`',
+      'This rule replaces the per-platform fallthrough',
+    );
+
+    expect(rule4ToTerminator).not.toContain('CLANCY_LABEL_PLAN');
+  });
+});
+
 // ---------------------------------------------------------------------------
 // board-setup.md content assertions
 // ---------------------------------------------------------------------------