bootspring_seed
Manage seed configuration and project scaffolding. Setup input folders, run questionnaire, ingest files, generate documents, and scaffold projects.
Overview#
The bootspring_seed tool is your project bootstrapping companion. It helps you set up input folders for existing files, ingest and analyze those files, generate documentation, and scaffold new project structures based on presets or custom configurations.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | Yes | Action to perform |
preset | string | No | Preset for init or scaffold |
format | string | No | Export format: json or yaml |
dryRun | boolean | No | Show scaffold plan without creating files |
Actions#
| Action | Description |
|---|---|
setup | Create input folder structure |
init | Run questionnaire (CLI only) |
generate | Ingest files and generate documents |
scaffold | Create project structure |
status | Show current configuration |
export | Export configuration as JSON/YAML |
Init Presets#
| Preset | Description |
|---|---|
minimal | Basic project setup |
standard | Standard configuration (default) |
full | All options enabled |
startup | Startup-focused setup |
api | API-first configuration |
Scaffold Presets#
| Preset | Description |
|---|---|
nextjs | Next.js with App Router |
react | React SPA |
node | Node.js backend |
fullstack | Full-stack application |
Usage Examples#
Setup Input Folders#
Use the bootspring_seed tool with:
- action: "setup"
Response:
.bootspring/ ├── inputs/ │ ├── mvp/source/ # AI-generated MVP code │ ├── business/ # Business plans, pitch decks │ ├── prd/ # Product requirements │ ├── designs/ # Figma exports, wireframes │ ├── legal/ # Terms, privacy policies │ ├── api/ # OpenAPI specs │ └── data/ # Sample data, schemas ├── generated/ # Bootspring output ├── context/ # AI context index └── logs/ # Action history
**Next Steps:**
1. Drop your files in `.bootspring/inputs/` subfolders
2. Run `bootspring_seed` with action: "generate" to process them
Generate Documents#
Use the bootspring_seed tool with:
- action: "generate"
Response:
Scaffold with Preset#
Use the bootspring_seed tool with:
- action: "scaffold"
- preset: "nextjs"
Response:
Scaffold Dry Run#
Use the bootspring_seed tool with:
- action: "scaffold"
- preset: "fullstack"
- dryRun: true
Response:
Check Status#
Use the bootspring_seed tool with:
- action: "status"
Response:
Export Configuration#
Use the bootspring_seed tool with:
- action: "export"
- format: "yaml"
Response:
## SEED.md Format
The SEED.md file contains your project configuration:
```markdown
# Project Seed Configuration
## Project Info
```yaml
project:
name: my-app
description: My application description
Tech Stack#
Frontend#
Features#
## Input Folder Structure
After running `setup`, drop files in these locations:
| Folder | What to Put Here |
|--------|------------------|
| `mvp/source/` | AI-generated MVP code (Lovable, Bolt, V0, etc.) |
| `business/` | Business plans, pitch decks, market research |
| `prd/` | Product requirements documents |
| `designs/` | Figma exports, wireframes, mockups |
| `legal/` | Existing terms, privacy policies |
| `api/` | OpenAPI specs, API documentation |
| `data/` | Sample data, database schemas |
## Error Handling
### No SEED.md Found
```json
{
"warning": "No SEED.md found",
"hints": [
"Use preset parameter: nextjs, react, node, fullstack",
"Or run \"bootspring seed init\" first"
]
}
Invalid Preset#
No Inputs Folder#
CLI Integration#
The seed tool has full CLI support:
Best Practices#
Start with Setup#
Always run setup first to create the proper folder structure.
Organize Your Inputs#
Place files in the correct input folders for better analysis.
Use Presets#
Start with a preset that matches your project type, then customize.
Review Generated Docs#
Check .bootspring/generated/ before scaffolding to ensure accuracy.
Dry Run First#
Use dryRun: true to preview what will be created before scaffolding.
Related Tools#
- bootspring_prd - Manage PRDs from inputs
- bootspring_generate - Generate CLAUDE.md
- bootspring_context - Project context management