@chief-clancy/plan 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/README.md

@@ -0,0 +1,81 @@
+# @chief-clancy/plan
+
+**Implementation planner for Claude Code.**
+
+[![npm](https://img.shields.io/npm/v/@chief-clancy/plan?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/@chief-clancy/plan) [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](https://github.com/Pushedskydiver/chief-clancy/blob/main/LICENSE)
+
+```bash
+npx @chief-clancy/plan
+```
+
+Fetch backlog tickets from your board, explore the codebase, and generate structured implementation plans posted as comments for human review. Works with board credentials — no full pipeline required.
+
+## What it does
+
+The `/clancy:plan` slash command explores your codebase, runs a feasibility scan, and produces a plan with:
+
+- Summary and implementation approach
+- Affected files table (file, change type, description)
+- Test strategy (specific tests to write)
+- Acceptance criteria (testable conditions)
+- Dependencies and blockers
+- Risks and considerations
+- Size estimate (S/M/L)
+
+## How it works
+
+1. **Install:** `npx @chief-clancy/plan` — choose global or local
+2. **Configure board:** `/clancy:board-setup` — connect to your project board
+3. **Run:** `/clancy:plan PROJ-123` — plan a specific ticket
+
+Plans are posted as comments on the ticket for human review.
+
+## Input modes
+
+| Mode            | Example                                     | Board needed?               |
+| --------------- | ------------------------------------------- | --------------------------- |
+| Specific ticket | `/clancy:plan PROJ-123`, `/clancy:plan #42` | Yes (`/clancy:board-setup`) |
+| Batch           | `/clancy:plan 3`                            | Yes (`/clancy:board-setup`) |
+| Queue (default) | `/clancy:plan`                              | Yes (`/clancy:board-setup`) |
+
+## Flags
+
+| Flag      | Description                          |
+| --------- | ------------------------------------ |
+| `--afk`   | Auto-confirm all prompts             |
+| `--fresh` | Discard existing plan and start over |
+
+## Board ticket mode
+
+To plan 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:plan PROJ-123` (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.
+
+## Full pipeline
+
+For the complete development pipeline (brief, plan, implement, deliver), install the full Clancy package:
+
+```bash
+npx chief-clancy
+```
+
+## Part of the Clancy monorepo
+
+- [`chief-clancy`](https://www.npmjs.com/package/chief-clancy) — full pipeline (install, configure, implement, autopilot)
+- [`@chief-clancy/brief`](https://www.npmjs.com/package/@chief-clancy/brief) — strategic brief generator
+- [`@chief-clancy/terminal`](https://www.npmjs.com/package/@chief-clancy/terminal) — installer, slash commands, hooks, runners
+- [`@chief-clancy/core`](https://www.npmjs.com/package/@chief-clancy/core) — board integrations, pipeline phases, schemas
+
+## Credits
+
+Built on the [Ralph technique](https://ghuntley.com/ralph/) by Geoffrey Huntley. See [CREDITS.md](https://github.com/Pushedskydiver/chief-clancy/blob/main/CREDITS.md).
+
+## License
+
+MIT — see [LICENSE](https://github.com/Pushedskydiver/chief-clancy/blob/main/LICENSE).

package/bin/plan.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+
+/**
+ * Plan installer — CLI entry point for `npx @chief-clancy/plan`.
+ *
+ * Self-contained installer that copies the plan slash command and workflow
+ * 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 planRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+
+const sources = {
+  commandsDir: join(planRoot, 'src', 'commands'),
+  workflowsDir: join(planRoot, 'src', 'workflows'),
+};
+
+// ---------------------------------------------------------------------------
+// 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));
+
+// ---------------------------------------------------------------------------
+// File lists (keep in sync with install.ts)
+// ---------------------------------------------------------------------------
+
+const COMMAND_FILES = ['board-setup.md', 'plan.md'];
+const WORKFLOW_FILES = ['board-setup.md', 'plan.md'];
+
+// ---------------------------------------------------------------------------
+// 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 inlineWorkflows(commandsDest, workflowsDest) {
+  const WORKFLOW_REF = /^@\.claude\/clancy\/workflows\/([^/\\]+\.md)\r?$/gm;
+
+  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;
+      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/plan again.'));
+  rl.close();
+  process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function main() {
+  console.log('');
+  console.log(blue('  Clancy Plan'));
+  console.log(
+    `  ${bold(`v${pkg.version}`)}${dim('  Implementation planner 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');
+
+  console.log(dim(`  Installing to: ${commandsDest}`));
+
+  // Create directories
+  mkdirSync(commandsDest, { recursive: true });
+  mkdirSync(workflowsDest, { recursive: true });
+
+  // Copy files
+  COMMAND_FILES.forEach((f) =>
+    copyChecked(join(sources.commandsDir, f), join(commandsDest, f)),
+  );
+  WORKFLOW_FILES.forEach((f) =>
+    copyChecked(join(sources.workflowsDir, f), join(workflowsDest, f)),
+  );
+
+  // Inline workflows for global mode
+  if (mode === 'global') {
+    inlineWorkflows(commandsDest, workflowsDest);
+  }
+
+  // Write version marker
+  const versionPath = join(commandsDest, 'VERSION.plan');
+  rejectSymlink(versionPath);
+  writeFileSync(versionPath, pkg.version);
+
+  // Success
+  console.log('');
+  console.log(green('  ✓ Clancy Plan installed successfully.'));
+  console.log('');
+  console.log('  Commands available:');
+  console.log(
+    `      ${cyan('/clancy:plan')}           ${dim('Generate an implementation plan')}`,
+  );
+  console.log(
+    `      ${cyan('/clancy:board-setup')}    ${dim('Configure board credentials (optional)')}`,
+  );
+  console.log('');
+  console.log('  Next steps:');
+  console.log(`    1. Open a project in Claude Code`);
+  console.log(`    2. Run: ${cyan('/clancy:plan TICKET-123')}`);
+  console.log('');
+  console.log(dim('  Want to plan board tickets?'));
+  console.log(dim(`    Run: ${cyan('/clancy:board-setup')}`));
+  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/plan
+ *
+ * Implementation planner for Claude Code — decompose briefs into
+ * actionable plans. Ships the `/clancy:plan` slash command
+ * and a lightweight installer.
+ */
+export declare const PACKAGE_NAME: "@chief-clancy/plan";
+//# 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,oBAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @chief-clancy/plan
+ *
+ * Implementation planner for Claude Code — decompose briefs into
+ * actionable plans. Ships the `/clancy:plan` slash command
+ * and a lightweight installer.
+ */
+export const PACKAGE_NAME = '@chief-clancy/plan';
+//# 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,oBAA6B,CAAC"}

package/dist/installer/install.d.ts

@@ -0,0 +1,62 @@
+/** The install target — global (`~/.claude`) or local (`./.claude`). */
+export type PlanInstallMode = 'global' | 'local';
+/** All resolved destination paths for a plan installation. */
+export type PlanInstallPaths = {
+    readonly commandsDest: string;
+    readonly workflowsDest: string;
+};
+/** Source directories within the npm package. */
+type PlanInstallSources = {
+    readonly commandsDir: string;
+    readonly workflowsDir: string;
+};
+/**
+ * File system operations the installer performs.
+ *
+ * `mkdir` must be idempotent (recursive, ignoring EEXIST).
+ */
+type PlanInstallerFs = {
+    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 runPlanInstall}. */
+export type RunPlanInstallOptions = {
+    readonly mode: PlanInstallMode;
+    readonly paths: PlanInstallPaths;
+    readonly sources: PlanInstallSources;
+    readonly version: string;
+    readonly fs: PlanInstallerFs;
+};
+/**
+ * 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 parsePlanInstallFlag: (args: readonly string[]) => PlanInstallMode | null;
+/**
+ * Compute all destination paths for a plan 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 resolvePlanInstallPaths: (mode: PlanInstallMode, homeDir: string, cwd: string) => PlanInstallPaths;
+/**
+ * Run the plan installation pipeline.
+ *
+ * Copies command and workflow files to the target directory.
+ * For global mode, inlines workflow content into the command file.
+ * Writes a VERSION.plan marker with the package version.
+ *
+ * @param options - All dependencies and configuration.
+ */
+export declare const runPlanInstall: (options: RunPlanInstallOptions) => 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,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjD,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,iDAAiD;AACjD,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,KAAK,eAAe,GAAG;IACrB,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,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;CAC9B,CAAC;AAmBF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,SAAS,MAAM,EAAE,KACtB,eAAe,GAAG,IAKpB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,eAAe,EACrB,SAAS,MAAM,EACf,KAAK,MAAM,KACV,gBAQF,CAAC;AA4EF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,qBAAqB,KAAG,IAuB/D,CAAC"}

package/dist/installer/install.js

@@ -0,0 +1,126 @@
+/**
+ * Plan installer — self-contained module for `npx @chief-clancy/plan`.
+ *
+ * Copies the plan slash command and workflow 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 plan package. */
+const COMMAND_FILES = ['board-setup.md', 'plan.md'];
+/** Workflow files shipped with the plan package. */
+const WORKFLOW_FILES = ['board-setup.md', 'plan.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 parsePlanInstallFlag = (args) => {
+    if (args.includes('--global'))
+        return 'global';
+    if (args.includes('--local'))
+        return 'local';
+    return null;
+};
+/**
+ * Compute all destination paths for a plan 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 resolvePlanInstallPaths = (mode, homeDir, cwd) => {
+    const baseDir = mode === 'global' ? join(homeDir, '.claude') : join(cwd, '.claude');
+    return {
+        commandsDest: join(baseDir, 'commands', 'clancy'),
+        workflowsDest: join(baseDir, 'clancy', 'workflows'),
+    };
+};
+// ---------------------------------------------------------------------------
+// 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 plan installation pipeline.
+ *
+ * Copies command and workflow files to the target directory.
+ * For global mode, inlines workflow content into the command file.
+ * Writes a VERSION.plan marker with the package version.
+ *
+ * @param options - All dependencies and configuration.
+ */
+export const runPlanInstall = (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,
+    });
+    if (mode === 'global') {
+        inlineWorkflow(paths.commandsDest, paths.workflowsDest, fs);
+    }
+    const versionPath = join(paths.commandsDest, 'VERSION.plan');
+    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/plan",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Implementation planner for Claude Code — decompose briefs into actionable plans",
+  "author": "Alex Clapperton",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pushedskydiver/chief-clancy.git",
+    "directory": "packages/plan"
+  },
+  "homepage": "https://github.com/Pushedskydiver/chief-clancy#readme",
+  "bugs": {
+    "url": "https://github.com/Pushedskydiver/chief-clancy/issues"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "plan",
+    "planning",
+    "slash-commands",
+    "developer-tools"
+  ],
+  "type": "module",
+  "bin": {
+    "clancy-plan": "./bin/plan.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "src/commands",
+    "src/workflows"
+  ],
+  "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/commands/board-setup.md

@@ -0,0 +1,11 @@
+# /clancy:board-setup
+
+Configure board credentials for standalone plan usage. Connects your project to a Kanban board so you can plan from board tickets.
+
+Not needed if you have the full Clancy pipeline installed (`npx chief-clancy`) — use `/clancy:settings` instead.
+
+Supported boards: Jira, GitHub Issues, Linear, Shortcut, Notion, Azure DevOps.
+
+@.claude/clancy/workflows/board-setup.md
+
+Follow the board setup workflow above. Collect credentials, verify the connection, and write them to `.clancy/.env`.

package/src/commands/commands.test.ts

@@ -0,0 +1,39 @@
+/**
+ * Structural tests for plan command files.
+ *
+ * Verifies the commands directory contains the expected markdown files
+ * that the plan installer depends on.
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+import { describe, expect, it } from 'vitest';
+
+const COMMANDS_DIR = fileURLToPath(new URL('.', import.meta.url));
+
+const EXPECTED_COMMANDS = ['board-setup.md', 'plan.md'];
+
+describe('commands directory structure', () => {
+  it('contains exactly the expected command files', () => {
+    const commands = readdirSync(COMMANDS_DIR)
+      .filter((f) => f.endsWith('.md'))
+      .sort();
+
+    expect(commands).toEqual([...EXPECTED_COMMANDS].sort());
+  });
+
+  it('all command files start with a heading', () => {
+    const issues: string[] = [];
+
+    EXPECTED_COMMANDS.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([]);
+  });
+});