create-baton 1.1.0 → 1.1.1

package/README.md

@@ -38,7 +38,7 @@ $ npx create-baton
   Setting up Baton...
 
   ✓ Copied BATON_v3.1.md
-  ✓ Copied skills/ (8 core + 2 stack + 1 pattern)
+  ✓ Copied skills/ (8 core + 6 stack + 7 pattern + 4 domain)
   ✓ Created .ai-rules/ (4 stub files)
   ✓ Created handoff/
   ✓ Created CLAUDE.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-baton",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Set up Baton AI orchestration protocol in any project",
   "bin": {
     "create-baton": "./bin/create-baton.js"

package/src/scaffold.js

@@ -24,8 +24,8 @@ function scaffold(dest, { tool, stack, projectName }) {
   copyDir(path.join(skillsSrc, 'core'), path.join(skillsDest, 'core'));
   copyDir(path.join(skillsSrc, 'patterns'), path.join(skillsDest, 'patterns'));
 
-  // Create domains/ (empty, for user to add)
-  fs.mkdirSync(path.join(skillsDest, 'domains'), { recursive: true });
+  // Always copy domains/
+  copyDir(path.join(skillsSrc, 'domains'), path.join(skillsDest, 'domains'));
 
   // Copy stack-specific skills (each is a directory with SKILL.md)
   const stackSkills = STACK_MAP[stack] || [];
@@ -44,7 +44,10 @@ function scaffold(dest, { tool, stack, projectName }) {
   const patternCount = fs.readdirSync(path.join(skillsDest, 'patterns')).filter(
     f => fs.statSync(path.join(skillsDest, 'patterns', f)).isDirectory()
   ).length;
-  results.push(`Copied skills/ (${coreCount} core + ${stackCount} stack + ${patternCount} pattern)`);
+  const domainCount = fs.readdirSync(path.join(skillsDest, 'domains')).filter(
+    f => fs.statSync(path.join(skillsDest, 'domains', f)).isDirectory()
+  ).length;
+  results.push(`Copied skills/ (${coreCount} core + ${stackCount} stack + ${patternCount} pattern + ${domainCount} domain)`);
 
   // 3. Create .ai-rules/ with stub files
   const aiRulesDir = path.join(dest, '.ai-rules');
@@ -85,8 +88,15 @@ function scaffold(dest, { tool, stack, projectName }) {
       .replace(/\{\{TYPECHECK_COMMAND\}\}/g, 'npx tsc --noEmit')
       .replace(/\{\{PROJECT_RULES\}\}/g, '<!-- AI will add project-specific rules here -->');
 
-    fs.writeFileSync(path.join(dest, ide.file), templateContent);
-    results.push(`Created ${ide.file}`);
+    const idePath = path.join(dest, ide.file);
+    if (fs.existsSync(idePath)) {
+      const altIdeFile = getNextBatonFilename(dest, ide.file);
+      fs.writeFileSync(path.join(dest, altIdeFile), templateContent);
+      results.push(`${ide.file} exists - created ${altIdeFile} (review and merge manually if needed)`);
+    } else {
+      fs.writeFileSync(idePath, templateContent);
+      results.push(`Created ${ide.file}`);
+    }
   } else {
     // Codex — uses AGENTS.md directly (already generated in step 6)
     results.push('Using AGENTS.md as IDE config (Codex)');
@@ -94,17 +104,34 @@ function scaffold(dest, { tool, stack, projectName }) {
 
   // 6. Generate AGENTS.md (universal standard for AI coding agents)
   const agentsMd = generateAgentsMd(projectName, stackLabel);
-  fs.writeFileSync(path.join(dest, 'AGENTS.md'), agentsMd);
-  results.push('Generated AGENTS.md');
-
-  // 7. Create PROGRESS.md, BACKLOG.md, FEATURES.md
-  fs.writeFileSync(path.join(dest, 'PROGRESS.md'),
-    `# Progress — ${projectName}\n\n## Sessions\n\n_No sessions yet. AI will log progress here._\n`);
-  fs.writeFileSync(path.join(dest, 'BACKLOG.md'),
-    `# Backlog — ${projectName}\n\n_Deferred items go here. AI adds items during sessions._\n`);
-  fs.writeFileSync(path.join(dest, 'FEATURES.md'),
-    `# Features — ${projectName}\n\n_User-facing feature documentation. AI updates this as features ship._\n`);
-  results.push('Created PROGRESS.md, BACKLOG.md, FEATURES.md');
+  const agentsPath = path.join(dest, 'AGENTS.md');
+  if (fs.existsSync(agentsPath)) {
+    const altAgentsFile = getNextAgentsFilename(dest);
+    fs.writeFileSync(path.join(dest, altAgentsFile), agentsMd);
+    results.push(`AGENTS.md exists - created ${altAgentsFile} (review and merge manually if needed)`);
+  } else {
+    fs.writeFileSync(agentsPath, agentsMd);
+    results.push('Generated AGENTS.md');
+  }
+
+  // 7. Create PROGRESS.md, BACKLOG.md, FEATURES.md (non-destructive)
+  const docsToCreate = {
+    'PROGRESS.md': `# Progress — ${projectName}\n\n## Sessions\n\n_No sessions yet. AI will log progress here._\n`,
+    'BACKLOG.md': `# Backlog — ${projectName}\n\n_Deferred items go here. AI adds items during sessions._\n`,
+    'FEATURES.md': `# Features — ${projectName}\n\n_User-facing feature documentation. AI updates this as features ship._\n`,
+  };
+
+  for (const [file, content] of Object.entries(docsToCreate)) {
+    const filePath = path.join(dest, file);
+    if (fs.existsSync(filePath)) {
+      const altFile = getNextBatonFilename(dest, file);
+      fs.writeFileSync(path.join(dest, altFile), content);
+      results.push(`${file} exists - created ${altFile} (review and merge manually if needed)`);
+    } else {
+      fs.writeFileSync(filePath, content);
+      results.push(`Created ${file}`);
+    }
+  }
 
   return results;
 }
@@ -190,4 +217,24 @@ function copyDir(src, dest) {
   }
 }
 
+function getNextAgentsFilename(dest) {
+  let index = 2;
+  let name = `AGENTS${index}.md`;
+  while (fs.existsSync(path.join(dest, name))) {
+    index += 1;
+    name = `AGENTS${index}.md`;
+  }
+  return name;
+}
+
+function getNextBatonFilename(dest, baseFile) {
+  let index = 1;
+  let name = `${baseFile}.baton.new`;
+  while (fs.existsSync(path.join(dest, name))) {
+    index += 1;
+    name = `${baseFile}.baton${index}.new`;
+  }
+  return name;
+}
+
 module.exports = { scaffold };

package/templates/BATON_v3.1.md

@@ -458,11 +458,12 @@ You're a technical co-founder, not a contractor. This is OUR product.
 ## Knowledge Lookup Order
 
 When implementing with libraries/APIs:
-1. **Check `patterns.md` FIRST** — it's the project's knowledge cache
-2. **Check `skills/` folder** — curated best practices
-3. **If not found**, check installed version and docs
-4. **If still unsure**, conduct web research
-5. **After discovering quirks**, ADD to `patterns.md` at session end
+1. **Check `.ai-rules/tech-stack.md` FIRST** — condensed technical rules for this project
+2. **Check `.ai-rules/patterns.md`** — project-specific knowledge cache
+3. **Check `skills/` ONLY if needed** — for new problem areas not covered above
+4. **If not found**, check installed version and docs
+5. **If still unsure**, conduct web research
+6. **After discovering quirks**, ADD to `.ai-rules/patterns.md` and update `.ai-rules/tech-stack.md` if you loaded a new skill
 
 ---
 

package/templates/ide/CLAUDE.md.template

@@ -24,7 +24,7 @@ This project uses **Baton Protocol** — an AI orchestration system where:
 
 | Priority | File | Purpose |
 |----------|------|---------|
-| 1 | `handoff/SESSION_N.md` | Current session tasks |
+| 1 | `handoff/SESSION_{{CURRENT_SESSION}}.md` | Current session tasks |
 | 2 | `.ai-rules/project.md` | Project decisions & rules |
 | 3 | `.ai-rules/tech-stack.md` | Stack patterns |
 | 4 | `.ai-rules/patterns.md` | Discovered quirks (check first!) |
@@ -66,7 +66,7 @@ This project uses **Baton Protocol** — an AI orchestration system where:
 1. Build passes
 2. New features work
 3. PROGRESS.md updated
-4. handoff/SESSION_{N+1}.md created
+4. `handoff/SESSION_{{NEXT_SESSION}}.md` created
 5. Ask: **"next"** or **"done"**?
 
 ---

package/templates/ide/cursorrules.template

@@ -5,7 +5,7 @@ This project uses Baton — an AI orchestration protocol.
 
 ## Start Each Session
 
-1. Read `handoff/SESSION_N.md` (current session)
+1. Read `handoff/SESSION_{{CURRENT_SESSION}}.md` (current session)
 2. Read `.ai-rules/` files for context
 3. Run health check (build, verify previous work)
 4. Ask: Any feedback? Blockers?
@@ -23,7 +23,7 @@ This project uses Baton — an AI orchestration protocol.
 
 - Verify build passes
 - Update PROGRESS.md
-- Create `handoff/SESSION_{N+1}.md`
+- Create `handoff/SESSION_{{NEXT_SESSION}}.md`
 - Ask user: **"next"** or **"done"**?
 
 ## Skills (Check Before Web Search)
@@ -35,7 +35,7 @@ This project uses Baton — an AI orchestration protocol.
 
 ## Key Files
 
-- `handoff/SESSION_N.md` — Current session tasks
+- `handoff/SESSION_{{CURRENT_SESSION}}.md` — Current session tasks
 - `.ai-rules/project.md` — Decisions and rules
 - `.ai-rules/patterns.md` — Discovered quirks
 - `PROGRESS.md` — Session log

package/templates/skills/core/cost-awareness/SKILL.md

@@ -75,7 +75,7 @@ EXPENSIVE:
 (Tokens for search + results + processing)
 
 CHEAP:
-"Read skills/stacks/nextjs.md"
+"Read skills/stacks/nextjs/SKILL.md"
 (Just file read, minimal tokens)
 ```