@girardmedia/bootspring 2.0.13 → 2.0.15

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,23 +339,25 @@ 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: ${nextTask.title}${c.reset} (${nextTask.id})
 
-${c.bold}Continue working on planning/CURRENT_TASK.md${c.reset}
+${c.bold}Continue building:${c.reset} Read planning/TASK_QUEUE.md, implement ${nextTask.id}
+${c.dim}Then run: bootspring build done${c.reset}
 `);
   } else {
-    clearCurrentTask(projectRoot);
     console.log(`
-${c.green}${c.bold}🎉 All tasks complete!${c.reset}
+${c.green}${c.bold}🎉 MVP BUILD COMPLETE!${c.reset}
+
+All ${stats.total} tasks finished. Your MVP is ready.
 
-Your MVP build is finished.
+${c.bold}Next steps:${c.reset}
+  1. Review the generated code
+  2. Run tests: ${c.cyan}npm test${c.reset}
+  3. Deploy: ${c.cyan}bootspring deploy${c.reset}
 `);
   }
 }

package/generators/templates/agents.template.js

@@ -42,15 +42,20 @@ function generate(config) {
   sections.push('');
 
   // Task System
-  sections.push('## Task System');
+  sections.push('## Build Loop');
   sections.push('');
-  sections.push('This project uses Bootspring for autonomous task management.');
+  sections.push('**Start building:**');
+  sections.push('```');
+  sections.push('bootspring build next');
+  sections.push('```');
+  sections.push('');
+  sections.push('This loops through all tasks:');
+  sections.push('1. Find in_progress task in `planning/TASK_QUEUE.md`');
+  sections.push('2. Implement following acceptance criteria');
+  sections.push('3. Run `bootspring build done`');
+  sections.push('4. Continue to next task (auto-queued)');
   sections.push('');
-  sections.push('1. Check `planning/CURRENT_TASK.md` for the current task');
-  sections.push('2. Implement the task following acceptance criteria');
-  sections.push('3. Run quality checks');
-  sections.push('4. Commit changes');
-  sections.push('5. Run `bootspring build done` to get the next task');
+  sections.push('**Keep looping until MVP complete.**');
   sections.push('');
 
   // Stack - Be specific about versions
@@ -129,7 +134,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 +150,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

@@ -32,7 +32,7 @@ function generate(config) {
   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/CURRENT_TASK.md` - Your specific task');
+  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('');
@@ -52,11 +52,10 @@ function generate(config) {
   sections.push('| File | Purpose | When to Read |');
   sections.push('|------|---------|--------------|');
   sections.push('| `MASTER_PLAN.md` | Overall vision, phases, success criteria | **Always read first** |');
-  sections.push('| `CURRENT_TASK.md` | Your immediate task with acceptance criteria | **Before each task** |');
+  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('| `IMPLEMENTATION_QUEUE.md` | Ordered list of all tasks | To understand scope |');
   sections.push('| `TODO.md` | Checkbox task list | Update after completing |');
-  sections.push('| `BUILD_STATE.json` | Machine state (auto-managed) | Do not edit manually |');
+  sections.push('| `BUILD_STATE.json` | Machine state - shows current task ID | Reference only |');
   sections.push('');
   sections.push('---');
   sections.push('');
@@ -215,29 +214,38 @@ function generate(config) {
   }
 
   // Autonomous Build System
-  sections.push('## Task Workflow');
+  sections.push('## Build Loop');
+  sections.push('');
+  sections.push('**To start building, run:**');
+  sections.push('');
+  sections.push('```');
+  sections.push('bootspring build next');
+  sections.push('```');
+  sections.push('');
+  sections.push('This starts an autonomous loop:');
   sections.push('');
   sections.push('```');
   sections.push('┌─────────────────────────────────────────────────────────────┐');
-  sections.push('│  1. READ    planning/MASTER_PLAN.md (understand context)    │');
-  sections.push('│             planning/CURRENT_TASK.md (your task)            │');
-  sections.push('│                              ↓                              │');
-  sections.push('│  2. IMPLEMENT  Write code to meet acceptance criteria       │');
-  sections.push('│                              ↓                              │');
-  sections.push('│  3. UPDATE   planning/TODO.md (check off items)             │');
-  sections.push('│              Run: bootspring build done                     │');
-  sections.push('│                              ↓                              │');
-  sections.push('│  4. REPEAT   Next task auto-loaded to CURRENT_TASK.md       │');
+  sections.push('│  bootspring build next                                      │');
+  sections.push('│         ↓                                                   │');
+  sections.push('│  Read planning/TASK_QUEUE.md → find in_progress task        │');
+  sections.push('│         ↓                                                   │');
+  sections.push('│  Implement task (meet acceptance criteria)                  │');
+  sections.push('│         ↓                                                   │');
+  sections.push('│  bootspring build done                                      │');
+  sections.push('│         ↓                                                   │');
+  sections.push('│  [Auto-queues next task] → Continue implementing...         │');
   sections.push('└─────────────────────────────────────────────────────────────┘');
   sections.push('```');
   sections.push('');
+  sections.push('**Keep looping until all tasks are complete.**');
+  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` | Load next task → `planning/CURRENT_TASK.md` |');
-  sections.push('| `bootspring build done` | Mark complete, update state, load next |');
+  sections.push('| `bootspring build next` | **Start here** - queue next task |');
+  sections.push('| `bootspring build done` | Mark complete, auto-queue next |');
   sections.push('| `bootspring build status` | View progress |');
   sections.push('| `bootspring build skip` | Skip current task |');
   sections.push('');
@@ -247,7 +255,7 @@ function generate(config) {
   // Rules
   sections.push('## Rules');
   sections.push('');
-  sections.push('1. **Always read before coding** - No implementation without reading MASTER_PLAN.md and CURRENT_TASK.md');
+  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');

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

@@ -1,7 +1,7 @@
 {
   "contractVersion": "v1",
   "packageName": "@girardmedia/bootspring",
-  "packageVersion": "2.0.13",
+  "packageVersion": "2.0.15",
   "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 {
@@ -358,12 +352,13 @@ function createHandler({ configModule }) {
                 id: nextTask.id,
                 title: nextTask.title,
                 description: nextTask.description,
-                acceptanceCriteria: nextTask.acceptanceCriteria || []
+                acceptanceCriteria: nextTask.acceptanceCriteria || [],
+                file: 'planning/TASK_QUEUE.md'
               } : null,
               allComplete: !nextTask,
               message: nextTask
-                ? `Task complete! Next: ${nextTask.title}`
-                : 'All tasks complete! MVP build finished!'
+                ? `✓ Complete! Continue: implement ${nextTask.id} from planning/TASK_QUEUE.md`
+                : '🎉 MVP BUILD COMPLETE! All tasks finished.'
             }, null, 2)
           }]
         };
@@ -402,7 +397,6 @@ function createHandler({ configModule }) {
 
         if (nextTask) {
           buildState.updateProgress(projectRoot, nextTask.id, 'in_progress');
-          writeCurrentTaskFile(projectRoot, nextTask);
         }
 
         return {
@@ -417,7 +411,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 +436,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.13",
+  "version": "2.0.15",
   "description": "Development scaffolding with intelligence - AI-powered context, agents, and workflows for any MCP-compatible assistant",
   "keywords": [
     "ai",