Context Circuit
Reference

Workspace files

Shared configuration and machine-local state, file by file.

Template 2.5.0

Shared files

PathPurpose
workspace.yamlIdentity, repositories, relationships, optional borrowed knowledge and registry.
members.yamlRoster of at least one member, each with an allocation band, optional language and tone, and optional informational roles.
.context-circuit/VERSIONTemplate version received.
.context-circuit/CLI_VERSIONExpected CLI executable version.
.context-circuit/cli, .context-circuit/cli.ps1The launcher, which runs exactly the pinned CLI from the installers' version store; cli.ps1 is for Windows PowerShell or cmd.
.context-circuit/.gitattributesKeeps cli at LF and cli.ps1 at CRLF line endings on every checkout.
.context-circuit/role-tiering.yamlShared host/role model and effort preferences.
.context-circuit/ids/<member>.yamlOne member's intent and plan reservations; only requested record deletion releases IDs. A schema 2 workspace has one shared .context-circuit/ids.yaml until the split.
intent/, plans/Outcomes, implementation plans, and decision notes, with optional group folders and _archive/.
.ignoreKeeps /sources/ out of ripgrep-based search.
.claude/settings.jsonAllows both launcher commands in Claude Code; a workspace merges new entries into its own file entry by entry.
context/Durable knowledge, optional index, and glossary.

Local and ignored

PathPurpose
member.local.yamlActive member on this machine, written by init and by member use on every other machine.
repositories.local.yamlWorkspace and repository paths, base branches, borrowed checkout paths.
.context-circuit/role-tiering.local.yamlMachine-specific model and effort overrides.
.context-circuit/local/worktrees.yamlOptional plan-to-worktree associations.
.context-circuit/local/write.lockOS-managed local write lock.
repositories/, .worktrees/Local Git working copies.
Native host agent directoriesGenerated role definitions; run agent setup on a new host.
.claude/settings.local.jsonThis machine's Claude Code settings; agent setup adds the attribution setting that turns commit and pull request attribution off.

Unknown control fields fail validation. Knowledge remains ordinary Markdown. Do not store secrets in workspace records; environment files belong to ignored local setup.

On this page