Playground
Input
What does this project do?
Shape of the final deliverable.
Which adapters to generate.
Target OS adapters.
Drives worker count + decomposition depth.
Higher risk → more workers.
How hard to fan out waves.
Prose density of generated docs.
Where it lands.
Preview
SEED-specseed-io.md131 lines
# SpecSeed: SpecSeed.io
> Master orchestration seed. Generated by SpecSeed.io.
## 1. Objective
Generate the master seed that turns one project objective into parallel agent execution.
Deliverable shape: **SaaS application**.
## 2. Operating Principle
One agent orchestrates the whole wave. It decomposes, dispatches subagents in parallel, collapses their output, and moves on only when the artifact passes review.
- Plan before code. Collapse each phase into a `_mos/` artifact.
- One wave at a time. Do not skip ahead.
- Trust but verify. Lint + build after every material change.
- Reversible by default. Do not introduce flags for hypothetical futures.
## 3. Target Runtime
Deployment target: **Vercel**.
Developer environment: **macOS and Ubuntu**.
Stack / repo notes:
```
Next.js App Router, TypeScript strict, Tailwind CSS, Framer Motion.
```
## 4. Global Constraints
- No paid LLM API calls in MVP. Pure TypeScript template generation. Deterministic output.
Fleet guardrails (always active):
- No destructive fs operations without explicit operator checkpoint.
- No global package installs without operator approval.
- No skipped hooks or disabled type-checking to force a green build.
- No secrets in committed files.
## 5. Nine-Phase Octopus
The root orchestrator runs the phases in order. Each phase produces a collapse artifact before the next begins.
| # | Name | Model | Effort | Duration | Fan-out | Workers | Artifact |
| --- | ------------ | ------ | ------- | -------- | ------------------- | ------- | ------------------- |
| 0 | Recon | Haiku | default | 30s | Inventory ×1 | 1 | 00-recon.md |
| 1 | Strategy | Opus | high | 2m | Strategy ×1 | 1 | 01-strategy.md |
| 2 | Decompose | Opus | high | 2m | Decomposer A, B | 2 | 02-decomposition.md |
| 3 | Architecture | Opus | high | 3m | Architect A, B | 2 | 03-architecture.md |
| 4 | Build | Sonnet | default | 5m | Builder × workerCap | 5 | 04-build-diffs |
| 5 | Wire | Sonnet | default | 3m | Wiring ×1 | 1 | 05-wire.md |
| 6 | Test | Sonnet | default | 3m | Tester ×1 | 1 | 06-verification.md |
| 7 | Review | Opus | high | 2m | Reviewer ×1 | 1 | 07-review.md |
| 8 | Integration | Opus | high | 2m | Integrator ×1 | 1 | 08-integration.md |
## 6. Agent Roles
This plan uses **flat workers** — no nested reviewer pairs.
| Role | Tier | Active in phases | Blurb |
| ---------- | ------ | ---------------- | ---------------------------------------------------- |
| Recon | Haiku | #0 | Inventory the box and toolchain. Read-only. |
| Strategist | Opus | #1 | Lock stack, output mode, and dep list. |
| Decomposer | Opus | #2 | Fan tasks out; produce dep graph + build groups. |
| Architect | Opus | #3 | Final file tree + interfaces + config contracts. |
| Builder | Sonnet | #4 | Implement one scoped task. No adjacent refactors. |
| Wirer | Sonnet | #5 | Connect components, routes, and public assets. |
| Tester | Sonnet | #6 | Run lint + build + DoD checklist. |
| Reviewer | Opus | #7 | Read-only pass. No edits. Flag risk and regressions. |
| Integrator | Opus | #8 | Deploy, smoke-test, close out _mos/. |
Platforms: both Claude Code (Section 8) and Codex (Section 9).
## 7. Wave Plan
- workerCap = **5** (clamped to [1, 12]).
- decompositionDepth = **2**.
- useAgentTeams = **false**.
- Build phase fans out **5** parallel workers.
Formula:
```
workerCap = clamp(1, 12, SCOPE_BASE[scope] + PARALLELISM_BOOST[parallelism] + RISK_BOOST[risk])
SCOPE_BASE = { tiny:1, small:2, medium:4, large:6, platform:8 }
PARA_BOOST = { conservative:-1, balanced:0, aggressive:2 }
RISK_BOOST = { low:0, medium:1, high:2 }
```
## 8. Claude Code Adapter
Ship these files at the repo root:
- `CLAUDE.md` — mission + operating doctrine + build commands. Under 200 lines.
- `.claude/agents/reviewer.md` — Opus, read-only, P0/P1/P2 flags.
- `.claude/agents/recon.md` — Haiku, inventory the repo on session start.
- `.claude/agents/tester.md` — Sonnet, runs lint + build.
Verification: run lint + build after every material change. Do not suppress type errors.
## 9. Codex Adapter
Ship these files at the repo root:
- `AGENTS.md` — purpose, explicit spawn pattern, scope boundaries.
- `.codex/config.toml` — `[agents] max_threads=6 max_depth=1`.
- `.codex/agents/reviewer.toml` — o3, high reasoning, read-only.
- `.codex/agents/worker.toml` — o4-mini, medium reasoning, workspace-write.
Spawn pattern: explicit — "Spawn one agent for X, one for Y. Wait for both. Consolidate before editing."
## 10. OS Adapter
Multi-OS: both scripts ship. macOS dev / Ubuntu prod is a common pattern.
Adapter files in the bundle:
- `macos-setup.sh` — bash, `set -euo pipefail`, node/npm version check.
- `ubuntu-bootstrap.md` — apt bootstrap runbook with nginx + certbot.
## 11. Definition of Done
- `npm run lint` passes with zero errors.
- `npm run build` completes successfully.
- TypeScript reports zero errors.
- Every feature listed in §1 works end-to-end.
- Adapter files exist and are syntactically valid.
---
*Generated by SpecSeed.io — deterministic template output.*