bootspring_loop
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):
Loading code block...
Response (no PRD):
Loading code block...
Get Next Story#
Use the bootspring_loop tool with:
- action: "next"
Response:
Loading code block...
Response (all complete):
Loading code block...
Complete a Story#
Use the bootspring_loop tool with:
- action: "complete"
- storyId: "story-3"
Response:
Loading code block...
Create a PRD#
Use the bootspring_loop tool with:
- action: "create"
- name: "payment-integration"
Response:
Loading code block...
PRD File Format#
PRDs are stored as JSON:
Loading code block...
Configuration#
Configure PRD location in bootspring.config.js:
Loading code block...
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/jwt"
4. Complete story
bootspring_loop action="complete" storyId="story-3"
Error Handling#
Missing Story ID#
Loading code block...
PRD Not Found#
Loading code block...
Unknown Action#
Loading code block...
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#
Loading code block...
Related Tools#
- bootspring_prd - Advanced PRD management
- bootspring_todo - Simple task management
- bootspring_workflow - Workflow orchestration