# summary

Add a setup-agents decision record.

# description

Appends a JSON Lines decision entry to `.setup-agents/state/decisions.jsonl`.

Decision records capture selected approaches, rationale, ownership, timestamps, and optional task ids.

# flags.summary.summary

Short decision summary.

# flags.summary.description

Describe the decision in one concise sentence.

# flags.task.summary

Task or issue id for this decision.

# flags.task.description

Associate the decision with a task id such as `SA-96` or `#96`.

# flags.role.summary

Owning role for this decision.

# flags.role.description

Record the current role or agent owner responsible for the decision.

# flags.profile.summary

Owning setup-agents profile.

# flags.profile.description

Record the setup-agents profile responsible for the decision.

# flags.rationale.summary

Decision rationale.

# flags.rationale.description

Add the reason this decision was made.

# flags.status.summary

Decision status.

# flags.status.description

Set whether the decision is proposed, accepted, or superseded.

# flags.outcome.summary

Decision outcome.

# flags.outcome.description

Record the outcome text for the decision. When omitted, the status is used.

# flags.alternative.summary

Alternatives considered.

# flags.alternative.description

Comma-separated alternatives considered before this decision.

# flags.evidence.summary

Related evidence ids.

# flags.evidence.description

Comma-separated evidence record ids that support this decision.

# examples

- Add an accepted decision for a task:

  <%= config.bin %> <%= command.id %> --task SA-96 --profile architect --summary "Use native JSONL records" --rationale "Keeps setup-agents independent of external engines"

# info.created

Decision recorded: %s (%s)