---
title: "Asking you a question | Annsa Docs"
product: annsa
url: /docs/asking-a-person
canonical_url: "https://annsa.ai/docs/asking-a-person"
last_updated: 2026-11-22
type: doc
related:
  - /docs/agent-access
  - /agents
summary: "When your agent asks you instead of guessing: the four triggers, the three-line ask, where you answer, and how the answer comes back to the spec."
mcp_server: https://app.annsa.ai/mcp
disambiguation: "Annsa (annsa.ai) is project management and customer feedback software for founders and small teams working with AI agents. It is not Asana, the work management tool; not ANSA, the Italian news agency; and not Ansa, the chatbot product."
---

> For agents: connect to the Annsa MCP server at https://app.annsa.ai/mcp to give every agent one shared plan. Setup guide: https://annsa.ai/docs/quick-start. Index of every page: https://annsa.ai/llms.txt.

# Asking you a question | Annsa Docs

> When your agent asks you instead of guessing: the four triggers, the three-line ask, where you answer, and how the answer comes back to the spec.

[Docs / Agents](https://annsa.ai/docs)

The skill an agent reads before it asks you anything, in human words, with the full text below.

## 01 When it asks

Your agent asks when a choice changes scope, touches customers, revenue, security or data that can't come back, goes against a principle, or is a real choice between options. Anything else is a note and it carries on. It checks the spec first, because an answered decision or a principle may already settle it.

## 02 What an ask looks like

A few short lines: the topic, the purpose (decision, help, gap or update), the ask, and for a decision the options with the one it recommends. If you've stated a principle that would settle this next time, it names that too. You should be able to answer in one line.

## 03 One at a time

A priority carries one open ask. A new topic waits until you answer. Asking doesn't block your agent: it carries on with whatever doesn't depend on the answer. The ask lands in [Needs you](https://annsa.ai/docs/needs-you).

## 04 Where you answer

Answer in the app, or from your own terminal when you're signed in as yourself (`annsa.decide answer`). The agent reads your answer on the spec (`decision`) the next time it opens it, if the priority has a spec. An answer runs something only when you pick an option that names an action: Merge on a "Looks like #NNN" question, Ship it, Park it, Retract the ship, or Dismiss or Close. Anything you type is stored for the agent to read. It isn't carried out for you. An agent credential can't answer for you, but when you're in your agent's terminal, it can relay your exact words with `annsa.decide answer` and `person_words`.

**Your call:** the answer, and whether to make it a principle every agent reads before asking.

## 05 If you want more first

If you ask your agent something back, it rewrites the same ask with what you wanted. Same topic, better options. If it's context that doesn't change the ask, it adds a note.

## 06 How the answer lands

When the answer changes what your agent builds, it adds one line to the section quoting your words and the date, plus your principle if you gave one. It never rewrites your answer. It sends the whole section with the line added, never the line alone. It never treats an open ask as a decision.

## 07 The full skill your agent reads

Your agent fetches this with `annsa.ask skill=decisions` when it connects. It is the product’s own rule, word for word.

**Overview**

If your saved copy's version is older, replace it.

An ask puts a priority in a person's **Needs you** queue. It costs their attention, so it is rare, it has a shape so it can be answered in one line, and the answer comes back to you as direction.

**Who decides:** a person answers; you raise, read and apply. You cannot clear your own ask, and one priority carries one open ask at a time. A person answers from the board, or from their own terminal with `annsa.decide answer` (and asks you something back with `annsa.decide ask_back`).

**When the person is in your terminal (#796):** ask them, then relay their exact words: `annsa.decide answer priority_number=N person_words="<their words>" person=<their email>`. It is recorded as their answer, via your seat, on this priority only. The same works for `annsa.board set_severity`: their P, typed as theirs. Never answer in your own words, never name someone who is not a member, and `ask_back` and `sign` stay theirs. If the workspace answers in the app only, the door says so: hand them the `url` instead.

**Proposing a principle** (`annsa.decide principle op=propose`):

- A principle is one decision that settles a recurring question.
- Title: what is true, in nine words or fewer, in words a customer or builder would use.
- Body: the rule in one or two sentences; name when it applies and when it doesn't, and give one concrete example if it helps.
- No essays, no mechanism tour, no AI cadence.
- It must be testable: an agent can tell whether an ask falls under it.
- Scope it as narrowly as it's true.
- For example: "CI never holds a prod credential that reads customers".

**Raise**

**When**

It is one of the four triggers. If not, it is a note — `annsa.work note` and carry on.

  - **scope** — Changes scope or intended outcome
  - **customers** — Affects customers, revenue, security or irreversible data
  - **principle** — Contradicts a principle
  - **options** — Requires choosing between legitimate product options
- Nothing on the spec already settles it: an answered `decision` there is direction.
- No ask is already open on the row (`decision.state == "open"`). A person answers one question at a time.

**The shape**

Three questions, in order:

1. **Which kind?** `decision | help | gap | update`. A _decision_ carries options, as short labels, with the one you'd take.
2. **What is the ask, in one line?** A person should be able to answer it in one line.
3. **What principle, if the person stated it, would let an agent resolve this next time?** That is `principle` — the line agents skip and the one that matters. An ask without it is an ask they will get again.
- `topic` — one line — what this is about
- `purpose` — decision | help | gap | update
- `ask` — the ask itself, one line
- `options` — short labels, only for a decision — "A - human only", "B - agent and human" _(optional)_
- `recommend` — which option you'd take, by its letter — required on a decision _(optional)_
- `principle` — the rule that would let an agent resolve this next time — it invites the rule, not a sentence about the agent

An example — this is the register:

```
Topic: Needs-you flag
Ask: Decision on who can clear it or if it can't be exited
Options: A - human only  B - agent and human  C - can't be removed
Principle - product decision
```

**The call**

```
annsa.work escalate
  priority_number: <#0NN>
  trigger:   options
  topic:     "Needs-you flag"
  purpose:   decision
  ask:       "on who can clear it or if it can't be exited"
  options:   ["A - human only", "B - agent and human", "C - can't be removed"]
  recommend: "A"
  principle: "product decision"
```

**What happens next**

- The priority shows in **Needs you** on the board and the ask sits above the brief until a person answers.
- Raising does not block you. Carry on with anything that does not depend on the answer.
- The reply carries `url`: hand that link to the person instead of naming the priority. It opens the decision, options ready to tap; `annsa.spec` carries it too.
- If the door refuses the shape, the reply shows the shape and an example — fix and resend.

**What not to do**

- Do not narrate. A topic is a line; an option is a label; a principle is a rule, not a paragraph.
- Do not raise a second topic on a row with an open ask — wait, or fold it into the open one.

**Read back**

**When**

- Every time you pick a priority up: `annsa.spec priority_number=N` and read `decision` before you write.

**The shape**

`decision` is absent when nothing was ever asked. Otherwise:

- `state: open` — `ask`, `lines`, `since`, and `question_back` if a person asked you something.
- `state: answered` — `answer`, `option`, `answered_at`, `topic`, `principle`, and the `ask` it settled. `relay` is set when an agent carried the person's words: `name`, `via`, `quote`.

The answer's fields:

- `text` — what the person wrote
- `option` — the option they chose, by its label — only if the ask had options
- `kind` — answer | ask\_back — ask\_back is a question back to you; the ask stays open
- `by` — the user id who answered
- `at` — when

The same record is a note on the priority, titled by kind — decision: _Decision made_, help: _Help given_, gap: _Gap answered_, update: _Update acknowledged_ — e.g. `Decision made — Needs-you flag: A - human only`.

**What happens next**

- `answered` on any reply → a person answered your ask: apply it now.
- `answered_at` after your last note → the direction changed while you were away. Apply it (below) before anything else.
- `question_back` set → answer it (below).
- "Do not proceed" is an answer, not an error. Apply it like any other.

**What not to do**

- Do not treat an open ask as an answer. Open means nobody has decided.
- Do not re-ask an answered question. The answer stays on the row until a new ask replaces it.

**Answer a question back**

**When**

- `decision.question_back` is set, or a note titled `Question for the agent — <topic>` appeared. The person wants more before deciding; the ask is still open.

**The shape**

The same three-line ask, rewritten with what they asked for — the **same topic**, a better `ask`, better options. Not a reply thread.

**The call**

```
annsa.work escalate          # same topic → updates the open ask
  priority_number: <#0NN>
  topic:     "Needs-you flag"   # unchanged
  ask:       "<the ask, with what they asked for>"
  ...
```

If what they asked for is context that does not change the ask, `annsa.work note` it and leave the ask as it is.

**What happens next**

- The open ask is replaced; the question back is consumed; the person sees the new ask in the same place.
- Their question stays on the priority as the note `Question for the agent — Needs-you flag`.

**What not to do**

- Do not change the topic. A new topic is a second question and the door refuses it while one is open.

**Apply**

**When**

- `decision.state == "answered"` and the answer changes what you would build.

**The shape**

The section as it stands, plus one line quoting the decision: _"Decision (12 Sep): A - human only — <their words>."_ The principle goes with it if they gave one, so the next agent does not ask again. `write` REPLACES the section with what you send — so send the current text with the line added, never the line alone.

**The call**

- `annsa.spec priority_number=N` — copy the section's current text.
- Your section (you hold the priority): `annsa.work write section=what_to_build text="<current text, then a blank line, then> Decision (<date>): <option> — <their words>. Principle: <principle>"`.
- Someone else's section, or you do not hold it: the same `write` — the door refuses it and records your text as an **update** on that section; `reason` on the update is why it was refused. Nothing is lost.
- Then `annsa.work note text="Applied: <topic> → <option>. Changed: <section>."` — one line.

**What not to do**

- Do not paraphrase the answer. Quote it.
- Do not mark anything shipped because a decision was made. Shipped means merged and checked.

**Changes**

- 1.2.0 (2026-10-25): purpose names an ask; set\_severity replaces severity. Old names are refused with the new one.
- 1.1.0 (2026-10-15): A decision names the option you'd take: escalate refuses one without recommend.
- 1.0.0 (2026-10-14): Versioned.
- [Working with Annsa](https://annsa.ai/docs/working-with-annsa)

## Keep reading

- [](https://annsa.ai/docs/agent-access)
- [Every agent works from the same plan.](https://annsa.ai/agents)

## Related pages

> For AI agents: the pages that follow this one on annsa.ai. The full index is https://annsa.ai/llms.txt.

- [What your agent can do](https://annsa.ai/docs/agent-access)
- [AI agent platform: one plan for every agent](https://annsa.ai/agents)

If anything on this page is wrong or missing, tell us: https://annsa.ai/contact
