bootspring_loop | Bootspring Docs

Autonomous task loop management. Create PRDs, check status, and manage iterative task execution.

Overview#

The bootspring_loop tool manages autonomous development loops using PRDs (Product Requirements Documents). It helps you track progress through stories, manage iterative development, and maintain focus on completing features.

Parameters#

Parameter	Type	Required	Description
`action`	string	Yes	Action to perform
`name`	string	No	PRD or story name (for create/complete)
`storyId`	string	No	Story ID to mark complete
`prdPath`	string	No	Path to prd.json (default: tasks/prd.json)

Actions#

Action	Description
`status`	Get PRD overview and progress
`progress`	Alias for status
`next`	Get the next story to work on
`complete`	Mark a story as done
`create`	Create a new PRD

Usage Examples#

Check Status#

Use the bootspring_loop tool with:
- action: "status"

Response (with PRD):

## PRD Status: user-authentication

**Progress:** 2/5 stories complete (40%)

### Stories
1. [x] Setup Clerk integration
2. [x] Create sign-in page
3. [ ] Create sign-up page (IN PROGRESS)
4. [ ] Add protected routes
5. [ ] Implement session management

### Estimated Completion
Based on current velocity: ~2 days

Response (no PRD):

{
  "success": true,
  "summary": "No PRD found",
  "data": { "exists": false },
  "hints": [
    "Create a PRD with action=create name=\"feature-name\"",
    "PRDs help you track iterative development progress"
  ]
}

Get Next Story#

Use the bootspring_loop tool with:
- action: "next"

Response:

{
  "success": true,
  "summary": "Next Story: Create sign-up page",
  "data": {
    "id": "story-3",
    "title": "Create sign-up page",
    "description": "Build the user registration flow with email verification",
    "status": "pending",
    "acceptanceCriteria": [
      "Email/password form",
      "Form validation",
      "Email verification flow",
      "Success redirect"
    ]
  },
  "hints": [
    "Mark complete with action=complete storyId=\"story-3\""
  ]
}

Response (all complete):

{
  "success": true,
  "summary": "All stories complete!",
  "data": { "complete": true },
  "hints": ["Create a new PRD for your next feature"]
}

Complete a Story#

Use the bootspring_loop tool with:
- action: "complete"
- storyId: "story-3"

Response:

{
  "completed": "story-3",
  "progress": {
    "completed": 3,
    "total": 5,
    "percentage": 60
  },
  "allComplete": false
}

Create a PRD#

Use the bootspring_loop tool with:
- action: "create"
- name: "payment-integration"

Response:

{
  "created": "tasks/prd.json",
  "stories": 3,
  "message": "Edit the PRD to define your stories"
}

PRD File Format#

PRDs are stored as JSON:

{
  "name": "payment-integration",
  "description": "Created via MCP",
  "createdAt": "2024-03-20T10:00:00Z",
  "stories": [
    {
      "id": "story-1",
      "title": "Setup",
      "description": "Initial setup",
      "status": "pending"
    },
    {
      "id": "story-2",
      "title": "Implementation",
      "description": "Core implementation",
      "status": "pending"
    },
    {
      "id": "story-3",
      "title": "Testing",
      "description": "Add tests",
      "status": "pending"
    }
  ]
}

Configuration#

Configure PRD location in bootspring.config.js:

module.exports = {
  paths: {
    prd: 'tasks/prd.json'  // Default
  }
};

Workflow Integration#

Typical Development Loop#

1. Create PRD
   bootspring_loop action="create" name="new-feature"

2. Edit PRD
   Add detailed stories and acceptance criteria

3. Get Next Story
   bootspring_loop action="next"

4. Implement Story
   Work on the current story

5. Mark Complete
   bootspring_loop action="complete" storyId="story-1"

6. Repeat
   Continue until all stories complete

Combining with Agents#

1. Get next story
   bootspring_loop action="next"

2. Invoke relevant agent
   bootspring_agent agent="frontend-expert" context="Implement sign-up page"

3. Apply skills
   bootspring_skill action="show" name="auth/clerk"

4. Complete story
   bootspring_loop action="complete" storyId="story-3"

Error Handling#

Missing Story ID#

{
  "error": "storyId required"
}

PRD Not Found#

{
  "error": "No PRD found",
  "hints": ["Create a PRD first with action=create"]
}

Unknown Action#

{
  "error": "Unknown action: invalid"
}

Best Practices#

Define Clear Stories#

Each story should be:

Specific and actionable
Completable in 1-4 hours
Have clear acceptance criteria

Update Regularly#

Mark stories complete as you finish them to maintain accurate progress tracking.

Edit After Creation#

The created PRD has placeholder stories - customize them for your feature.

One Feature Per PRD#

Keep each PRD focused on a single feature or initiative.

CLI Integration#

# Check status
bootspring loop status

# Get next story
bootspring loop next

# Complete a story
bootspring loop complete story-3

# Create new PRD
bootspring loop create payment-integration

bootspring_prd - Advanced PRD management
bootspring_todo - Simple task management
bootspring_workflow - Workflow orchestration