create-baton 1.1.0 → 1.1.2

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.2",
   "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,9 +44,12 @@ 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
+  // 3. Create .ai-rules/ with stub files (non-destructive)
   const aiRulesDir = path.join(dest, '.ai-rules');
   fs.mkdirSync(aiRulesDir, { recursive: true });
   const stubs = {
@@ -55,10 +58,21 @@ function scaffold(dest, { tool, stack, projectName }) {
     'patterns.md': `# Patterns & Quirks — ${projectName}\n\n> AI adds entries here as it discovers gotchas and solutions.\n`,
     'structure.md': `# Project Structure — ${projectName}\n\n> AI will fill this once the project scaffolding is set up.\n`,
   };
+  let createdStubCount = 0;
   for (const [file, content] of Object.entries(stubs)) {
-    fs.writeFileSync(path.join(aiRulesDir, file), content);
+    const stubPath = path.join(aiRulesDir, file);
+    if (fs.existsSync(stubPath)) {
+      const altStubFile = getNextBatonFilename(aiRulesDir, file);
+      fs.writeFileSync(path.join(aiRulesDir, altStubFile), content);
+      results.push(`.ai-rules/${file} exists - created .ai-rules/${altStubFile} (review and merge manually if needed)`);
+    } else {
+      fs.writeFileSync(stubPath, content);
+      createdStubCount += 1;
+    }
+  }
+  if (createdStubCount > 0) {
+    results.push(`Created .ai-rules/ (${createdStubCount} stub files)`);
   }
-  results.push('Created .ai-rules/ (4 stub files)');
 
   // 4. Create handoff/ with .gitkeep
   const handoffDir = path.join(dest, 'handoff');
@@ -85,8 +99,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 +115,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;
 }
@@ -128,9 +166,9 @@ ${stackLine}
 This project uses the Baton protocol for AI-assisted development.
 
 1. Read \`BATON_v3.1.md\` — the orchestration protocol
-2. Read \`.ai-rules/\` — project context files (AI-generated)
-3. Read \`skills/\` — curated best practices for this stack
-4. Check \`handoff/\` — session handoff files for continuity
+2. Read \`.ai-rules/tech-stack.md\` and \`.ai-rules/patterns.md\` — condensed project context
+3. Check \`handoff/\` — session handoff files for continuity
+4. Use \`skills/\` only for new problem areas not covered in \`.ai-rules/tech-stack.md\`
 
 ## Build & Development Commands
 
@@ -159,6 +197,7 @@ skills/                # Best practice skills
   core/                # Universal rules
   stacks/              # Stack-specific patterns
   patterns/            # Implementation patterns
+  domains/             # Domain-specific guidance
 handoff/               # Session handoff files
 PROGRESS.md            # Session progress log
 BACKLOG.md             # Deferred items
@@ -168,8 +207,9 @@ BACKLOG.md             # Deferred items
 
 This project follows the Baton protocol. Key rules:
 - Read BATON_v3.1.md before starting work
-- Check skills/ before web searching
-- Document discoveries in .ai-rules/patterns.md
+- Check .ai-rules/tech-stack.md first, then .ai-rules/patterns.md
+- Use skills/ only when needed for new problem areas
+- Document discoveries in .ai-rules/patterns.md and keep .ai-rules/tech-stack.md updated
 - Create handoff files at session end
 - Update PROGRESS.md after each session
 `;
@@ -190,4 +230,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

@@ -184,8 +184,8 @@ Create the appropriate config file for the user's AI tool:
 | Claude Code | CLAUDE.md |
 | Cursor | .cursorrules |
 | Windsurf | .windsurfrules |
-| Kiro | .kiro/context.md |
-| Warp | .warp/rules/project.md |
+| Kiro | CLAUDE.md |
+| Warp | CLAUDE.md |
 | Multiple/Other | Create CLAUDE.md as universal fallback |
 
 **IDE Config Must Include:**
@@ -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
 
 ---
 
@@ -566,13 +567,13 @@ This project uses **Baton Protocol** — an AI orchestration system where:
 2. Follow the session protocol
 3. End by creating the next handoff
 
-**Current Session:** `handoff/SESSION_[N].md`
+**Current Session:** `handoff/SESSION_{{CURRENT_SESSION}}.md`
 
 ## Context Files (Read in Order)
 
 | 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 |
@@ -581,7 +582,8 @@ This project uses **Baton Protocol** — an AI orchestration system where:
 
 ## Skills Library
 
-Check these BEFORE web searching:
+Use `.ai-rules/tech-stack.md` and `.ai-rules/patterns.md` first.
+Check these skill folders only for new problem areas not covered there:
 
 - `skills/core/` — Security, testing, production rules
 - `skills/stacks/` — Tech stack patterns
@@ -592,16 +594,17 @@ Check these BEFORE web searching:
 
 1. **Flexible tasks** — Do 1-4 tasks based on size (tiny=4, large=1)
 2. **Verify before moving on** — Build must pass, feature must work
-3. **Document as you go** — Update structure.md, patterns.md
-4. **Create handoff at end** — Next session file is mandatory
-5. **Ask when unsure** — Never guess on business logic
+3. **Knowledge order** — Check `.ai-rules/tech-stack.md`, then `.ai-rules/patterns.md`, then `skills/` only if needed
+4. **Document as you go** — Update structure.md, patterns.md
+5. **Create handoff at end** — Next session file is mandatory
+6. **Ask when unsure** — Never guess on business logic
 
 ## Session End Checklist
 
 - [ ] Build passes
 - [ ] New features work
 - [ ] PROGRESS.md updated
-- [ ] handoff/SESSION_{N+1}.md created
+- [ ] `handoff/SESSION_{{NEXT_SESSION}}.md` created
 - [ ] Ask user: "next" or "done"?
 ```
 
@@ -613,7 +616,7 @@ Check these BEFORE web searching:
 This project uses Baton — an AI orchestration system.
 
 ## 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. Follow the tasks in the handoff
 
@@ -626,17 +629,20 @@ This project uses Baton — an AI orchestration system.
 ## End Each Session
 - Verify build passes
 - Update PROGRESS.md
-- Create handoff/SESSION_{N+1}.md
+- Create handoff/SESSION_{{NEXT_SESSION}}.md
 - Ask: "next" or "done"?
 
 ## Skills (Check Before Web Search)
+- .ai-rules/tech-stack.md — Condensed technical rules (read first)
+- .ai-rules/patterns.md — Project-specific quirks
 - skills/core/ — Universal rules
-- skills/stacks/ — Tech patterns
-- skills/patterns/ — Implementation guides
+- skills/stacks/ — Tech patterns (load only if needed)
+- skills/patterns/ — Implementation guides (load only if needed)
 
 ## Key Files
-- handoff/SESSION_N.md — Current session
+- handoff/SESSION_{{CURRENT_SESSION}}.md — Current session
 - .ai-rules/project.md — Decisions
+- .ai-rules/tech-stack.md — Condensed stack + pattern rules
 - .ai-rules/patterns.md — Quirks discovered
 - PROGRESS.md — Session log
 - BACKLOG.md — Deferred work
@@ -645,8 +651,11 @@ This project uses Baton — an AI orchestration system.
 - Never commit secrets
 - Always use environment variables
 - RLS on all database tables
+- Zod validation on all inputs
 - Verify before declaring done
 - Document quirks in patterns.md
+- Update tech-stack.md when loading new skills
+- Create handoff before ending session
 ```
 
 ### .windsurfrules (Windsurf)
@@ -694,7 +703,7 @@ Same content as .cursorrules — Windsurf uses similar format.
 - Update documentation as you go
 - If unsure about anything, ASK before building
 - If scope grows, pause and discuss
-- Check skills/ and patterns.md before web searching
+- Check `.ai-rules/tech-stack.md` and `.ai-rules/patterns.md` before web searching; use `skills/` only if needed
 
 ### Ending a Session
 

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!) |
@@ -36,7 +36,8 @@ This project uses **Baton Protocol** — an AI orchestration system where:
 
 ## Skills Library
 
-**Check these BEFORE web searching:**
+Use `.ai-rules/tech-stack.md` and `.ai-rules/patterns.md` first.
+Check these skill folders only for new problem areas not covered there:
 
 | Folder | Contains |
 |--------|----------|
@@ -66,7 +67,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"**?
 
 ---
@@ -75,7 +76,7 @@ This project uses **Baton Protocol** — an AI orchestration system where:
 
 1. **Verify before moving on** — Build must pass, feature must work
 2. **Document as you go** — Update structure.md, patterns.md
-3. **Skills before search** — Check skills/ before web research
+3. **Knowledge order** — Check `.ai-rules/tech-stack.md`, then `.ai-rules/patterns.md`, then `skills/` only if needed
 4. **Ask when unsure** — Never guess on business logic
 5. **Handoff is mandatory** — Session isn't done without next handoff
 

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,20 +23,22 @@ 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)
 
-- `skills/core/` — Security, testing, production rules
-- `skills/stacks/` — {{STACK}} patterns
-- `skills/patterns/` — Implementation guides
+- `.ai-rules/tech-stack.md` — Condensed technical rules (read first)
 - `.ai-rules/patterns.md` — Project-specific quirks
+- `skills/core/` — Security, testing, production rules
+- `skills/stacks/` — {{STACK}} patterns (load only if needed)
+- `skills/patterns/` — Implementation guides (load only if needed)
 
 ## 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/tech-stack.md` — Condensed stack + pattern rules
 - `.ai-rules/patterns.md` — Discovered quirks
 - `PROGRESS.md` — Session log
 - `BACKLOG.md` — Deferred work
@@ -49,6 +51,7 @@ This project uses Baton — an AI orchestration protocol.
 - Zod validation on all inputs
 - Verify before declaring done
 - Document quirks in patterns.md
+- Update tech-stack.md when loading new skills
 - Create handoff before ending session
 
 ## Commands

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)
 ```