The attention queue ​
Everything that waits on someone is one item in one queue, so you have a single place to look. Each item names who must answer it, and a small model called the decider takes the routine ones off your hands.
flowchart TD
question([A run asks a question])
topic{Does it touch a<br/>guarded topic?}
decider[The decider reads your rules<br/>and the task]
quote{Can it quote a rule<br/>that settles it?}
answered([Answered, and the run carries on])
you([It waits for you:<br/>orc backlog answer])
question --> topic
topic -- yes --> you
topic -- no --> decider
decider --> quote
quote -- yes --> answered
quote -- no --> you
you --> answered
What opens an item ​
| Kind | What it is | Who owns it |
|---|---|---|
review-question | A question the review raised at its gate | The decider first |
worker-question | A question Pi asked mid-run with orc_ask | The decider first |
looping question | Pi failed one command 6 times in a row | You |
failing-command | Pi failed one command 3 times in a row, which only tells you | You |
run-died | A run failed or its start failed | You |
check-red | A check turned red on a closed task's pull request | You |
pr-ready | Every check is green on a closed task's pull request | You |
overdue-wait | A hold's date has passed | You |
An open item is overdue once more than 5 minutes have passed since it was asked.
The decider ​
Each beat hands every open item the decider owns to the decider, one short model call per question, with no tools. The decider reads your rules in ~/.orc/orchestrator.md, the instructions file of the task's project, and the task itself. It may answer only by quoting, word for word, the rule its answer rests on. An answer with no such quote goes to you instead.
Some questions never reach the decider. Orc checks each question's words against a fixed list of topics, and a question on that list goes straight to you.
- Deleting, and anything that cannot be undone.
- Security, keys or credentials, and logins.
- Merging, pushing and releasing.
- Spending.
- A site's look, and legal text.
The list is in the code, so no rule you write can widen what the decider answers.
The decider never has the last word. To replace one of its answers, run orc backlog answer <task-id> <question-id>=<text>, and your answer stands.
Answering ​
To see every open item, oldest first, run orc attention. To answer a question a run asked, run orc backlog answer <task-id> <question-id>=<text>. To answer a run event such as pr-ready, run orc attention answer <item-id> <words>. The chat and the App show the same items and take the same answers.