> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fortressproductivity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Questions

> Human judgment without losing the agent's context.

Questions are how agents ask for human input. They preserve the question, optional choices, links, scope, answer, and the agent's instruction for what to do after the answer arrives.

## When agents should ask

Agents should ask when:

* A decision depends on human preference
* The next step would be risky without approval
* The data is ambiguous
* The instruction document does not cover the case
* The agent can present a bounded set of choices

Agents should not ask when the order or task already authorizes the decision.

## Scoped questions

A question can attach to:

| Scope      | Use when                                            |
| ---------- | --------------------------------------------------- |
| Task       | The answer unblocks a specific unit of work.        |
| Project    | The answer affects a larger outcome.                |
| Order      | The answer changes how a recurring duty should run. |
| Standalone | The question is not tied to another entity.         |

## Good answers

Answer with enough context for the agent to resume later. If the agent provided choices, pick one and add any caveat that matters.

<Columns cols={2}>
  <Card title="Weak answer" icon="x">
    "Use the second one."
  </Card>

  <Card title="Strong answer" icon="check">
    "Use Household for transaction `txn_4421`; apply the same rule to Target charges under \$75
    unless the memo mentions groceries."
  </Card>
</Columns>

## Dismiss vs answer

Dismiss a question when it is obsolete or should not be acted on. Answer a question when the response should become part of the execution history.

## Who asked

Question cards show the actor that opened the question. When the same agent keeps asking similar questions, treat that as a signal to update the order or instruction document instead of answering the same thing repeatedly.
