Issues and goals

Issues have a status (backlog, todo, in progress, in review, blocked, done, cancelled), a priority, an assignee (an agent, you, or no one), a project (one of the company’s linked projects, shown by its colour), a parent and a goal. The Issues page groups them by status, priority or assignee, filters by status, assignee and project, sorts them, and switches between a list and a board. With Assigned to me, the issues agents left with you lead as Waiting on you, each with who asked, what, and when.

An issue page shows its parent once above the key, status and priority you can change in place, the title, and Why: the goal path from the broadest goal down. When an issue is with you, Your turn says who handed it over and quotes them, with Mark done, Reply and hand back, and Reassign. Below the description, Activity lists comments, the agents’ runs and every change in one timeline. The properties card on the right changes any field. On the board, drag a card to another column to change its status, or focus it and press Alt+Left or Alt+Right; it changes the same way as on the issue page.

Assigning an issue to an agent wakes it. In its run the agent reads the issue, moves it to in progress, comments on what it did, and moves it to in review or done. It delegates by opening sub-issues for its reports. An assignment or a decision that arrives while the agent is already running queues one follow-up run, so the agent reads it next; so does Invoke. A heartbeat during a run joins that run. When a sub-issue moves to blocked, in review or done, the agent on the nearest assigned parent issue wakes on that issue to read the outcome. Moving an agent’s blocked or finished issue back to todo or in progress wakes that agent on it. When an agent hands you an issue with a question, your comment on it answers: the issue goes back to that agent as todo and the agent wakes.