@jsleekr/graft 6.0.2 → 6.1.0

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,18 +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();
-    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 = `
+    // 1. Write .gft spec to a separate file (never overwritten by compile)
+    const specPath = path.join(claudeDir, 'graft-spec.md');
+    const specContent = `# Graft — .gft Language Reference
+
+> Auto-generated by \`graft init\`. This file is the .gft syntax reference
+> that Claude Code reads to understand the Graft language.
+> Do NOT delete this file — \`graft compile\` does not touch it.
+
 ## Graft — Multi-Agent Pipelines
 
 This project uses **Graft** (.gft) for defining multi-agent pipelines.
@@ -223,15 +224,22 @@ graft watch <file.gft>                      # Watch and recompile on changes
 
 ${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)
+    fs.writeFileSync(specPath, specContent);
+    // 2. Add Graft reference to CLAUDE.md (short pointer, not the full spec)
+    const claudeMdPath = path.join(claudeDir, 'CLAUDE.md');
+    const existingClaudeMd = fs.existsSync(claudeMdPath) ? fs.readFileSync(claudeMdPath, 'utf-8') : '';
+    const graftReference = `## Graft
+
+This project uses Graft for multi-agent pipelines. Read \`.claude/graft-spec.md\` for the full .gft syntax reference. Run \`graft compile <file.gft>\` to generate harness files.`;
+    if (existingClaudeMd && existingClaudeMd.includes('graft-spec.md')) {
+        console.log(`  .claude/CLAUDE.md already references Graft — skipped`);
+    }
+    else if (existingClaudeMd) {
+        fs.writeFileSync(claudeMdPath, existingClaudeMd.trimEnd() + '\n\n' + graftReference + '\n');
+    }
+    else {
+        fs.writeFileSync(claudeMdPath, `# ${safeName}\n\n` + graftReference + '\n');
+    }
     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.0",
   "description": "Graft compiler — compile .gft graph DSL to Claude Code harness structures",
   "type": "module",
   "license": "MIT",