# summary

Open a mid-phase gate to request input from another role.

# description

Registers a review request mid-phase (e.g. developer requesting sizing validation from architect,
or QA requesting criteria clarification from the product owner) without requiring a phase
transition. The gate is attached to the active phase's `reviewIds` list and persisted in
`.setup-agents/state/reviews.jsonl`.

Use `sf setup-agents review complete` to resolve the gate, then resume the run with
`sf setup-agents workflow run --resume`.

# flags.run.summary

Workflow run id.

# flags.run.description

The run id returned by `sf setup-agents workflow run`. Use `sf setup-agents workflow pending`
to find active run ids.

# flags.phase.summary

Phase that is opening the gate.

# flags.phase.description

The currently active phase requesting consultation, e.g. `developer`.

# flags.from.summary

Profile requesting the consultation.

# flags.from.description

The setup-agents profile that needs the input, e.g. `developer`.

# flags.to.summary

Profile that must respond.

# flags.to.description

The setup-agents profile that will provide input, e.g. `architect`.

# flags.summary.summary

Short description of what is needed.

# flags.summary.description

Describe the question or decision that requires input from the other role.

# flags.gate.summary

Gate label.

# flags.gate.description

Semantic label for this gate, e.g. `developer:sizing→architect` or `qa:criteria→ba`.
Defaults to `<from>→<to>`.

# examples

- Developer requests sizing validation from architect:

  <%= config.bin %> <%= command.id %> --run wf-123 --phase developer --from developer --to architect --gate "developer:sizing→architect" --summary "Story points ambiguous — is this a 5 or 8?"

- QA requests criteria clarification from product owner:

  <%= config.bin %> <%= command.id %> --run wf-123 --phase qa --from qa --to ba --gate "qa:criteria→ba" --summary "Acceptance criterion 3 is ambiguous for edge case X"

# info.created

Gate opened: %s

# info.resolve

    Resolve:  sf setup-agents review complete --id %s --result approved --reviewer %s

# info.resume

    Resume:   sf setup-agents workflow run --story %s --resume %s

# errors.run-not-found

Workflow run '%s' not found. Use `sf setup-agents workflow pending` to list active runs.

# errors.phase-not-active

Phase '%s' is not active in run '%s'. The phase must be in 'running' status to open a gate.