Skip to content

Decisions and approvals

The Decisions panel is your queue for actions that need human input. When an agent encounters a gate, escalation, or conflict, it appears here for you to review and resolve.

Click Decisions in the sidebar to open the panel. A red badge shows the count of pending items.

Decision types

Gate approvals

Gates are checkpoints in the agent lifecycle or Blueprint pipeline. When an agent reaches a gate, it pauses and waits for your approval.

Each gate card shows:

  • The agent requesting approval
  • The current stage and the stage it wants to enter
  • A prompt explaining what the agent plans to do

You can Approve to let the agent proceed, or Reject with Feedback to send it back with instructions.

Escalations

When an agent encounters something it cannot handle alone, it escalates to you. Escalation cards show a severity level and the agent's request.

Severity levels:

  • Blocking (red): the agent is stopped until you respond
  • Needs Decision (yellow): the agent needs guidance on which direction to take
  • Informational (blue): the agent is sharing context, no action required

Escalations may include predefined options for you to choose from, or you can write a custom response.

Conflicts

When two agents disagree or produce contradictory work, a conflict card appears. It shows each agent's position and evidence side by side.

You resolve conflicts by writing a decision that settles the disagreement. Ironspire sends the resolution to both agents.

Resolved decisions fade out after a few seconds. The decision queue is empty when no agents need your attention.

Workflow

  1. A decision card appears in the queue (newest first)
  2. Click to expand and review the full context
  3. Take action (approve, reject, respond, or resolve)
  4. Ironspire sends the resolution to the agent
  5. The card fades out with a confirmation indicator

In Normal interaction mode, tool approval prompts appear inline in the chat. The Decisions panel is for higher-level decisions like lifecycle gates, escalations, and conflicts from the Foundry engine.

Next steps