@jsleekr/graft 6.0.2 → 6.1.1

package/dist/codegen/codegen.js

@@ -41,9 +41,9 @@ export function generate(program, report, sourceFile, index, backend) {
             }
         }
     }
-    // Orchestration
+    // Orchestration (separate file — does not overwrite CLAUDE.md)
     files.push({
-        path: '.claude/CLAUDE.md',
+        path: '.claude/orchestration.md',
         content: be.generateOrchestration(ctx),
     });
     // Settings

package/dist/index.js

@@ -182,21 +182,19 @@ graph ${safeName}(input: Input, output: Output, budget: 10k) {
 }
 `);
     }
-    // Generate or append .claude/CLAUDE.md with .gft spec
+    // Generate .claude/ config files
     const claudeDir = path.join(dir, '.claude');
     fs.mkdirSync(claudeDir, { recursive: true });
     const { buildSystemPrompt } = await import('./generator.js');
     const gftSpec = buildSystemPrompt();
+    // Write .gft spec directly into CLAUDE.md (Claude Code only auto-reads CLAUDE.md)
+    // graft compile outputs to orchestration.md, so it never overwrites this.
     const claudeMdPath = path.join(claudeDir, 'CLAUDE.md');
     const existingClaudeMd = fs.existsSync(claudeMdPath) ? fs.readFileSync(claudeMdPath, 'utf-8') : '';
-    if (existingClaudeMd && existingClaudeMd.includes('graft compile')) {
-        console.log(`  .claude/CLAUDE.md already contains Graft config — skipped`);
-    }
-    else {
-        const graftSection = `
-## Graft — Multi-Agent Pipelines
+    const graftSection = `## Graft — Multi-Agent Pipelines
 
 This project uses **Graft** (.gft) for defining multi-agent pipelines.
+**Do NOT manually edit \`.claude/orchestration.md\`, \`.claude/agents/\`, \`.claude/hooks/\`, or \`.claude/settings.json\`** — these are generated by \`graft compile\`.
 
 When the user asks to create, modify, or manage pipelines:
 1. Write or edit \`.gft\` files using the syntax below
@@ -221,17 +219,18 @@ graft watch <file.gft>                      # Watch and recompile on changes
 2. Validates output against the .gft schema (types, ranges, empty fields)
 3. Suggests .gft modifications if quality issues are found
 
-${gftSpec}
-`;
-        if (existingClaudeMd) {
-            // Append Graft section to existing CLAUDE.md
-            fs.writeFileSync(claudeMdPath, existingClaudeMd.trimEnd() + '\n\n' + graftSection.trim() + '\n');
-        }
-        else {
-            // Create new CLAUDE.md with Graft header
-            fs.writeFileSync(claudeMdPath, `# ${safeName}\n` + graftSection);
-        }
-    } // end else (not already configured)
+${gftSpec}`;
+    if (existingClaudeMd && existingClaudeMd.includes('graft compile')) {
+        console.log(`  .claude/CLAUDE.md already contains Graft config — skipped`);
+    }
+    else if (existingClaudeMd) {
+        // Existing project: append Graft section to existing CLAUDE.md
+        fs.writeFileSync(claudeMdPath, existingClaudeMd.trimEnd() + '\n\n' + graftSection.trim() + '\n');
+    }
+    else {
+        // New project: create CLAUDE.md with Graft section
+        fs.writeFileSync(claudeMdPath, `# ${safeName}\n\n` + graftSection);
+    }
     if (isExisting) {
         console.log(`\nGraft added to current project.`);
         console.log(`  .claude/CLAUDE.md  — Graft spec injected`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsleekr/graft",
-  "version": "6.0.2",
+  "version": "6.1.1",
   "description": "Graft compiler — compile .gft graph DSL to Claude Code harness structures",
   "type": "module",
   "license": "MIT",