bootspring_prd
Manage Product Requirements Documents. Create PRDs, import existing documents, convert to tasks, and track status.
Overview#
The bootspring_prd tool provides comprehensive PRD management. Create new PRDs, import existing documents, extract user stories and requirements, convert them to actionable tasks, and track overall PRD health.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | Yes | Action to perform |
name | string | No | PRD name for create/show actions |
title | string | No | PRD title for create action |
description | string | No | PRD description for create action |
features | array | No | Feature list for create action |
Actions#
| Action | Description |
|---|---|
create | Create a new PRD |
list | Show all PRDs |
show | View a specific PRD |
import | Process input files into PRDs |
to-tasks | Convert PRD to todo items |
status | Get PRD health metrics |
analyze | Extract insights from PRDs |
Usage Examples#
Create a PRD#
Use the bootspring_prd tool with:
- action: "create"
- name: "user-authentication"
- title: "User Authentication System"
- description: "Complete authentication flow with social login support"
- features: ["Email/password login", "OAuth providers", "Session management", "Password reset"]
Response:
1## PRD Created
2
3**File:** `.bootspring/generated/prd/user-authentication.md`
4
5**Title:** User Authentication System
6
7**Features:** 4
8
9**Next Steps:**
101. Edit the PRD to add details
112. Run `bootspring_prd` with action: "to-tasks" to convert to todos
123. Share with stakeholders for reviewList All PRDs#
Use the bootspring_prd tool with:
- action: "list"
Response:
1## PRD List
2
3| Name | Title | Source | Modified |
4|------|-------|--------|----------|
5| user-authentication | User Authentication System | generated | 2024-03-20 |
6| payment-integration | Payment Integration | generated | 2024-03-18 |
7| dashboard-redesign | Dashboard Redesign | input | 2024-03-15 |
8
9**Total:** 3 PRDs
10
11**Commands:**
12- Show: `bootspring_prd` action: "show" name: "prd-name"
13- Convert: `bootspring_prd` action: "to-tasks" name: "prd-name"Show a PRD#
Use the bootspring_prd tool with:
- action: "show"
- name: "user-authentication"
Response:
1## User Authentication System
2
3**Source:** Generated
4**Status:** Draft
5
6---
7
8# User Authentication System
9
10**Status:** Draft
11**Created:** 2024-03-20
12**Author:** Bootspring
13
14## Overview
15
16Complete authentication flow with social login support.
17
18## Features
19
201. Email/password login
212. OAuth providers
223. Session management
234. Password reset
24
25## User Stories
26
27### As a user, I want to...
28
29- [ ] Sign up with email and password
30- [ ] Sign in with Google
31- [ ] Reset my forgotten password
32- [ ] Stay logged in across sessions
33
34...Import PRDs#
Use the bootspring_prd tool with:
- action: "import"
Response:
1## PRD Import Complete
2
3| File | User Stories | Features | Requirements |
4|------|--------------|----------|--------------|
5| product-spec.md | 12 | 8 | 15 |
6| feature-request.md | 5 | 3 | 7 |
7
8**Total Imported:** 2 files
9
10**Extracted:**
11- User Stories: 17
12- Features: 11
13- Requirements: 22
14
15**Next Steps:**
161. Run `bootspring_prd` action: "analyze" for insights
172. Run `bootspring_prd` action: "to-tasks" to create todosConvert to Tasks#
Use the bootspring_prd tool with:
- action: "to-tasks"
- name: "user-authentication"
Response:
1## Tasks Created from PRD
2
3**Source:** user-authentication
4**Tasks Found:** 15
5**Tasks Added:** 15
6
7**Sample Tasks:**
8- [story] Sign up with email and password
9- [story] Sign in with Google
10- [story] Reset my forgotten password
11- [requirement] Implement rate limiting on auth endpoints
12- [requirement] Add CSRF protection
13...
14
15**Next Steps:**
161. Run `bootspring_todo` action: "list" to see all tasks
172. Prioritize and assign tasksCheck PRD Status#
Use the bootspring_prd tool with:
- action: "status"
Response:
1## PRD Status
2
3| Metric | Count |
4|--------|-------|
5| Generated PRDs | 3 |
6| Input PRDs | 2 |
7| Draft Status | 4 |
8| Approved Status | 1 |
9| Total Features | 24 |
10| Total User Stories | 45 |
11
12**Health:** PRDs exist
13
14**Commands:**
15- Create: `bootspring_prd` action: "create" name: "feature-x"
16- Import: `bootspring_prd` action: "import"
17- Analyze: `bootspring_prd` action: "analyze"Analyze PRDs#
Use the bootspring_prd tool with:
- action: "analyze"
Response:
1## PRD Analysis
2
3**Documents Analyzed:** 5
4
5### User Stories (45)
6- As a user, I want to sign up with email...
7- As a user, I want to manage my subscription...
8- As an admin, I want to view user analytics...
9- As a user, I want to export my data...
10- As a user, I want to enable 2FA...
11... and 40 more
12
13### Features (24)
14- Email/password authentication
15- Social login (Google, GitHub)
16- Role-based access control
17- Usage analytics dashboard
18- Data export functionality
19... and 19 more
20
21### Requirements
22- **Must Have:** 18
23- **Should Have:** 12
24- **Nice to Have:** 8
25
26### Open Questions (7)
27- What OAuth providers should be supported?...
28- How long should sessions last?...
29- What data export formats are needed?...
30... and 4 more
31
32**Completeness Score:** 75%PRD File Format#
Generated PRDs follow this structure:
1# PRD Title
2
3**Status:** Draft
4**Created:** YYYY-MM-DD
5**Author:** Bootspring
6
7## Overview
8
9[Description of the feature/product]
10
11## Features
12
131. Feature 1
142. Feature 2
153. Feature 3
16
17## User Stories
18
19### As a user, I want to...
20
21- [ ] User story 1
22- [ ] User story 2
23- [ ] User story 3
24
25## Requirements
26
27### Must Have
28- Requirement 1
29- Requirement 2
30
31### Should Have
32- Requirement 3
33
34### Nice to Have
35- Requirement 4
36
37## Success Metrics
38
39- Metric 1
40- Metric 2
41
42## Open Questions
43
441. Question 1?
452. Question 2?
46
47---
48*Generated by Bootspring PRD System*File Locations#
| Type | Location |
|---|---|
| Generated PRDs | .bootspring/generated/prd/ |
| Input PRDs | .bootspring/inputs/prd/ |
Error Handling#
PRD Name Required#
{
"error": "PRD name required",
"hints": ["Provide name parameter for the PRD"]
}PRD Not Found#
{
"error": "PRD not found: invalid-name",
"hints": ["Use action: \"list\" to see available PRDs"]
}No PRDs to Analyze#
{
"warning": "No PRDs to analyze",
"hints": ["Create or import PRDs first"]
}No Input Files#
{
"warning": "No PRD files found in .bootspring/inputs/prd/",
"hints": ["Drop your PRD files there and run again"]
}CLI Integration#
1# Create PRD
2bootspring prd create --name user-auth --title "User Authentication"
3
4# List PRDs
5bootspring prd list
6
7# Show PRD
8bootspring prd show user-auth
9
10# Import from inputs
11bootspring prd import
12
13# Convert to tasks
14bootspring prd to-tasks --name user-auth
15
16# Check status
17bootspring prd status
18
19# Analyze PRDs
20bootspring prd analyzeBest Practices#
Clear User Stories#
Write user stories in the format: "As a [role], I want to [action] so that [benefit]"
Prioritize Requirements#
Use Must Have / Should Have / Nice to Have categories.
Regular Status Checks#
Run status regularly to track PRD health.
Convert to Tasks#
Use to-tasks to make PRDs actionable.
Keep PRDs Focused#
One feature or initiative per PRD.
Related Tools#
- bootspring_loop - PRD-based task loops
- bootspring_todo - Task management
- bootspring_seed - Project scaffolding with PRDs