create-claude-cabinet 0.11.1 → 0.12.0

package/README.md

@@ -1,7 +1,7 @@
 # Claude Cabinet
 
 A cabinet of expert advisors for your Claude Code project. One command
-gives Claude a memory, 20 domain experts, a planning process, and the
+gives Claude a memory, 27 domain experts, a planning process, and the
 habit of starting sessions informed and ending them properly.
 
 Built by a guy who'd rather talk to Claude than write code. Most of it
@@ -12,7 +12,7 @@ was built by Claude. I just complained until it worked.
 Your project gets a cabinet — specialist advisors who each own a domain
 and weigh in when their expertise matters:
 
-- **Cabinet members** — 20 domain experts (security, accessibility,
+- **Cabinet members** — 27 domain experts (security, accessibility,
   architecture, QA, etc.) who review your project and surface what
   you'd miss alone
 - **Briefings** — project context members read before weighing in
@@ -37,7 +37,9 @@ say `/onboard`. It'll interview you about your project and set everything
 up based on your answers.
 
 **New to this?** See [GETTING-STARTED.md](GETTING-STARTED.md) for a
-step-by-step walkthrough.
+step-by-step walkthrough. Then [WORKFLOW-GUIDE.md](WORKFLOW-GUIDE.md)
+for how to use everything — when to plan, when to audit, what the
+cabinet does for you, and how the system grows with your project.
 
 ### For developers
 
@@ -183,7 +185,7 @@ source code.
 └── settings.json    # hook configuration
 
 scripts/
-├── pib-db.js        # work tracking CLI (if installed)
+├── pib-db.mjs        # work tracking CLI (if installed)
 └── ...              # triage tools (if audit installed)
 
 .ccrc.json           # installation metadata

package/lib/cli.js

@@ -163,6 +163,70 @@ function generateSkillIndex(projectDir) {
   const skillsDir = path.join(projectDir, '.claude', 'skills');
   if (!fs.existsSync(skillsDir)) return 0;
 
+  // Read project directive overlay if it exists
+  const projectDirectives = {};
+  const directivesFile = path.join(projectDir, '.claude', 'cabinet', 'directives-project.yaml');
+  if (fs.existsSync(directivesFile)) {
+    const dContent = fs.readFileSync(directivesFile, 'utf8');
+    // Parse simple YAML: top-level keys are member names, nested keys are
+    // standing-mandate (list) and directives (map)
+    let currentMember = null;
+    let inDirectives = false;
+    let currentDirectiveKey = null;
+    let currentDirectiveValue = '';
+    for (const line of dContent.split('\n')) {
+      if (/^\s*#/.test(line) || line.trim() === '') continue;
+      const indent = line.length - line.trimStart().length;
+      const content = line.trim();
+
+      // Flush previous directive value
+      if (currentDirectiveKey && indent <= 4 && !/^\s/.test(line.charAt(0)) || (indent <= 4 && currentDirectiveKey)) {
+        if (currentMember && currentDirectiveKey) {
+          if (!projectDirectives[currentMember]) projectDirectives[currentMember] = {};
+          if (!projectDirectives[currentMember].directives) projectDirectives[currentMember].directives = {};
+          projectDirectives[currentMember].directives[currentDirectiveKey] = currentDirectiveValue.trim();
+        }
+        currentDirectiveKey = null;
+        currentDirectiveValue = '';
+      }
+
+      if (indent === 0) {
+        // Top-level: member name
+        const m = content.match(/^(cabinet-[\w-]+):\s*$/);
+        if (m) {
+          currentMember = m[1];
+          projectDirectives[currentMember] = projectDirectives[currentMember] || {};
+          inDirectives = false;
+        }
+      } else if (indent === 2 && currentMember) {
+        const kv = content.match(/^([\w-]+):\s*(.*)$/);
+        if (kv) {
+          if (kv[1] === 'standing-mandate') {
+            // Parse [item1, item2] or item1, item2
+            const val = kv[2].replace(/^\[|\]$/g, '');
+            projectDirectives[currentMember].standingMandate = val.split(/,\s*/).map(s => s.trim()).filter(Boolean);
+            inDirectives = false;
+          } else if (kv[1] === 'directives') {
+            inDirectives = true;
+          }
+        }
+      } else if (indent === 4 && inDirectives && currentMember) {
+        const kv = content.match(/^([\w-]+):\s*(.*)$/);
+        if (kv) {
+          currentDirectiveKey = kv[1];
+          currentDirectiveValue = kv[2].replace(/^[>|]\s*$/, '');
+        }
+      } else if (indent >= 6 && currentDirectiveKey) {
+        currentDirectiveValue += ' ' + content;
+      }
+    }
+    // Flush last directive
+    if (currentMember && currentDirectiveKey) {
+      if (!projectDirectives[currentMember].directives) projectDirectives[currentMember].directives = {};
+      projectDirectives[currentMember].directives[currentDirectiveKey] = currentDirectiveValue.trim();
+    }
+  }
+
   const entries = [];
   const dirs = fs.readdirSync(skillsDir, { withFileTypes: true });
   for (const dir of dirs) {
@@ -202,6 +266,21 @@ function generateSkillIndex(projectDir) {
       entry.directives = fm.directives;
     }
 
+    // Merge project directive overlay (if any)
+    const overlay = projectDirectives[dir.name];
+    if (overlay) {
+      // Append project standing mandates (union, no duplicates)
+      if (overlay.standingMandate) {
+        const existing = entry.standingMandate || [];
+        const merged = [...new Set([...existing, ...overlay.standingMandate])];
+        entry.standingMandate = merged;
+      }
+      // Merge project directives (project wins on conflict)
+      if (overlay.directives) {
+        entry.directives = { ...(entry.directives || {}), ...overlay.directives };
+      }
+    }
+
     entries.push(entry);
   }
 
@@ -225,7 +304,7 @@ const MODULES = {
     name: 'Session Loop (orient + debrief)',
     description: 'The briefing cycle. Claude starts each session informed, ends by preparing the next briefing.',
     mandatory: true,
-    templates: ['skills/orient', 'skills/orient-quick', 'skills/debrief', 'skills/debrief-quick', 'skills/debrief/phases/upstream-feedback.md', 'skills/menu', 'hooks/stop-hook.md'],
+    templates: ['skills/orient', 'skills/orient-quick', 'skills/debrief', 'skills/debrief-quick', 'skills/debrief/phases/upstream-feedback.md', 'skills/menu'],
   },
   'hooks': {
     name: 'Git Guardrails + Telemetry',
@@ -241,7 +320,7 @@ const MODULES = {
     mandatory: false,
     default: true,
     lean: false,
-    templates: ['scripts/pib-db.js', 'scripts/pib-db-schema.sql', 'scripts/work-tracker-server.mjs', 'scripts/work-tracker-ui.html', 'skills/work-tracker'],
+    templates: ['scripts/pib-db.mjs', 'scripts/pib-db-schema.sql', 'scripts/work-tracker-server.mjs', 'scripts/work-tracker-ui.html', 'skills/work-tracker'],
     needsDb: true,
   },
   'planning': {
@@ -311,7 +390,7 @@ const MODULES = {
     default: true,
     lean: false,
     needsOmega: true,
-    templates: ['skills/memory', 'scripts/cabinet-memory-adapter.py', 'rules/memory-capture.md'],
+    templates: ['skills/memory', 'scripts/cabinet-memory-adapter.py', 'rules/memory-capture.md', 'hooks/omega-memory-guard.sh'],
   },
 };
 
@@ -542,7 +621,7 @@ async function run() {
     selectedModules = Object.keys(MODULES);
     if (flags.noDb) {
       includeDb = false;
-      // work-tracking templates are still copied (pib-db.js, schema) but
+      // work-tracking templates are still copied (pib-db.mjs, schema) but
       // the DB isn't initialized. Mark it as skipped so /onboard knows
       // to ask about the alternative work tracking system.
       selectedModules = selectedModules.filter(m => m !== 'work-tracking');
@@ -766,7 +845,8 @@ async function run() {
 
   // --- Merge hooks into settings.json ---
   if (selectedModules.includes('hooks') && !flags.dryRun) {
-    const settingsPath = mergeSettings(projectDir, { includeDb });
+    const includeMemory = selectedModules.includes('memory');
+    const settingsPath = mergeSettings(projectDir, { includeDb, includeMemory });
     console.log(`  ⚙️  Merged hooks into ${path.relative(projectDir, settingsPath)}`);
   }
 
@@ -777,7 +857,7 @@ async function run() {
       for (const r of dbResults) console.log(`  🗄️  ${r}`);
     } catch (err) {
       console.log(`  ⚠ Database setup failed: ${err.message}`);
-      console.log('    You can set it up later: node scripts/pib-db.js init');
+      console.log('    You can set it up later: node scripts/pib-db.mjs init');
     }
   }
 

package/lib/db-setup.js

@@ -4,7 +4,7 @@ const path = require('path');
 
 /**
  * Set up the PIB database in the target project.
- * - Copies pib-db.js and schema to scripts/
+ * - Copies pib-db.mjs and schema to scripts/
  * - Runs npm init if no package.json
  * - Installs better-sqlite3
  * - Runs pib-db init
@@ -21,14 +21,8 @@ function setupDb(projectDir) {
     results.push('Created package.json');
   }
 
-  // pib-db.js uses ESM imports — ensure package.json has "type": "module"
-  // Skip this for the CC source repo itself (its CLI uses CommonJS)
-  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-  if (pkg.type !== 'module' && pkg.name !== 'create-claude-cabinet') {
-    pkg.type = 'module';
-    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
-    results.push('Set package.json type to "module"');
-  }
+  // pib-db.mjs uses ESM imports — .mjs extension lets Node treat it as ESM
+  // regardless of the project's package.json type field
 
   // Install better-sqlite3 if not already installed
   const nodeModules = path.join(projectDir, 'node_modules', 'better-sqlite3');
@@ -39,7 +33,7 @@ function setupDb(projectDir) {
   }
 
   // Initialize the database
-  const dbScript = path.join(scriptsDir, 'pib-db.js');
+  const dbScript = path.join(scriptsDir, 'pib-db.mjs');
   if (fs.existsSync(dbScript)) {
     console.log('  Initializing database...');
     execSync(`node ${dbScript} init`, { cwd: projectDir, stdio: 'pipe' });

package/lib/settings-merge.js

@@ -1,6 +1,20 @@
 const fs = require('fs');
 const path = require('path');
 
+const MEMORY_HOOKS = {
+  PreToolUse: [
+    {
+      matcher: 'Edit|Write',
+      hooks: [
+        {
+          type: 'command',
+          command: '.claude/hooks/omega-memory-guard.sh',
+        },
+      ],
+    },
+  ],
+};
+
 const DEFAULT_HOOKS = {
   PreToolUse: [
     {
@@ -50,7 +64,7 @@ const DEFAULT_HOOKS = {
  * Merge PIB hooks into the project's .claude/settings.json.
  * Creates the file if it doesn't exist. Preserves existing hooks.
  */
-function mergeSettings(projectDir, { includeDb = true } = {}) {
+function mergeSettings(projectDir, { includeDb = true, includeMemory = false } = {}) {
   const settingsDir = path.join(projectDir, '.claude');
   const settingsPath = path.join(settingsDir, 'settings.json');
 
@@ -81,8 +95,20 @@ function mergeSettings(projectDir, { includeDb = true } = {}) {
     });
   }
 
+  // Build the full hook set — include memory hooks if memory module is selected
+  const allHooks = { ...DEFAULT_HOOKS };
+  if (includeMemory) {
+    for (const [event, hooks] of Object.entries(MEMORY_HOOKS)) {
+      if (!allHooks[event]) {
+        allHooks[event] = hooks;
+      } else {
+        allHooks[event] = [...allHooks[event], ...hooks];
+      }
+    }
+  }
+
   // Merge each hook event type
-  for (const [event, newHooks] of Object.entries(DEFAULT_HOOKS)) {
+  for (const [event, newHooks] of Object.entries(allHooks)) {
     if (!settings.hooks[event]) {
       settings.hooks[event] = newHooks;
     } else {
@@ -106,4 +132,4 @@ function mergeSettings(projectDir, { includeDb = true } = {}) {
   return settingsPath;
 }
 
-module.exports = { mergeSettings, DEFAULT_HOOKS };
+module.exports = { mergeSettings, DEFAULT_HOOKS, MEMORY_HOOKS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-claude-cabinet",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "Claude Cabinet — opinionated process scaffolding for Claude Code projects",
   "bin": {
     "create-claude-cabinet": "bin/create-claude-cabinet.js"

package/templates/EXTENSIONS.md

@@ -226,8 +226,8 @@ command queue processing (needed by any project with an async work queue).
 
 ## Writing Domain-Specific Cabinet Members
 
-CC ships 14 generic cabinet members. Flow has 19 additional domain-specific
-cabinet members. Here are three examples showing how to write your own.
+CC ships 27 generic cabinet members. Your project can add domain-specific
+cabinet members on top of these. Here are three examples showing how to write your own.
 
 ### Example 1: GTD (encoding domain expertise)