create-baton 1.1.1 → 1.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-baton",
-  "version": "1.1.1",
+  "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

@@ -49,7 +49,7 @@ function scaffold(dest, { tool, stack, projectName }) {
   ).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 = {
@@ -58,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');
@@ -155,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
 
@@ -186,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
@@ -195,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
 `;

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:**
@@ -567,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 |
@@ -582,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
@@ -593,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"?
 ```
 
@@ -614,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
 
@@ -627,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
@@ -646,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)
@@ -695,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

@@ -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 |
 |--------|----------|
@@ -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

@@ -28,15 +28,17 @@ This project uses Baton — an AI orchestration protocol.
 
 ## 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_{{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