# summary

Record a decomposition vote for a task.

# description

BA and Architect independently assess whether a task is too large for a single sprint.
Both must vote before consensus is reached. If either votes `decompose`, the task is
escalated to an epic and the workflow pauses for sub-story creation.

Consensus rules:

- Both vote `proceed` → task continues as a story
- Either votes `decompose` → task becomes an epic, workflow pauses

Use `sf setup-agents task create --parent-id <epic-id>` to create subtasks after decomposition.

# flags.story.summary

Task or story id to vote on.

# flags.story.description

The task id that BA and Architect are evaluating for decomposition, e.g. `sa-241`.

# flags.voter.summary

Role casting the vote.

# flags.voter.description

Must be `ba` (functional complexity) or `architect` (technical complexity). Each role votes once.

# flags.verdict.summary

Decomposition verdict.

# flags.verdict.description

`proceed` if the task fits in a single sprint, or `decompose` if it should be split into sub-stories.

# flags.reason.summary

Reason for the verdict.

# flags.reason.description

Explain why the task should proceed or be decomposed. BA focuses on functional scope (acceptance criteria count, journey complexity). Architect focuses on technical scope (coupling, unknowns, integration surface).

# flags.splits.summary

Suggested sub-story titles.

# flags.splits.description

When voting `decompose`, provide suggested sub-story summaries. Repeat the flag for multiple splits.

# examples

- BA votes to decompose a task:

  <%= config.bin %> <%= command.id %> --story sa-241 --voter ba --verdict decompose --reason "12 acceptance criteria spanning 3 user journeys" --splits "User registration flow" --splits "Admin approval flow" --splits "Notification integration"

- Architect votes to proceed:

  <%= config.bin %> <%= command.id %> --story sa-241 --voter architect --verdict proceed --reason "Single bounded context, well-isolated from existing modules"

- Architect votes to decompose (escalates to epic):

  <%= config.bin %> <%= command.id %> --story sa-241 --voter architect --verdict decompose --reason "Requires 3 new integrations and a schema migration" --splits "Schema migration" --splits "External API integration" --splits "UI updates"

# info.decompose

Task %s escalated to epic — create subtasks before resuming workflow.

# info.splits

Suggested splits: %s

# info.proceed

Task %s consensus: proceed as story — workflow may continue.

# info.pending

Waiting for %s vote before consensus can be reached.