playbook/antigravity-awesome-skills/skills/subagent-orchestrator/examples/nextjs-feature.md

Example: Building a Full Next.js Feature with 3 Parallel Agents

Scenario

User prompt: "Add a user authentication flow — login page, signup page, and a protected dashboard route."

---

Mission Brief (what orchestrator produces)

MISSION BRIEF
─────────────────────────────────────────
Goal: Auth flow with login, signup, and protected dashboard — all wired and working.
Total Agents: 3
Quota Strategy: FLASH for all, Sonnet for integration review only
Expected Token Cost: MEDIUM

AGENTS:
[1] ID: agent-001
    Role: Builder — Auth UI
    Scope: /app/login/page.tsx, /app/signup/page.tsx
    Model: Gemini Flash
    Input: Design system from GEMINI.md, form fields spec
    Output: Two complete page components with Tailwind styling
    Depends on: none

[2] ID: agent-002
    Role: Builder — API Routes
    Scope: /app/api/auth/login/route.ts, /app/api/auth/signup/route.ts
    Model: Gemini Flash
    Input: Auth logic spec, env variable names from .env.example
    Output: Two API route handlers with error responses
    Depends on: none

[3] ID: agent-003
    Role: Builder — Protected Route
    Scope: /app/dashboard/page.tsx, /middleware.ts
    Model: Gemini Flash
    Input: Output from agent-001 (session shape), output from agent-002 (token format)
    Output: Dashboard page + middleware redirect logic
    Depends on: agent-001, agent-002
─────────────────────────────────────────

---

Execution Flow

Round 1 (parallel):
  agent-001 → builds login + signup UI
  agent-002 → builds API routes

  [Spot check after Round 1]
  ✓ agent-001 stayed in /app/login and /app/signup only
  ✓ agent-002 used correct env variable names
  ✓ No TODOs left in either output

Round 2 (sequential, depends on Round 1):
  agent-003 → builds dashboard + middleware
              receives session shape from agent-001
              receives token format from agent-002

  [Spot check after Round 2]
  ✓ Middleware correctly references session cookie name
  ✓ Dashboard imports resolve to existing components
  ✓ No hardcoded redirect URLs

Integration Check:
  ✓ All imports resolve
  ✓ No duplicate type definitions
  ✓ Build mentally verified

---

Quota Log

Event	Impact
3 agents spawned	LOW
~12 files indexed total	LOW
~18 tool calls across all agents	MEDIUM
0 browser agents used	NONE
Total estimated	~25% sprint

Tip: This mission costs ~25% sprint quota. You can run 3–4 missions like this per day on the free tier.