# summary

Create a setup-agents task.

# description

Appends a JSON Lines task entry to `.setup-agents/state/tasks.jsonl`.

Task records capture id, summary, status, setup-agents profile owner, timestamps, and related evidence ids.

# flags.id.summary

Task id.

# flags.id.description

Use a specific task id instead of generating one.

# flags.summary.summary

Short task summary.

# flags.summary.description

Describe the task in one concise sentence.

# flags.role.summary

Owning role for this task.

# flags.role.description

Alias for a setup-agents profile owner such as `developer`, stored as `setup-agents:developer`.

# flags.profile.summary

Owning setup-agents profile.

# flags.profile.description

Record the setup-agents profile responsible for this task.

# flags.mode.summary

Workspace mode for the task.

# flags.mode.description

Record whether this task belongs to project or advisory orchestration mode.

# flags.evidence.summary

Related evidence ids.

# flags.evidence.description

Comma-separated evidence record ids that support this task.

# flags.required-roles.summary

Required roles for this task.

# flags.required-roles.description

Comma-separated profile/phase ids that must participate in the workflow for this task. Determines which phases are included in the phase sequence.

# flags.optional-roles.summary

Optional roles for this task.

# flags.optional-roles.description

Comma-separated profile/phase ids that may participate in the workflow. These phases are included but not strictly required for task completion.

# examples

- Create an unclaimed task:

  <%= config.bin %> <%= command.id %> --summary "Implement task CLI"

- Create a task owned by a profile:

  <%= config.bin %> <%= command.id %> --id SA-97 --profile developer --summary "Implement task CLI"

- Create an advisory task:

  <%= config.bin %> <%= command.id %> --mode advisory --summary "Compare implementation options"

- Create a task with required and optional roles:

  <%= config.bin %> <%= command.id %> --summary "Build login page" --required-roles "ux,developer" --optional-roles "security"

- Create a task with declared phases:

  <%= config.bin %> <%= command.id %> --summary "Quick fix" --declared-phases "developer,qa"

# flags.declared-phases.summary

Phases to include in this task's workflow.

# flags.declared-phases.description

Comma-separated phase ids to include in the workflow for this task. Phases listed here are added to the plan alongside always-included phases. Use this instead of roles when you want to control the exact phase sequence.

# flags.routing-override-rationale.summary

Reason for overriding deterministic profile inference.

# info.created

Task created: %s (%s)