@girardmedia/bootspring 2.0.12 → 2.0.14

package/cli/build.js

@@ -249,87 +249,26 @@ async function buildNextTask(projectRoot, _args = {}) {
 
   if (!nextTask) {
     console.log(`${c.green}All tasks complete!${c.reset}`);
-    clearCurrentTask(projectRoot);
     return;
   }
 
   // Mark task as in progress
   buildState.updateProgress(projectRoot, nextTask.id, 'in_progress');
 
-  // Generate the task prompt
-  const prompt = generateTaskPrompt(nextTask, projectRoot);
-
-  // Write to CURRENT_TASK.md for Claude Code to read
-  const taskFile = writeCurrentTask(projectRoot, nextTask, prompt);
-
   console.log(`
-${c.green}${c.bold}✓ Task ready for Claude Code${c.reset}
+${c.green}${c.bold}✓ Task ${nextTask.id} now in progress${c.reset}
 
 ${c.bold}Task:${c.reset} ${nextTask.title}
-${c.bold}File:${c.reset} ${path.relative(projectRoot, taskFile)}
+${c.bold}Phase:${c.reset} ${nextTask.phase || 'MVP'}
+${c.bold}Source:${c.reset} ${nextTask.source || 'PRD.md'}
 
 ${c.cyan}${c.bold}Tell Claude Code:${c.reset}
-  "Read planning/CURRENT_TASK.md and implement it"
+  "Read planning/TASK_QUEUE.md, find ${nextTask.id}, and implement it"
 
-${c.dim}Or for the loop, select option 2 to run autonomously.${c.reset}
+${c.dim}When done, run: bootspring build done${c.reset}
 `);
 }
 
-/**
- * Write current task to planning/CURRENT_TASK.md
- */
-function writeCurrentTask(projectRoot, task, prompt) {
-  const planningDir = path.join(projectRoot, 'planning');
-  if (!fs.existsSync(planningDir)) {
-    fs.mkdirSync(planningDir, { recursive: true });
-  }
-
-  const taskFile = path.join(planningDir, 'CURRENT_TASK.md');
-  const content = `# Current Task
-
-> This file is auto-generated by bootspring. Claude Code should read this and implement the task.
-
----
-
-## ${task.title}
-
-${prompt}
-
----
-
-## When Complete
-
-Run this command to mark the task done and get the next task:
-
-\`\`\`bash
-bootspring build done
-\`\`\`
-
-Or to skip this task:
-
-\`\`\`bash
-bootspring build skip
-\`\`\`
-
----
-
-*Task ID: ${task.id}*
-*Generated: ${new Date().toISOString()}*
-`;
-
-  fs.writeFileSync(taskFile, content);
-  return taskFile;
-}
-
-/**
- * Clear the current task file
- */
-function clearCurrentTask(projectRoot) {
-  const taskFile = path.join(projectRoot, 'planning', 'CURRENT_TASK.md');
-  if (fs.existsSync(taskFile)) {
-    fs.unlinkSync(taskFile);
-  }
-}
 
 /**
  * Generate a prompt for Claude Code to execute
@@ -400,19 +339,16 @@ async function markTaskDone(projectRoot, _args = {}) {
   const nextTask = buildState.getNextTask(projectRoot);
 
   if (nextTask) {
-    // Mark as in progress and write to CURRENT_TASK.md
+    // Mark as in progress
     buildState.updateProgress(projectRoot, nextTask.id, 'in_progress');
-    const prompt = generateTaskPrompt(nextTask, projectRoot);
-    const taskFile = writeCurrentTask(projectRoot, nextTask, prompt);
 
     console.log(`
-${c.cyan}${c.bold}Next task ready:${c.reset} ${nextTask.title}
-${c.dim}File: ${path.relative(projectRoot, taskFile)}${c.reset}
+${c.cyan}${c.bold}Next task:${c.reset} ${nextTask.title} (${nextTask.id})
 
-${c.bold}Continue working on planning/CURRENT_TASK.md${c.reset}
+${c.bold}Find task in:${c.reset} planning/TASK_QUEUE.md
+${c.dim}When done, run: bootspring build done${c.reset}
 `);
   } else {
-    clearCurrentTask(projectRoot);
     console.log(`
 ${c.green}${c.bold}🎉 All tasks complete!${c.reset}
 

package/generators/templates/agents.template.js

@@ -46,7 +46,7 @@ function generate(config) {
   sections.push('');
   sections.push('This project uses Bootspring for autonomous task management.');
   sections.push('');
-  sections.push('1. Check `planning/CURRENT_TASK.md` for the current task');
+  sections.push('1. Check `planning/TASK_QUEUE.md` for the current task (status: in_progress)');
   sections.push('2. Implement the task following acceptance criteria');
   sections.push('3. Run quality checks');
   sections.push('4. Commit changes');
@@ -129,7 +129,7 @@ function generatePlanningAgents(_config) {
 
   sections.push('## Current Task');
   sections.push('');
-  sections.push('Read `CURRENT_TASK.md` for the task you should implement now.');
+  sections.push('Find the task with `status: in_progress` in `TASK_QUEUE.md`.');
   sections.push('');
 
   sections.push('## Commands');
@@ -145,16 +145,16 @@ function generatePlanningAgents(_config) {
   sections.push('');
   sections.push('| File | Purpose |');
   sections.push('|------|---------|');
-  sections.push('| `CURRENT_TASK.md` | Task to implement now |');
+  sections.push('| `TASK_QUEUE.md` | All tasks - find in_progress task |');
   sections.push('| `TODO.md` | Full task checklist |');
   sections.push('| `BUILD_STATE.json` | Build state (do not edit) |');
-  sections.push('| `IMPLEMENTATION_QUEUE.md` | Ordered task queue |');
+  sections.push('| `TASK_QUEUE.md` | Ordered task queue |');
   sections.push('| `CONTEXT.md` | Build context summary |');
   sections.push('');
 
   sections.push('## Workflow');
   sections.push('');
-  sections.push('1. Read `CURRENT_TASK.md`');
+  sections.push('1. Find in_progress task in `TASK_QUEUE.md`');
   sections.push('2. Implement in the main codebase (not here)');
   sections.push('3. Ensure acceptance criteria met');
   sections.push('4. Run `npm run lint && npm run test`');

package/generators/templates/build-planning.template.js

@@ -4,7 +4,7 @@
  * Generates planning artifacts for the autonomous build loop:
  * - MASTER_PLAN.md - Vision + phases + progress tracker
  * - TODO.md - Checkbox list by phase
- * - IMPLEMENTATION_QUEUE.md - Ordered tasks with acceptance criteria
+ * - TASK_QUEUE.md - Ordered tasks with acceptance criteria
  * - CONTEXT.md - Condensed context for AI iterations
  *
  * @package bootspring
@@ -44,9 +44,9 @@ function generateAll(projectRoot, docs, tasks, options = {}) {
   fs.writeFileSync(todoPath, todo);
   files.todo = todoPath;
 
-  // Generate IMPLEMENTATION_QUEUE.md
+  // Generate TASK_QUEUE.md
   const queue = generateImplementationQueue(tasks, options);
-  const queuePath = path.join(planningDir, 'IMPLEMENTATION_QUEUE.md');
+  const queuePath = path.join(planningDir, 'TASK_QUEUE.md');
   fs.writeFileSync(queuePath, queue);
   files.implementationQueue = queuePath;
 
@@ -86,11 +86,11 @@ bootspring build status  # View progress
 
 ## Current Task
 
-Read \`CURRENT_TASK.md\` for the task you should implement now.
+Find the task with \`status: in_progress\` in \`TASK_QUEUE.md\`.
 
 ## Workflow
 
-1. Read \`CURRENT_TASK.md\`
+1. Find in_progress task in \`TASK_QUEUE.md\`
 2. Implement in the main codebase (not in this folder)
 3. Ensure acceptance criteria are met
 4. Run quality checks: \`npm run lint && npm run test\`
@@ -101,10 +101,10 @@ Read \`CURRENT_TASK.md\` for the task you should implement now.
 
 | File | Purpose |
 |------|---------|
-| \`CURRENT_TASK.md\` | Task to implement now |
+| \`TASK_QUEUE.md\` | All tasks - find in_progress task |
 | \`TODO.md\` | Full task checklist |
 | \`BUILD_STATE.json\` | Build state (do not edit directly) |
-| \`IMPLEMENTATION_QUEUE.md\` | Ordered task queue |
+| \`TASK_QUEUE.md\` | Ordered task queue |
 | \`CONTEXT.md\` | Build context summary |
 
 ## Boundaries
@@ -301,10 +301,10 @@ function generateTodo(tasks, options = {}) {
 }
 
 /**
- * Generate IMPLEMENTATION_QUEUE.md
+ * Generate TASK_QUEUE.md
  * @param {array} tasks - Extracted tasks
  * @param {object} options - Options
- * @returns {string} IMPLEMENTATION_QUEUE.md content
+ * @returns {string} TASK_QUEUE.md content
  */
 function generateImplementationQueue(tasks, options = {}) {
   const projectName = options.projectName || 'Project';
@@ -642,9 +642,9 @@ function updateFromState(projectRoot, state) {
   const todo = generateTodo(tasks, { projectName: state.projectName });
   fs.writeFileSync(path.join(planningDir, 'TODO.md'), todo);
 
-  // Regenerate IMPLEMENTATION_QUEUE.md
+  // Regenerate TASK_QUEUE.md
   const queue = generateImplementationQueue(tasks, { projectName: state.projectName });
-  fs.writeFileSync(path.join(planningDir, 'IMPLEMENTATION_QUEUE.md'), queue);
+  fs.writeFileSync(path.join(planningDir, 'TASK_QUEUE.md'), queue);
 }
 
 module.exports = {

package/generators/templates/claude.template.js

@@ -25,38 +25,56 @@ function generate(config) {
   sections.push('---');
   sections.push('');
 
-  // CRITICAL: Start Here - Put this first so Claude sees it immediately
-  sections.push('## Start Here');
+  // CRITICAL: Planning is the single source of truth
+  sections.push('## IMPORTANT: Planning First');
   sections.push('');
-  sections.push('**Read these files to understand the project:**');
+  sections.push('**The `/planning` folder is the SINGLE SOURCE OF TRUTH for all implementation.**');
   sections.push('');
-  sections.push('### Current Task');
-  sections.push('```');
-  sections.push('planning/CURRENT_TASK.md         # Implement this task now');
-  sections.push('```');
+  sections.push('### Before Writing ANY Code');
+  sections.push('1. Read `planning/MASTER_PLAN.md` - Overall vision and phases');
+  sections.push('2. Read `planning/TASK_QUEUE.md` - Your specific task');
+  sections.push('3. Read `planning/CONTEXT.md` - Current build context');
+  sections.push('4. Understand the acceptance criteria before implementing');
   sections.push('');
-  sections.push('### Project Vision & Strategy');
-  sections.push('```');
-  sections.push('.bootspring/preseed/VISION.md         # Product vision, goals, problem/solution');
-  sections.push('.bootspring/preseed/AUDIENCE.md       # Target users, personas, ICP');
-  sections.push('.bootspring/preseed/MARKET.md         # Market analysis, TAM/SAM/SOM');
-  sections.push('.bootspring/preseed/COMPETITORS.md    # Competitive landscape, differentiation');
-  sections.push('.bootspring/preseed/BUSINESS_MODEL.md # Revenue model, pricing, unit economics');
-  sections.push('```');
+  sections.push('### After Completing ANY Task');
+  sections.push('1. Update `planning/TODO.md` - Check off completed items');
+  sections.push('2. Run `bootspring build done` - Updates BUILD_STATE.json automatically');
+  sections.push('3. Document any architectural decisions or deviations');
   sections.push('');
-  sections.push('### Technical Specifications');
-  sections.push('```');
-  sections.push('.bootspring/preseed/PRD.md            # Product requirements, features, user stories');
-  sections.push('.bootspring/preseed/TECHNICAL_SPEC.md # Architecture, stack, data model, APIs');
-  sections.push('.bootspring/preseed/ROADMAP.md        # Implementation phases, milestones');
-  sections.push('```');
+  sections.push('**DO NOT skip reading planning docs. DO NOT skip updating them.**');
   sections.push('');
-  sections.push('### Build Progress');
-  sections.push('```');
-  sections.push('planning/BUILD_STATE.json        # Task queue and progress (do not edit)');
-  sections.push('planning/TODO.md                 # Checkbox task list');
-  sections.push('SEED.md                          # Project configuration summary');
-  sections.push('```');
+  sections.push('---');
+  sections.push('');
+
+  // Planning folder contents
+  sections.push('## Planning Folder (`/planning`)');
+  sections.push('');
+  sections.push('| File | Purpose | When to Read |');
+  sections.push('|------|---------|--------------|');
+  sections.push('| `MASTER_PLAN.md` | Overall vision, phases, success criteria | **Always read first** |');
+  sections.push('| `TASK_QUEUE.md` | All tasks with acceptance criteria, find current task by status | **Before each task** |');
+  sections.push('| `CONTEXT.md` | Current build context and decisions | Before each task |');
+  sections.push('| `TODO.md` | Checkbox task list | Update after completing |');
+  sections.push('| `BUILD_STATE.json` | Machine state - shows current task ID | Reference only |');
+  sections.push('');
+  sections.push('---');
+  sections.push('');
+
+  // Preseed docs - the source material
+  sections.push('## Source Documents (`.bootspring/preseed/`)');
+  sections.push('');
+  sections.push('These are the original specifications the planning was derived from:');
+  sections.push('');
+  sections.push('| File | Contains |');
+  sections.push('|------|----------|');
+  sections.push('| `VISION.md` | Product vision, problem/solution, goals |');
+  sections.push('| `AUDIENCE.md` | Target users, personas, ICP |');
+  sections.push('| `MARKET.md` | Market analysis, TAM/SAM/SOM |');
+  sections.push('| `COMPETITORS.md` | Competitive landscape, differentiation |');
+  sections.push('| `BUSINESS_MODEL.md` | Revenue model, pricing, unit economics |');
+  sections.push('| `PRD.md` | Product requirements, features, user stories |');
+  sections.push('| `TECHNICAL_SPEC.md` | Architecture, stack, data model, APIs |');
+  sections.push('| `ROADMAP.md` | Implementation phases, milestones |');
   sections.push('');
   sections.push('---');
   sections.push('');
@@ -196,46 +214,43 @@ function generate(config) {
   }
 
   // Autonomous Build System
-  sections.push('## Build Workflow');
-  sections.push('');
-  sections.push('### When You Start');
-  sections.push('1. Check if `planning/CURRENT_TASK.md` exists');
-  sections.push('2. If yes → Read it and implement the task');
-  sections.push('3. If no → Run `bootspring build next` to get the next task');
+  sections.push('## Task Workflow');
   sections.push('');
-  sections.push('### When You Finish a Task');
-  sections.push('1. Ensure acceptance criteria are met');
-  sections.push('2. Run `bootspring build done` to mark complete and get next task');
+  sections.push('```');
+  sections.push('┌─────────────────────────────────────────────────────────────┐');
+  sections.push('│  1. READ     planning/MASTER_PLAN.md                        │');
+  sections.push('│              planning/TASK_QUEUE.md (find in_progress task) │');
+  sections.push('│                              ↓                              │');
+  sections.push('│  2. IMPLEMENT  Write code to meet acceptance criteria       │');
+  sections.push('│                              ↓                              │');
+  sections.push('│  3. COMPLETE  Run: bootspring build done                    │');
+  sections.push('│               (marks done, queues next task)                │');
+  sections.push('│                              ↓                              │');
+  sections.push('│  4. REPEAT   Check TASK_QUEUE.md for next in_progress task  │');
+  sections.push('└─────────────────────────────────────────────────────────────┘');
+  sections.push('```');
   sections.push('');
   sections.push('### Commands');
   sections.push('');
   sections.push('| Command | What it does |');
   sections.push('|---------|--------------|');
   sections.push('| `bootspring build` | Interactive menu |');
-  sections.push('| `bootspring build next` | Get next task → `planning/CURRENT_TASK.md` |');
-  sections.push('| `bootspring build done` | Mark complete, auto-queue next |');
+  sections.push('| `bootspring build next` | Mark next task as in_progress |');
+  sections.push('| `bootspring build done` | Mark current complete, queue next |');
   sections.push('| `bootspring build status` | View progress |');
   sections.push('| `bootspring build skip` | Skip current task |');
   sections.push('');
   sections.push('---');
   sections.push('');
 
-  // Key Files Reference
-  sections.push('## Quick Reference');
+  // Rules
+  sections.push('## Rules');
   sections.push('');
-  sections.push('| File | What it contains |');
-  sections.push('|------|------------------|');
-  sections.push('| `planning/CURRENT_TASK.md` | **Your current task** - implement this |');
-  sections.push('| `.bootspring/preseed/VISION.md` | Product vision, problem, solution |');
-  sections.push('| `.bootspring/preseed/AUDIENCE.md` | Target users, personas |');
-  sections.push('| `.bootspring/preseed/MARKET.md` | Market size, trends |');
-  sections.push('| `.bootspring/preseed/COMPETITORS.md` | Competition, differentiation |');
-  sections.push('| `.bootspring/preseed/BUSINESS_MODEL.md` | Revenue, pricing |');
-  sections.push('| `.bootspring/preseed/PRD.md` | Features, requirements |');
-  sections.push('| `.bootspring/preseed/TECHNICAL_SPEC.md` | Architecture, data model |');
-  sections.push('| `.bootspring/preseed/ROADMAP.md` | Phases, milestones |');
-  sections.push('| `planning/BUILD_STATE.json` | Progress tracking (auto-managed) |');
-  sections.push('| `SEED.md` | Config summary |');
+  sections.push('1. **Always read before coding** - No implementation without reading MASTER_PLAN.md and TASK_QUEUE.md');
+  sections.push('2. **Follow acceptance criteria exactly** - The task is not done until all criteria are met');
+  sections.push('3. **Update planning docs** - Check off TODO.md items, run `bootspring build done`');
+  sections.push('4. **One task at a time** - Complete current task before starting next');
+  sections.push('5. **Document decisions** - If you deviate from the plan, document why');
   sections.push('');
   sections.push('---');
   sections.push('');

package/mcp/contracts/mcp-contract.v1.json

@@ -1,7 +1,7 @@
 {
   "contractVersion": "v1",
   "packageName": "@girardmedia/bootspring",
-  "packageVersion": "2.0.12",
+  "packageVersion": "2.0.14",
   "tools": [
     {
       "name": "bootspring_assist",

package/mcp/tools/build-tool.js

@@ -271,9 +271,6 @@ function createHandler({ configModule }) {
         // Mark as in progress
         buildState.updateProgress(projectRoot, nextTask.id, 'in_progress');
 
-        // Write to CURRENT_TASK.md
-        writeCurrentTaskFile(projectRoot, nextTask);
-
         return {
           content: [{
             type: 'text',
@@ -287,9 +284,9 @@ function createHandler({ configModule }) {
                 sourceSection: nextTask.sourceSection,
                 acceptanceCriteria: nextTask.acceptanceCriteria || []
               },
-              file: 'planning/CURRENT_TASK.md',
+              file: 'planning/TASK_QUEUE.md',
               instructions: [
-                'Read the task details above',
+                `Find ${nextTask.id} in planning/TASK_QUEUE.md for full details`,
                 'Implement the task in the codebase',
                 'Ensure acceptance criteria are met',
                 'Run quality checks (lint, test)',
@@ -336,9 +333,6 @@ function createHandler({ configModule }) {
         // Auto-queue next task
         if (nextTask) {
           buildState.updateProgress(projectRoot, nextTask.id, 'in_progress');
-          writeCurrentTaskFile(projectRoot, nextTask);
-        } else {
-          clearCurrentTaskFile(projectRoot);
         }
 
         return {
@@ -402,7 +396,6 @@ function createHandler({ configModule }) {
 
         if (nextTask) {
           buildState.updateProgress(projectRoot, nextTask.id, 'in_progress');
-          writeCurrentTaskFile(projectRoot, nextTask);
         }
 
         return {
@@ -417,7 +410,8 @@ function createHandler({ configModule }) {
               nextTask: nextTask ? {
                 id: nextTask.id,
                 title: nextTask.title,
-                description: nextTask.description
+                description: nextTask.description,
+                file: 'planning/TASK_QUEUE.md'
               } : null,
               message: nextTask
                 ? `Skipped. Next: ${nextTask.title}`
@@ -441,63 +435,6 @@ function createHandler({ configModule }) {
   };
 }
 
-/**
- * Write task to planning/CURRENT_TASK.md
- */
-function writeCurrentTaskFile(projectRoot, task) {
-  const planningDir = path.join(projectRoot, 'planning');
-  if (!fs.existsSync(planningDir)) {
-    fs.mkdirSync(planningDir, { recursive: true });
-  }
-
-  const content = `# Current Task
-
-> Auto-generated by bootspring. Implement this task.
-
----
-
-## ${task.title}
-
-${task.description || ''}
-
-${task.acceptanceCriteria?.length ? `### Acceptance Criteria
-
-${task.acceptanceCriteria.map(ac => `- [ ] ${ac}`).join('\n')}
-` : ''}
-
-### Source
-
-${task.source}${task.sourceSection ? ` - ${task.sourceSection}` : ''}
-
----
-
-## Instructions
-
-1. Implement the task as described above
-2. Ensure all acceptance criteria are met
-3. Run quality checks (lint, test)
-4. Commit your changes
-5. Mark complete with: \`bootspring build done\` or MCP action=done
-
----
-
-*Task ID: ${task.id}*
-*Generated: ${new Date().toISOString()}*
-`;
-
-  fs.writeFileSync(path.join(planningDir, 'CURRENT_TASK.md'), content);
-}
-
-/**
- * Clear CURRENT_TASK.md
- */
-function clearCurrentTaskFile(projectRoot) {
-  const taskFile = path.join(projectRoot, 'planning', 'CURRENT_TASK.md');
-  if (fs.existsSync(taskFile)) {
-    fs.unlinkSync(taskFile);
-  }
-}
-
 module.exports = {
   getToolDefinition,
   createHandler

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girardmedia/bootspring",
-  "version": "2.0.12",
+  "version": "2.0.14",
   "description": "Development scaffolding with intelligence - AI-powered context, agents, and workflows for any MCP-compatible assistant",
   "keywords": [
     "ai",