Preseed vs Seed (naming)
Preseed remains the internal document-capture stage of the Seed loop — not a separate product.
Decision (bs-8334): Keep /preseed routes, APIs, and .bootspring/preseed/ as a legacy / internal project-builder stage of the Seed loop. Do not rename production APIs for launch. Do not market “preseed” as a separate product.
Canonical product language
| Say this (public) | Means |
|---|---|
| Seed loop | Idea → context docs → SEED.md merge → agent files → build |
| Seed context documents | Vision, PRD, audience, etc. that feed merge |
| Seed generator / BYOK | Dashboard flow that drafts those context docs with your keys |
| Internal / stable technical names | Role |
|---|---|
bootspring seed * | Primary CLI surface |
.bootspring/context/ | Preferred context doc location for seed init / seed merge |
.bootspring/preseed/ | Legacy document store still produced by older wizards and some dashboard builders |
/dashboard/projects/:id/preseed | Dashboard project-builder UI (stack + wizard) |
/api/projects/:id/preseed/* | Control-plane persistence for that builder |
Why we keep the routes
- Preseed APIs and pages are wired and tested (wizard, studio, upload, generate).
- The CLI seed pipeline still accepts preseed docs as an input to merge.
- A full rename would break CLI, dashboard, and stored project settings without launch benefit.
What we change for launch honesty
- Docs lead with Seed (
bootspring seed init|merge|go), not preseed. - Marketing says “seed context documents,” not “preseed product.”
- Dashboard labels preseed pages as Seed project builder (legacy preseed stage).
- Support language treats preseed as “project builder / seed docs,” never a second onboarding path.
Operator path (recommended)
Loading code block...
Dashboard path (optional, same loop):
- Create a project
- Open Seed project builder (
/dashboard/projects/:id/preseed) - Fill wizard / stack
- Export or merge into local seed docs
- Continue with CLI
seed merge+build
Non-goals
- No silent delete of
/preseedroutes for launch - No dual “preseed product” marketing
- No claim that every agent is production-routed after seed merge