@axiomatic-labs/claudeflow 2.13.16 → 2.13.18

package/lib/install.js

@@ -15,6 +15,8 @@ const REQUIRED_TEMPLATE_RULES = [];
 const LEGACY_TEMPLATE_RULES = ['claudeflow-implementation.md', 'example-rules.md'];
 const SHARED_APPEND_PROMPT_TEMPLATE = path.join('.claudeflow', 'templates', 'claudeflow-core-system-prompt.md');
 const SHARED_APPEND_PROMPT_OUTPUT = 'append-system-prompt.md';
+const DEFAULT_CLAUDE_MD_TEMPLATE = path.join('.claudeflow', 'templates', 'claudeflow-default-claude-md.md');
+const DEFAULT_CLAUDE_MD_OUTPUT = 'CLAUDE.md';
 const TEMPLATE_MANAGED_SETTINGS_KEYS = ['$schema', 'enabledMcpjsonServers', 'env', 'permissions', 'hooks'];
 const SERENA_REPO = 'git+https://github.com/oraios/serena';
 const TEMPLATE_SEEDED_SETTINGS_KEYS = new Set(['statusLine']);
@@ -152,6 +154,7 @@ async function run() {
       copyDirSync(srcTemplates, dstTemplates);
     }
     materializeSharedAppendPrompt(cwd);
+    ensureDefaultClaudeMdRules(cwd);
     propagateTemplateRules(cwd, srcTemplates);
 
     // Copy template agents (only template-managed, preserve user agents)
@@ -988,6 +991,69 @@ function materializeSharedAppendPrompt(projectRoot) {
   fs.copyFileSync(templatePath, outputPath);
 }
 
+// Inject the canonical claudeflow rules block into the project's CLAUDE.md.
+//
+// Three cases:
+//   1. CLAUDE.md absent → create with the block plus user-content section
+//   2. CLAUDE.md present, no sentinel, no opt-out → prepend the block,
+//      preserving every byte of the existing file
+//   3. CLAUDE.md present with sentinel → replace the block in place
+//      (keeps future template revisions propagating idempotently)
+//
+// User opt-out: drop the literal string `claudeflow:default-rules:opt-out`
+// anywhere in CLAUDE.md (e.g. in a comment) to skip injection forever.
+//
+// The block is wrapped in HTML comments — markdown renders them invisibly
+// but they survive editor round-trips and remain machine-detectable.
+const CLAUDE_MD_INJECT_BEGIN = '<!-- claudeflow:default-rules:start (do not edit between markers) -->';
+const CLAUDE_MD_INJECT_END = '<!-- claudeflow:default-rules:end -->';
+const CLAUDE_MD_OPT_OUT = 'claudeflow:default-rules:opt-out';
+
+function buildDefaultRulesBlock(projectRoot) {
+  const templatePath = path.join(projectRoot, DEFAULT_CLAUDE_MD_TEMPLATE);
+  if (!fs.existsSync(templatePath)) return null;
+  let body = fs.readFileSync(templatePath, 'utf8');
+  // Strip the leading `# CLAUDE.md` heading — when injected into an existing
+  // file the heading would conflict with the user's own H1.
+  body = body.replace(/^\s*#\s*CLAUDE\.md\s*\r?\n+/, '').trimEnd();
+  return `${CLAUDE_MD_INJECT_BEGIN}\n${body}\n${CLAUDE_MD_INJECT_END}`;
+}
+
+function ensureDefaultClaudeMdRules(projectRoot) {
+  const block = buildDefaultRulesBlock(projectRoot);
+  if (!block) return { action: 'no-template' };
+
+  const outputPath = path.join(projectRoot, DEFAULT_CLAUDE_MD_OUTPUT);
+
+  if (!fs.existsSync(outputPath)) {
+    fs.writeFileSync(outputPath, `${block}\n`);
+    return { action: 'created' };
+  }
+
+  const existing = fs.readFileSync(outputPath, 'utf8');
+
+  if (existing.includes(CLAUDE_MD_OPT_OUT)) {
+    return { action: 'opt-out' };
+  }
+
+  const beginIdx = existing.indexOf(CLAUDE_MD_INJECT_BEGIN);
+  const endIdx = existing.indexOf(CLAUDE_MD_INJECT_END);
+  if (beginIdx !== -1 && endIdx !== -1 && endIdx > beginIdx) {
+    const before = existing.slice(0, beginIdx);
+    const after = existing.slice(endIdx + CLAUDE_MD_INJECT_END.length);
+    const next = `${before}${block}${after}`;
+    if (next === existing) return { action: 'unchanged' };
+    fs.writeFileSync(outputPath, next);
+    return { action: 'updated' };
+  }
+
+  // First injection into a pre-existing CLAUDE.md — prepend, keep the
+  // user's content verbatim below.
+  const separator = existing.startsWith('\n') ? '\n' : '\n\n';
+  fs.writeFileSync(outputPath, `${block}${separator}${existing}`);
+  return { action: 'injected' };
+}
+
 function isTemplateManagedAgent(agentName) {
   return agentName.startsWith('claudeflow-');
 }
@@ -1020,6 +1086,11 @@ function copyDirSync(src, dst, skipNames) {
 module.exports = Object.assign(run, {
   assertRequiredTemplateRules,
   materializeSharedAppendPrompt,
+  ensureDefaultClaudeMdRules,
+  buildDefaultRulesBlock,
+  CLAUDE_MD_INJECT_BEGIN,
+  CLAUDE_MD_INJECT_END,
+  CLAUDE_MD_OPT_OUT,
   isTemplateManagedAgent,
   listTemplateManagedAgents,
   mergeClaudeSettings,

package/package.json

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