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

88 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 34 missions like this per day on the free tier.