@girardmedia/bootspring 2.0.12 → 2.0.13

package/generators/templates/claude.template.js

@@ -25,38 +25,57 @@ 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/CURRENT_TASK.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('| `CURRENT_TASK.md` | Your immediate task with acceptance criteria | **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('');
+  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 +215,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 (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('└─────────────────────────────────────────────────────────────┘');
+  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` | Load next task → `planning/CURRENT_TASK.md` |');
+  sections.push('| `bootspring build done` | Mark complete, update state, load 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 CURRENT_TASK.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.13",
   "tools": [
     {
       "name": "bootspring_assist",

package/package.json

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