Glossary #

View this page as Markdown

This page defines each word the manual uses, with a link to the page that gives its rules. Read it when a word on another page is new to you.

Issue space #

The place your AI keeps its issues, shared by every session and agent that works it. The word for one is a space. A space outlasts any one conversation, and several sessions work it at once. Your account makes its space with create_issue_space; nothing makes one automatically.

Issue #

One point that must outlast a conversation: what was seen and a suggested resolution. An issue has no sub-items and no checklist, and closing it is the check-off. Issues and kinds gives what an issue holds.

Kind #

What sort of point an issue is: bug, gap, docs, friction, question, task, praise, or idea. Issues and kinds says what each one means, and Accepted words for kinds the other words each kind reads, such as problem for a bug.

State #

Where an issue stands: new, open, waiting, fixed, or closed. An issue is waiting exactly when it waits for more evidence. Issues and kinds describes each state.

Outcome #

What a close records about how an issue ended: verified, done, as_designed, declined, duplicate, superseded, noted, or unexplained. A close records a resolution with it: what was done, or why no change is needed.

Waiting for #

Who or what an open issue waits on, its waiting_for. It is none when the issue is ready to work, person when it waits for your person to act or decide, or person:<account> for one member of a shared space. It is reporter for one of its reporters, outside:<what> for an outside party or event, or evidence, the one value that puts the issue in the state waiting. wait and update set it, and find lists issues by it. Waiting and claims gives each value.

Claim #

A label saying who works on an issue, its claimed_by: session:<id> for one session, agent:<name> for an agent, a name of your own, or branch:<name> for the work on one branch. claim sets it and is refused while another claim is in place, and give_back clears it with a reason. Other sessions read the claim before they start, and leave a claimed issue alone.

Member #

A person the space's owner added with share, by the email address of their Turn Zero account, at a level: report, contribute, or owner. Sharing a space gives the levels and how a member connects.

Level #

What a member's sessions may do in a shared space: report, contribute, or owner, lowest first. Each level admits every act of the levels below it, so a session at contribute or above works issues as well as raising them. The owner gives each member a level with share, and Sharing a space gives what each one admits.

Cache #

A copy of your space's issues kept as files on your computer, one folder per project per computer, shared by every session working there. Your AI searches it with its own file tools first, and reads an issue live before it changes it. Only a tool that runs commands, such as Claude Code or Codex, keeps one. The cache gives where it is kept and what it holds.

Setting file #

The file .tztrack/config.json at a project's top level, giving the space the project uses. Every session in the project, on every computer, reads the same space from it, in a tool that reads local files, such as Claude Code or Codex. The setting file gives its form.

Report #

One filing of an issue's point by a reporter. An issue can have several reports, so a point raised again joins the issue it already has.

Priority #

How urgently an issue needs work: 1 urgent, 2 soon, 3 when convenient. Your AI reads the urgent issues first at the start of its work.