Reference
alterac.ai terminology
Look up the shared names for organizations, projects, tasks, work runs, Task Builder sessions, identifiers, states, Mass, coding agents, and listeners.
Use these names as they appear in the application and CLI. The terms explain product behavior; they do not grant access to resources you cannot open.
| Term | Meaning |
|---|---|
| Organization | A shared account space that owns projects and memberships. |
| Project | A workspace inside one organization. Tasks, Task Builder Sessions, and task numbers belong to one project. |
| Task | One unit of project work with its own content, state, labels, dependencies, Mass, comments, and execution history. |
| Task number | The human-facing sequential number for a task within its project. Use it with the project context. |
| Work run | One exact execution of a queued task by a coding agent. It captures immutable task context, a summary, hand-off, and review history. |
| Work-run ID | The stable identifier for one exact work run. It is not a task number and must not be reused for a newer execution. |
| Mass | The optional task sizing field. It describes relative work size; it is not a state, priority, or completion percentage. |
Tasks move through the normal task workflow. A task may show a direct blocker or an approval wait that must be resolved before it can proceed.
| State | Meaning |
|---|---|
| Backlog | Planned work that is not queued. |
| Queued | Work selected for a coding agent and waiting to start. |
| Agent working | A coding agent has an active work run. |
| Reviewing | Work is ready for human review. |
| Done | The task's reviewed work is complete. |
| Term | Meaning |
|---|---|
| Task Builder | The workflow for drafting structured Plans and tasks with a local AI conversation before you publish them. |
| Task Builder Session | One project-owned drafting workspace. It owns its draft work and can be selected locally for CLI mutations. |
| Session number | The human-facing number for a Task Builder Session within its project. |
| Proposed Plan | A session-owned draft Plan with optional Markdown, labels, and zero or more member tasks. |
| Proposed Plan ID | The stable identifier for one proposed Plan. Its session-local display position is not its mutation identity. |
| Draft ID | The stable identifier for one draft task. Its display position can change when drafts are reordered or removed. |
| Standalone draft task | A draft task without proposed Plan membership. It still publishes as part of the complete session. |
| Building | The session state before publication. Draft content can be changed through the planning conversation and CLI. |
| Published | The session state after its complete reviewed draft set was published. It is an immutable history. |
| Publish | The explicit application action that atomically creates the session's complete reviewed Plans and tasks. |
| Term | Meaning |
|---|---|
| Coding agent | A configured command that can receive a queued task and perform its work in a local terminal. Its availability depends on its project configuration and policy. |
| Listener | The local alterac-ai listen process that checks its initialized project for queued work and launches the selected coding agent after any required local approval. |
| Waiting for input | A listener status that means a local command-approval prompt needs a response. The task remains queued until that decision. |
Use Fix task and review workflows for state, work-run, and review problems; Fix Task Builder workflows for draft and publication problems; and Fix the local listener for coding-agent launch problems.