> For the complete documentation index, see [llms.txt](https://planetz.gitbook.io/planetz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://planetz.gitbook.io/planetz/reference/glossary.md).

# Glossary

> Status: Reference · Target version 0.1.x

Short definitions for the terms used across this documentation. Each links to a fuller explanation where one exists.

***

**Planetz / Planetz Agent Deck** — the desktop app for running and governing a fleet of AI agents.

**Deck** — the main screen: left rail of views, a center view, and dockable panels.

**Harness** — the execution engine that turns a free-running agent into a governed one by running it through a defined workflow. Shown in-app as **orbit**. → [The harness](/planetz/core-ideas/harness-governance.md)

**orbit** — the in-product display name for the harness, and for Planetz's per-workspace settings.

**Workspace** — the Git repository you open in Planetz. Planetz keeps its own state in a managed folder beside your project and doesn't write into your existing tool data at runtime. → [Git integration](/planetz/core-ideas/git-integration.md)

**Fleet** — the set of agents working in parallel, each in its own lane. → [Multi-agent fleet](/planetz/core-ideas/multi-agent.md)

**Agent roles** — specialized agents such as planner, coder, reviewer, and tester (maker–checker separation).

**Lane** — a task's isolated branch and workspace, so parallel agents don't collide.

**Task / Run** — a *task* is a unit of work you queue; a *run* is one execution of it.

**Workflow** — the process a run follows (steps, roles, approval points), defined as YAML so it's auditable, versioned, and shareable. → [Workflows](/planetz/the-product-screen-by-screen/workflows.md)

**Auto routing** — the harness classifying a task and selecting the right workflow automatically, with the reasoning recorded.

**Facet** — a reusable building block (persona, policy, knowledge, instruction) that workflows draw on.

**Intent Ledger** — the durable record of what was decided, its provenance, and whether it still matches what you wanted; the source of truth that code answers to. → [The Intent Ledger](/planetz/core-ideas/intent-ledger.md)

**Decided intent** — what you want, why, and what's out of scope, captured in [Spec Studio](/planetz/the-product-screen-by-screen/spec-studio.md).

**Decision** — a choice an agent made during a run, recorded with its provenance and links to your intent.

**Provenance** — where a decision came from: your requirement, a design choice, an agent's assumption, or something observed after the fact.

**Anchored / Unanchored** — a decision is *anchored* when it traces to your requirements or design; *unanchored* when it traces to nothing — the signature of drift.

**Drift** — when implementation moves away from what you decided, usually through many small, unreconciled decisions.

**Approve / Reject (ratify / reverse)** — your verdict on a decision; once given, it's locked so a later run can't silently overwrite it.

**Reversibility** — how hard an action is to undo; drives where a deliberate confirmation is worth it.

**Edge model** — a model running locally on your machine (via **Ollama**) so your code never leaves for a public API. → [Edge AI & data sovereignty](/planetz/core-ideas/edge-ai.md)

**Manta** — the optional desktop robot: status LCD, ambient light, physical Approve / Deny, and push-to-talk.

**Planetz Cloud** — a managed private node with the same deck and workflows, for more power and team features. → [What's next](/planetz/where-planetz-is-going/whats-next.md)

**MCP** — Model Context Protocol; how external tools and servers connect to Planetz.

**Adapter / external agent** — connection that lets an outside agent (e.g. Cursor) join the deck. *(Experimental.)*

**takt** — the open-source engine whose core ideas Planetz's harness (orbit) adopts and builds on. Planetz is an independent project. → [How Planetz is different](/planetz/why-planetz/how-planetz-is-different.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://planetz.gitbook.io/planetz/reference/glossary.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.