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