spec-delegated

name	spec-delegated
description	Use after /dream-team:plan to write a delegated execution spec (orchestrator + sub-agents). No arguments needed — picks up conversation context from the brainstorming session.
hooks	{"Stop":[{"hooks":[{"type":"command","command":"node ${CLAUDE_PLUGIN_ROOT}/hooks/validate_spec_exists.js --directory specs --extension .md"},{"type":"command","command":"node ${CLAUDE_PLUGIN_ROOT}/hooks/validate_spec_sections.js --directory specs"}]}]}

Write Delegated Spec

Convert the brainstorming conversation into a formal spec file for delegated execution — single session with an orchestrator dispatching specialized sub-agents via the Task tool.

Prerequisites: This skill assumes /dream-team:plan has already been run in this session. If the conversation has no brainstorming context (no discussed requirements, no confirmed approach, no validated task breakdown), stop and tell the user: "No brainstorming context found. Run /dream-team:plan <prompt> first to explore requirements and design."

What To Do

1. Read the spec template at ${CLAUDE_PLUGIN_ROOT}/templates/spec-template.md and the spec writing guide at ${CLAUDE_PLUGIN_ROOT}/templates/spec-writing-guide.md. Follow the guide's filename format, ambiguity elimination, and git instructions.
2. Read the available agent definitions at ${CLAUDE_PLUGIN_ROOT}/agents/*.md to understand each agent's capabilities.
3. Summarize the agreed plan from the conversation — confirm with the user before writing.
4. Write the spec, filling in all sections from the brainstorming context.
5. Set frontmatter mode: delegated and spec-version: 1.
6. Set frontmatter playwright: true if the brainstorming decided to use Playwright MCP, otherwise playwright: false.
7. Set frontmatter frontend-design: true if the brainstorming discussed frontend/UI work and design direction, otherwise frontend-design: false.
8. If frontend-design: true, fill in the ## Design Direction section with the aesthetic style, stack, component libraries, and design notes from the brainstorming conversation. Auto-suggest component libraries based on the chosen stack if not explicitly discussed.
9. Assign each task to a specific agent by name and type.
10. Mark tasks as background: true when they can safely run in parallel (no file conflicts, no dependencies).
11. Include Team Members and Review Policy sections.
12. Include a reviewer agent for post-task code review.
13. Include a validator agent for final verification.
14. Fill in the ## Cleanup section with any teardown commands needed (stop servers, remove temp files). Use "N/A" if nothing to clean up.
15. Save to specs/YYYY-MM-DD-<descriptive-kebab-case>.md using today's date.

Task Rules

• Every task must have Assigned To (agent display name) and Agent Type (builder, researcher, etc.)
• Mark Background: true for tasks that can run in parallel with other background tasks
• Mark Background: false for tasks that must complete before dependent tasks start
• Set Depends On accurately — parallel tasks should not depend on each other
• Every builder task must include a Tests field listing the test file paths and test cases it must produce. Use "N/A" only for tasks with zero testable code (research, docs, config-only).
• Every builder task must include a **Files** field listing exactly which files it creates or modifies, prefixed with creates: or modifies:. Review, research, and validation tasks may omit this field.
• Each builder task should produce 1-3 files and ~100-300 lines of code. If a task would be larger, split it into smaller tasks with clear file boundaries.
• For background builder tasks (Background: true), verify that their **Files** fields do not overlap. Tasks with overlapping files must not both be Background: true.
• Research tasks go first, then architecture, then building, then testing, then validation
• After every builder task that writes code, add a review task assigned to the reviewer agent. The review task depends on the builder task it reviews.
• Add tester tasks when appropriate — do NOT add them by default for every builder task (builders already do TDD). Add a tester task when: (a) multiple builder tasks produce components that must integrate — the tester writes integration tests after both complete; (b) the project handles user input, auth, or has security-sensitive APIs — the tester writes adversarial/boundary tests; (c) acceptance criteria span the full stack — the tester writes E2E tests after all builders finish. Tester tasks depend on the builder task(s) they test and should run before or alongside the final review.
• The second-to-last task MUST be a final code review (reviewer) that depends on all builder tasks
• The final task should always be assigned to the validator agent, depending on the final review

Review Policy Defaults

Use these defaults unless the brainstorming conversation specified otherwise:

• Review After: each task
• Fix Loop Trigger: Critical and Important
• Max Retries: 3
• Skip Review For: researcher, validator

Team Members Format

List only the agents actually assigned to tasks:

- <Display Name>
  - **Role**: <specific focus in this plan>
  - **Agent Type**: <builder | researcher | reviewer | validator | architect | tester>

Report

After saving and committing the spec, output:

Spec written (delegated mode)

File: specs/YYYY-MM-DD-<name>.md
Tasks: <number of tasks>
Complexity: <simple | medium | complex>
Team: <list of agent names and roles>

Execute with: /dream-team:build specs/YYYY-MM-DD-<name>.md