Context Circuit

Prompt cookbook

What to say for the supported Context Circuit cases, in ordinary project language.

Template 2.5.0CLI 2.5.0

You do not need Context Circuit commands, record IDs, branch names, or internal vocabulary. Tell the coordinator the project outcome or decision in ordinary language. It chooses the matching procedure and runs the pinned CLI through the workspace's launcher for exact bookkeeping.

This cookbook covers the supported v2 conversation surface. The wording is illustrative: replace names, paths, repositories, branches, providers, and outcomes with your own.

Diagram viewer
100%

Drag to move around. Use the controls to zoom.

Learn what you opened

Explain this workspace

Prompt

What is this project, which repositories belong to it, and what does the workspace already know?

The agent reads workspace identity, relationships, local bindings, and relevant knowledge. It explains the project without changing anything.

Show current work

Prompt

What changes are currently planned or in progress, and which repositories do they affect?

The agent resolves records and checks real branches and diffs before describing implementation state. status shows your own work first: intents awaiting approval, approved intents without plans, open plans, and finished records not yet archived.

Check workspace consistency

Prompt

Check this Context Circuit workspace and explain every finding. Do not repair anything that needs my decision.

check is diagnostic. A finding names the command, edit, or human decision that discharges it.

Create or join a workspace

Create a new project workspace

Prompt

Create a Context Circuit workspace for “Acme Billing.” Its purpose is subscription billing for small businesses. Add me as Maya.

Initialization happens only on request. Add your preferred language and writing tone if intents and plans should use them.

Every workspace has at least one member, and every member holds an allocation band, even when you work alone. The agent suggests band 1 for you; say so if you want another, or add roles such as maintainer or docs, which say what you contribute and authorize nothing.

Join an existing workspace on another machine

Prompt

This is an existing team workspace. Set this machine up for member maya, connect the workspace checkout, and obtain the repositories already recorded here.

The agent selects the existing member and binds this machine. It does not initialize the shared workspace again.

Add a member

Prompt

Add Alex to this workspace with band 2 and the role docs. Write Alex's intents and plans in Indonesian with a semi-formal tone and keep technical terms in English.

Every member gets a band; without one, the agent offers the next free band. Roles are optional, and the question may be skipped.

Select a member before changing the workspace

Prompt

I am Maya, who is already listed in this workspace. Select me on this machine, then continue the change I requested.

If you are new, say so and ask the agent to add and select you. A workspace can still answer questions before selection, but it waits for a listed member, with a band, before making changes. If a member has no band, the agent offers the band status suggests for you to confirm or change. The selection attributes work; it does not verify identity.

Change an allocation band

Prompt

Move Alex to band 3 so Alex's new records start at i300 and p3000.

Every member holds a distinct band, and each member's reservations live in their own ID file, so members can create records from offline clones without choosing the same IDs. Changing a band never renumbers existing records. Bands reduce one collision class; they are not distributed locking. Workspace commits still need synchronization before separate clones allocate.

Connect repositories

Connect an existing checkout

Prompt

Connect ../billing-api as api. It owns billing rules and starts work from main.

Clone a repository already described by the workspace

Prompt

Clone the web repository recorded in this workspace and use release/24.4 as this machine's base branch.

The shared default branch and this machine's base branch are different facts.

Register a new remote repository

Prompt

Add the existing checkout at ../notifications as notifications, record its origin, and describe it as the service that sends billing emails.

Initialize an empty repository

Prompt

Create a new local repository called reporting, connect it to the workspace, and use main as its initial branch.

Record a relationship

Prompt

Record that web consumes the api billing endpoints and that api publishes invoice events to notifications.

Describe the workspace repository

Prompt

Connect this workspace's own Git repository so team members know where the shared records travel.

The workspace repository is not a work repository and is not named by plans.

Diagram viewer
100%

Drag to move around. Use the controls to zoom.

Install and update Context Circuit

Install the pinned CLI

Prompt

Install the Context Circuit CLI version this workspace pins and verify the installed binary.

The agent runs every later command through the workspace's launcher, which runs exactly that pinned version.

Update only the CLI

Prompt

Update the CLI used by this workspace to version 2.5.0. Do not change the workspace template or existing records.

An update stays on the workspace's own release line.

Update the workspace template

Prompt

Update this workspace from its recorded template version to 2.5.0. Show me the upstream delta and preserve our project-owned files and records.

The agent applies the version-to-version delta. It does not recopy a release over the workspace, and it reads, rather than applies, a delta that deletes the shared ID file or changes the schema version, because the CLI migrates those. When the upgrade migrates the workspace — the schema 3 ID split, or the 2.5.0 rename of archive/ to _archive/ — the agent tells you first: one person on a team makes that change, commits and pushes it, and everyone else installs the new CLI and pulls before changing anything.

Configure agent roles

Prompt

Show the explorer, planner, worker, and reviewer settings in force for Cursor on this machine.

Prompt

Configure the Cursor planner to use <supported-model> with high effort, then refresh the native role definitions without overwriting customized definitions.

Settings express host preferences. A generated definition does not prove the host loaded it.

Build project knowledge

Gather from named evidence

Prompt

Read sources/billing-rules.md and sources/customer-interviews.md. Turn the durable product rules into project knowledge, update the catalog and glossary, and keep raw evidence separate.

Only the exact named sources are read. The resulting notes describe the project, not those source files.

Gather from repositories

Prompt

Document how invoices move from draft to paid by reading the relevant api and web code. Add durable knowledge with repository anchors.

Query knowledge

Prompt

What does this project already know about invoice cancellation, credit notes, and overdue reminders?

The agent retrieves the smallest relevant set through the catalog instead of scanning every note.

Add actor knowledge

Prompt

Document what a freelance seller and an accounts-payable reviewer each need from the invoice approval flow today.

Actor notes describe current needs, not a future backlog.

Clarify vocabulary

Prompt

We use “void” and “cancel” differently. Record the project meaning and the code identifiers each repository uses.

Mount organization knowledge

Prompt

Mount our platform-knowledge repository as read-only shared knowledge, using index.md as its catalog.

Retrieve borrowed knowledge

Prompt

Find what our project and the mounted platform knowledge say about idempotency.

Matches identify which side owns each note. Borrowed knowledge is never copied into this workspace.

Reconcile stale knowledge

Prompt

Check which owned knowledge may be stale against the code. Walk me through the findings and update only notes you actually re-read.

Design before deciding an outcome

Use a system design when a large change needs its shape settled before it can be expressed as bounded outcomes.

Prompt

Design the end-to-end subscription billing system: actors, domain boundaries, repository responsibilities, data flow, failure behavior, and rollout constraints. Write it as source material; do not create intents or start implementation.

Diagram viewer
100%

Drag to move around. Use the controls to zoom.

A design has no status and grants no approval. It is evidence an intent may cite when the outcome genuinely rests on it.

Request a normal product change

Start an intent

Prompt

Add recurring billing to the API and web app. Existing customers must remain on their current plans.

The agent retrieves relevant knowledge, writes the outcome it understood, asks numbered questions, and stops before detailed code investigation.

Answer open questions

Prompt
  1. Monthly and annual plans only.
  2. Existing subscriptions keep their price until manually changed.
  3. Failed renewals retry for seven days.

Approve the written outcome

Prompt

The intent matches what I want. I approve it.

Approval records your exact words and stops: the agent recommends planning as the next step. No code is read and no plan ID is reserved.

Ask for plans

Prompt

Create the plans for this intent.

The agent then reads real code and writes linked plans without asking for approval again.

Approve and plan in one message

Prompt

The intent matches what I want. I approve it. Create the plans.

Once you have read the intent, approval and the planning request may come together. Asking for an intent to be written and planned in one go is not approval, because nobody has read it yet.

Answer the commit question

Prompt

Commit and push.

Prompt

Commit only.

After approval, completion, or archiving, the agent asks whether to commit and push the records and ID files it left uncommitted, or commit only. Your answer authorizes those files, that once. After "commit only", the agent says other clones cannot see them yet. If the push is refused because the remote moved on, the agent rebases the record commits, keeps what Git combines, brings any record conflict to you, and never force-pushes.

Request a standalone plan

Prompt

The outcome is already specified. Investigate the current code and write a detailed plan for adding an invoice CSV export. Present the plan before implementation.

The agent can create a grounded plan folder without an intent. It still waits for a separate execution request.

Correct the outcome before approval

Prompt

Do not include annual plans in this change. Update the intent and show it again.

Change an approved outcome

Prompt

The success criteria must now include prorated upgrades. Update the intent and ask me to approve the changed outcome.

A material outcome change returns to the intent. An implementation detail inside the approved outcome does not.

Diagram viewer
100%

Drag to move around. Use the controls to zoom.

Make a direct change

Explicitly bypass records and worktrees

Prompt

/cc-direct Fix the incorrect support email in the website checkout. Work on its current branch and leave the change uncommitted.

Direct code change with an exact outcome

Prompt

Make this validation message say “Workspace name is required.” Change it directly in the bound web checkout, run the relevant test, and do not commit.

If the request turns out to need a product decision, the agent stops and offers the intent path.

Explore without changing code

Ask a bounded codebase question

Prompt

Find where invoice numbers are allocated, which database constraint makes them unique, and which tests cover collisions. Return evidence only.

Compare repositories

Prompt

Trace how the web app submits an invoice and how api validates it. Identify mismatched assumptions without proposing a new outcome.

Investigate feasibility before changing the intent

Prompt

Before I decide whether offline invoice creation belongs in the outcome, investigate the current synchronization model and tell me what is feasible.

Exploration is read-only. It cannot approve, plan, or implement a change by itself.

Execute planned work

Run one plan

Prompt

Execute p0007. Prepare its worktrees, implement the approved outcome, run the repository checks, and report what remains unverified.

Run all plans for an intent

Prompt

Execute all plans for the recurring-billing intent. Derive their dependency order and recommend waves or a linear chain with the cost of each.

Choose the execution shape

Prompt

Use waves for this run.

Prompt

Use a linear chain for this run.

Resume interrupted work

Prompt

Resume p0007. Inspect the actual branches and diffs before trusting the plan record, preserve partial work, and continue from what Git shows.

Handle a blocked run

Prompt

Explain which plans finished, which one is blocked, and which dependents are waiting. Preserve every branch and do not invent a repair for anything that needs my decision.

Diagram viewer
100%

Drag to move around. Use the controls to zoom.

An execution request covers worktree preparation, implementation commits on the plan branches, and local integration merges required by that run. It does not authorize delivery.

Use subagents

Delegate exploration

Prompt

Use explorers to investigate the API retry policy and the web cancellation flow in parallel. Return evidence; do not edit either repository.

Delegate implementation

Prompt

Dispatch one worker per ready plan, wait for every result, and integrate their reported checks. Stop if a worker is blocked.

Use several workers in one worktree

Prompt

Split this plan into bounded worker tasks inside the same worktree. Make every worker preserve the others' edits.

One worker per plan owns a whole worktree. Several workers inside one worktree share files; the briefs must say which form is being used.

Review

Ordinary review

Prompt

Review the current branch diff for correctness, regressions, security risks, and missing tests. Do not change code.

Independent review

Prompt

Independently review the changes for p0007 against the intent's success criteria. Use a fresh read-only reviewer and report any limit on independence.

Review a pull request

Prompt

Independently review pull request <url> and give me findings with locations. Do not post comments or launch fixes.

Independent review is optional, manually requested, and never an automatic delivery gate.

Deliver work

Each outward action must be requested explicitly.

Commit direct work

Prompt

Commit the direct website changes using the repository's commit convention. Do not push.

Worktree implementation commits are covered by execution; commits in a bound checkout are not.

Push a branch

Prompt

Push the branch for p0007. Do not open a pull request.

Open pull requests

Prompt

Open pull requests for the recurring-billing work against each machine's recorded base branch. Use only the chain-end branch for each repository.

Update a pull request

Prompt

Update the API pull request description to reflect the revised retry behavior.

Merge

Prompt

Merge pull requests <api-url> and <web-url> into their current targets.

Deploy or publish

Prompt

Deploy the merged website revision to <environment> and report what was actually observed.

Delivery does not mark plans complete.

Diagram viewer
100%

Drag to move around. Use the controls to zoom.

Complete the circuit

Complete one plan

Prompt

The change from p0007 has landed. Mark the plan complete with these exact words: “Recurring billing shipped in the API.”

Complete several plans

Prompt

The recurring-billing pull requests have landed. Mark all of its plans complete and reconcile the durable knowledge once across the set.

State that knowledge did not change

Prompt

Complete p0008. This was a presentation-only correction; confirm whether any durable knowledge changed and record the result honestly.

Completion is the note plus knowledge reconciliation. Most completions change no durable concept.

Organize and clean up

Delete records after reviewing a preview

Prompt

Preview every intent and plan created by member maya, including archived records. Show me the exact list and IDs that would become reusable. Do not confirm deletion yet.

When the roster lists only you, you can ask to preview all records instead. After seeing the list, explicitly agree to that list before deletion. The CLI refuses when a record outside the selection or a local worktree would be left referring to deleted work, and the agent shows that refusal with the records blocking it. Deletion must later be committed and synchronized across clones.

Delete specific records

Prompt

Preview deleting intent i104 and its plan p1007 — I changed my mind about that change. Show me who wrote them, whether they are approved or completed, and any leftover branches. Do not confirm yet.

Deletion by ID reaches exactly the records you name, whoever wrote them, or a reserved number no record holds. A deleted plan is taken out of its intent's list; any other link refuses and names the IDs to add.

Archive records

Prompt

Yes, archive my finished records.

Prompt

Archive the completed recurring-billing intent and plans. Preserve every ID reservation and repair relative links.

After completion the agent offers to archive your finished records under _archive/; a no changes nothing. Archival is optional organization, not a lifecycle stage, keeps every ID reserved, and asks the commit question afterwards.

Remove a worktree

Prompt

Remove the worktree for p0007 if it is safe. Preserve dirty, untracked, and ignored files, and keep the branch.

Discard a worktree explicitly

Prompt

Remove the p0007 worktree and discard its dirty, untracked, and ignored files. Keep the branch.

Delete a branch

Prompt

Delete the local cc/p0007/api branch after confirming its work is preserved elsewhere.

Worktree removal and branch deletion are separate requests.

Recover and repair local mechanics

Inspect worktrees

Prompt

List the real Git worktrees and explain any stale Context Circuit association.

Move a worktree

Prompt

Move the worktree for p0007 to <new-path> using Git and update the local association.

Repair an association

Prompt

Repair the local worktree association for p0007 from Git's inventory. Do not reset or recreate its branch.

Prune stale associations

Prompt

I removed the api worktree for p0007 by hand. Drop the stale association.

worktree prune drops associations of worktrees Git no longer lists and touches no worktree, branch, or file. Repair is for a checkout Git still lists that only moved.

Change this machine's base

Prompt

Change the api checkout's base branch on this machine to release/24.4. Do not change the shared repository default.

Ask for honest limits

These prompts are useful when evidence is incomplete:

Prompt

Report only checks you actually ran and observations you actually made. Call everything else unverified.

Prompt

Preserve partial work and tell me the smallest decision or external action needed to continue.

Prompt

Do not call the implementing session's own inspection independent.

Prompt

Do not print environment contents, credentials, provider payloads, or machine-specific paths into shared records.

Requests that should not be combined

Keep these decisions explicit even if they happen in one conversation:

Do not conflateWhy
Initial request and intent approvalThe approved object is the written outcome
Intent approval and planningApproval records the decision; planning follows a request, which may come with it
Planning and executionExecution waits for a request after the plans exist
Execution and independent reviewReview is optional and read-only
Execution and deliveryPush, PR, merge, and deploy are outward actions
Delivery and completionLanding code does not reconcile knowledge
Completion and worktree removalA completed branch may still be useful
Worktree removal and branch deletionThey preserve different artifacts
Diagram viewer
100%

Drag to move around. Use the controls to zoom.

On this page

Learn what you openedExplain this workspaceShow current workCheck workspace consistencyCreate or join a workspaceCreate a new project workspaceJoin an existing workspace on another machineAdd a memberSelect a member before changing the workspaceChange an allocation bandConnect repositoriesConnect an existing checkoutClone a repository already described by the workspaceRegister a new remote repositoryInitialize an empty repositoryRecord a relationshipDescribe the workspace repositoryInstall and update Context CircuitInstall the pinned CLIUpdate only the CLIUpdate the workspace templateConfigure agent rolesBuild project knowledgeGather from named evidenceGather from repositoriesQuery knowledgeAdd actor knowledgeClarify vocabularyMount organization knowledgeRetrieve borrowed knowledgeReconcile stale knowledgeDesign before deciding an outcomeRequest a normal product changeStart an intentAnswer open questionsApprove the written outcomeAsk for plansApprove and plan in one messageAnswer the commit questionRequest a standalone planCorrect the outcome before approvalChange an approved outcomeMake a direct changeExplicitly bypass records and worktreesDirect code change with an exact outcomeExplore without changing codeAsk a bounded codebase questionCompare repositoriesInvestigate feasibility before changing the intentExecute planned workRun one planRun all plans for an intentChoose the execution shapeResume interrupted workHandle a blocked runUse subagentsDelegate explorationDelegate implementationUse several workers in one worktreeReviewOrdinary reviewIndependent reviewReview a pull requestDeliver workCommit direct workPush a branchOpen pull requestsUpdate a pull requestMergeDeploy or publishComplete the circuitComplete one planComplete several plansState that knowledge did not changeOrganize and clean upDelete records after reviewing a previewDelete specific recordsArchive recordsRemove a worktreeDiscard a worktree explicitlyDelete a branchRecover and repair local mechanicsInspect worktreesMove a worktreeRepair an associationPrune stale associationsChange this machine's baseAsk for honest limitsRequests that should not be combined