From one objective
to parallel agent execution.

# 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.*