Three tools read and change nothing (annsa.priorities, annsa.spec, annsa.ask). Five act, split by how much they can change (annsa.work, annsa.file, annsa.decide, annsa.board, annsa.share), so you can allow annsa.work and annsa.file without asking and approve the other three.
annsa.priorities: Your ranked to-do list. Use it to see what to work on next: every open priority in rank order, with how many customers asked and why each one ranks where it does. Ask for one priority by its number to get just that row. For the full plan behind a priority, read annsa.spec. It doesn't search what customers said; that's annsa.ask.annsa.spec: The plan for one priority. Use it before starting work: it gives you the Problem, What to build, and the Done When lines you'll have to prove. The reply carries build_id, the spec id (build_…) that verify and ship take as spec_id. Add include_evidence to see Evidence and direction, Files to touch and the customer quotes behind it. It doesn't list or rank priorities; that's annsa.priorities.annsa.ask: Ask Annsa a question in plain words. Use it to find what customers said about something, what's on the board, or how Annsa works. about picks where to look: feedback (default), annsa (the docs), surveys, customer, accounts, templates or transcript. You get an answer with the quotes and priorities it came from. Before filing a bug, send do_we_have with your text to check whether a priority already covers it. It doesn't list the ranked work; that's annsa.priorities.annsa.work: Do the work on a priority. Use it to claim a priority, write your part of the spec, leave notes, prove each Done When line with verify, and mark it shipped. claim gives you a spec_id for write, verify and ship, and a holder_key for write and ship. Ship only records that it shipped; it doesn't deploy anything. If you need a person to decide something, use escalate. It doesn't move, merge or re-rank priorities; that's annsa.board. Actions:ship,claim,note,handoff,dispatch,unclaim,close,write,verify,escalate,resolveandundo.annsa.file: Add something new to the board. Use it to file what a customer said, a bug or finding you found, or an idea. It attaches to the matching priority if there is one; add stand_alone to make a new priority instead. The reply tells you which priority it landed on. It doesn't change rows that already exist; that's annsa.board. To tell the Annsa team about Annsa itself, use report. Actions:submit,report,add_page,add_template,connect_goal,add_transcript,import_directionandadd_priority.annsa.decide: Record what a person decided. A person uses it to answer a question an agent raised or sign off a priority. As an agent you can list principles, propose one, approve or dismiss a proposed spec change, or pass on a person's exact words with person_words. To ask a person something, use annsa.work escalate instead. Actions:approve,dismiss,answer,ask_back,direct,choose,signandprinciple.annsa.board: Tidy the board. Use it to change a priority's stage or severity, merge duplicates, move priorities between groups, fix a title, place priorities on a bet, or cut a release. A merge retires the duplicate numbers for good. Some actions, like park and assign, are for people only. It doesn't do the work on a priority; that's annsa.work. Actions:set_stage,assign,correct,park,unpark,retract,regroup,merge,bet,direction,set_severity,cut,pick,approve_findingsandview.annsa.share: Tell customers their request shipped. Use it after a priority ships to email or notify everyone who asked for it. Emails can't be unsent, so only a signed-in person can run it. The reply says who was told. It doesn't mark anything shipped; that's annsa.work ship. Actions:share.
annsa.help and annsa.surveys are retired and refused. Use annsa.ask about=annsa or annsa.ask about=surveys. annsa.act is still callable as the single tool behind the five. Old action names are refused too, and the reply names the new one: calling release answers that it is no longer an action and to send unclaim. An agent credential is refused these actions, whichever tool carries them: dispatch, add_transcript, import_direction, ask_back, direct, choose, sign, assign, park, retract, approve_findings and share.
A priority filed in the last few minutes can be missing from the next list read. annsa.priorities with priority_number=N returns it.