Workspace files
Shared configuration and machine-local state, file by file.
Shared files
| Path | Purpose |
|---|---|
workspace.yaml | Identity, repositories, relationships, optional borrowed knowledge and registry. |
members.yaml | Roster, allocation bands, language, and tone. |
.context-circuit/VERSION | Template version received. |
.context-circuit/CLI_VERSION | Expected CLI executable version. |
.context-circuit/role-tiering.yaml | Shared host/role model and effort preferences. |
.context-circuit/ids.yaml | Permanent intent and plan reservations. |
intent/, plans/ | Outcomes, implementation plans, and decision notes. |
context/ | Durable knowledge, optional index, and glossary. |
Local and ignored
| Path | Purpose |
|---|---|
member.local.yaml | Active member on this machine. |
repositories.local.yaml | Workspace and repository paths, base branches, borrowed checkout paths. |
.context-circuit/role-tiering.local.yaml | Machine-specific model and effort overrides. |
.context-circuit/local/worktrees.yaml | Optional plan-to-worktree associations. |
.context-circuit/local/write.lock | OS-managed local write lock. |
repositories/, .worktrees/ | Local Git working copies. |
| Native host agent directories | Generated role definitions; run agent setup on a new host. |
Unknown control fields fail validation. Knowledge remains ordinary Markdown. Do not store secrets in workspace records; environment files belong to ignored local setup.