.task-spec-template.md

Task Spec: [FEATURE NAME]

What

[One-line description of what needs to happen]

Why

[Context — what problem this solves or what Jay asked for]

Files to Change

• path/to/file1.tsx — [what changes]
• path/to/file2.tsx — [what changes]
• path/to/file3.ts — [what changes]

Design Decisions

• [Any shared tokens, variable names, patterns agents must follow]
• [Theme: use bg-[var(--surface)], text-[var(--text)], etc.]
• [Data: which Supabase table/RPC, what the shape looks like]

Edge Cases

• [Race conditions to watch for]
• [Error states to handle]
• [Permission checks needed]

Acceptance Criteria

• npm run build passes
• Feature works in light mode
• Feature works in dark mode
• Mobile responsive
• Error states handled

Agent Assignment

File	Agent	Status
file1.tsx	Codex worker	⏳
file2.tsx	Codex worker	⏳
Review	Codex reviewer	⏳