@axiomatic-labs/claudeflow 2.13.16 → 2.13.17

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);
+    materializeDefaultClaudeMd(cwd);
     propagateTemplateRules(cwd, srcTemplates);
 
     // Copy template agents (only template-managed, preserve user agents)
@@ -988,6 +991,19 @@ function materializeSharedAppendPrompt(projectRoot) {
   fs.copyFileSync(templatePath, outputPath);
 }
 
+// Materialize the default CLAUDE.md only when the project has none.
+// CLAUDE.md is user-owned: customizations made by the user (or by other
+// frameworks) must survive `claudeflow update`. We therefore never
+// overwrite an existing file.
+function materializeDefaultClaudeMd(projectRoot) {
+  const templatePath = path.join(projectRoot, DEFAULT_CLAUDE_MD_TEMPLATE);
+  if (!fs.existsSync(templatePath)) return false;
+  const outputPath = path.join(projectRoot, DEFAULT_CLAUDE_MD_OUTPUT);
+  if (fs.existsSync(outputPath)) return false;
+  fs.copyFileSync(templatePath, outputPath);
+  return true;
+}
+
 function isTemplateManagedAgent(agentName) {
   return agentName.startsWith('claudeflow-');
 }
@@ -1020,6 +1036,7 @@ function copyDirSync(src, dst, skipNames) {
 module.exports = Object.assign(run, {
   assertRequiredTemplateRules,
   materializeSharedAppendPrompt,
+  materializeDefaultClaudeMd,
   isTemplateManagedAgent,
   listTemplateManagedAgents,
   mergeClaudeSettings,

package/package.json

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