@axiomatic-labs/claudeflow 2.14.2 → 2.14.4

package/lib/install.js

@@ -170,6 +170,13 @@ async function run() {
     materializeSharedAppendPrompt(cwd);
     ensureDefaultClaudeMdRules(cwd);
     propagateTemplateRules(cwd, srcTemplates);
+    // v2: scaffold the 8 system rules (3 always-loaded + 5 path-scoped)
+    // using scaffold-system-rule.js. When setup-context.json exists
+    // (brownfield), it derives framework-aware `paths` frontmatter. When
+    // setup-context.json is absent (greenfield), it falls back to the
+    // template's broad-default paths. No-clobber preserved — existing
+    // user customizations win.
+    propagateSystemRulesViaScaffold(cwd);
     // After CLAUDE.md exists, append the claudeflow addendum (the load-bearing
     // rule "all code changes flow through /claudeflow-build" + mode-aware
     // mandates). Idempotent: runs every install/update; the block lives
@@ -970,10 +977,10 @@ function collectManagedPathsFromRelease(extractRoot) {
     destPrefix: '.claude/hooks',
   });
 
-  // Claudeflow dirs: runtime, templates, docs in .claudeflow/.
-  // (variants/ removed in v2.13.148. .claudeflow/cli/ removed in v2.13.153
-  // — only held the now-deleted claudeflow-mode.js variant-switcher.)
-  ['runtime', 'templates', 'docs'].forEach((folder) => {
+  // Claudeflow dirs: runtime, templates, docs, playbooks in .claudeflow/.
+  // playbooks/ added in v2 — required for the claudeflow-build orchestrator
+  // and its always-loaded foundation/routing references.
+  ['runtime', 'templates', 'docs', 'playbooks'].forEach((folder) => {
     addFilesFromDir(managed, extractRoot, path.join(srcClaudeflow, folder));
   });
 
@@ -1031,9 +1038,10 @@ function collectLegacyManagedPathsFromDisk(projectRoot) {
   // Claude Code native: hooks stay in .claude/
   addFilesFromDir(managed, projectRoot, path.join(claudeDir, 'hooks'));
 
-  // Claudeflow dirs: runtime, templates, docs in .claudeflow/
+  // Claudeflow dirs: runtime, templates, docs, playbooks in .claudeflow/.
+  // playbooks/ added in v2 — required for the claudeflow-build orchestrator.
   // (variants/ removed in v2.13.148. .claudeflow/cli/ removed in v2.13.153.)
-  ['runtime', 'templates', 'docs'].forEach((folder) => {
+  ['runtime', 'templates', 'docs', 'playbooks'].forEach((folder) => {
     addFilesFromDir(managed, projectRoot, path.join(claudeflowDir, folder));
   });
 
@@ -1176,12 +1184,74 @@ function propagateTemplateRules(projectRoot, srcTemplates) {
   fs.mkdirSync(dstRulesDir, { recursive: true });
   for (const filename of fs.readdirSync(srcRulesDir)) {
     if (!filename.endsWith('.md')) continue;
+    // Skip the 8 v2 system rules — they're handled by
+    // propagateSystemRulesViaScaffold, which derives framework-aware
+    // `paths` from setup-context.json when available.
+    if (V2_SYSTEM_RULES.has(filename)) continue;
     const dstPath = path.join(dstRulesDir, filename);
     if (fs.existsSync(dstPath)) continue; // no-clobber: preserve project-specific or user rules
     fs.copyFileSync(path.join(srcRulesDir, filename), dstPath);
   }
 }
 
+// The 8 v2 system rules that ship with claudeflow. propagateTemplateRules
+// skips these because they need scaffold-system-rule.js to derive
+// framework-aware `paths` frontmatter (e.g., a Next.js+Prisma project
+// gets `**/*.prisma` and `**/app/api/**` instead of broad defaults).
+const V2_SYSTEM_RULES = new Set([
+  'claudeflow-context-engineering.md',
+  'claudeflow-engineering-quality.md',
+  'claudeflow-testing.md',
+  'claudeflow-security.md',
+  'claudeflow-api.md',
+  'claudeflow-database.md',
+  'claudeflow-ui-ux.md',
+  'claudeflow-evidence.md',
+]);
+
+// Map of v2 rule filenames → rule slug used by scaffold-system-rule.js
+function ruleSlugFromFilename(filename) {
+  // Strip "claudeflow-" prefix and ".md" suffix. e.g.,
+  // "claudeflow-ui-ux.md" → "ui-ux".
+  return filename.replace(/^claudeflow-/, '').replace(/\.md$/, '');
+}
+
+function propagateSystemRulesViaScaffold(projectRoot) {
+  const scaffoldScript = path.join(
+    projectRoot, '.claudeflow', 'runtime', 'scaffold-system-rule.js',
+  );
+  if (!fs.existsSync(scaffoldScript)) {
+    // scaffold-system-rule.js is part of v2 — if missing, the project
+    // was bootstrapped with a pre-v2 ZIP. Skip silently; user can run
+    // /claudeflow-update later to refresh.
+    return;
+  }
+
+  for (const filename of V2_SYSTEM_RULES) {
+    const slug = ruleSlugFromFilename(filename);
+    try {
+      execFileSync('node', [
+        scaffoldScript,
+        '--rule', slug,
+        '--project-root', projectRoot,
+        '--mode', 'init',
+        // No --force: respect no-clobber. User edits win.
+      ], { stdio: ['ignore', 'ignore', 'pipe'] });
+    } catch (err) {
+      // scaffold-system-rule.js exits 1 when target exists (no-clobber).
+      // That's expected on re-install; don't warn. Other exit codes are
+      // real errors; log to stderr but don't abort the install.
+      const exitCode = err && err.status;
+      if (exitCode !== 1) {
+        process.stderr.write(
+          `Warning: failed to scaffold system rule "${slug}" (exit ${exitCode}). ` +
+            `You can re-run with /claudeflow-update later.\n`,
+        );
+      }
+    }
+  }
+}
+
 function materializeSharedAppendPrompt(projectRoot) {
   const templatePath = path.join(projectRoot, SHARED_APPEND_PROMPT_TEMPLATE);
   if (!fs.existsSync(templatePath)) {
@@ -1308,7 +1378,7 @@ function syncBoostAddendumOnInstall(cwd) {
   // mandates inside the addendum body explicitly say "fast-only" or
   // "normal-only" so the LLM applies them conditionally.
   const claudeMdPath = path.join(cwd, 'CLAUDE.md');
-  const addendumPath = path.join(cwd, '.claudeflow', 'templates', 'CLAUDE_BOOST_ADDENDUM.md');
+  const addendumPath = path.join(cwd, '.claudeflow', 'templates', 'claudeflow-append-claude-md.md');
   if (!fs.existsSync(claudeMdPath) || !fs.existsSync(addendumPath)) return;
 
   const ADDENDUM_BEGIN = '<!-- claudeflow:boost-mode:BEGIN -->';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiomatic-labs/claudeflow",
-  "version": "2.14.2",
+  "version": "2.14.4",
   "description": "Claudeflow — AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps.",
   "bin": {
     "claudeflow": "./bin/cli.js"