zai-org/synapse/opencode-controller

Opencode Controller

Core rule

Clawdbot does not write code. All planning and coding happens inside Opencode.

Pre-flight

• Ask the user which AI provider to use.
• Ask how the provider should be authenticated.
• Do not proceed without confirmation.

Session management

• Start Opencode.
• Open session selector using:

/sessions

• If the current project already exists:
• Select the existing session.
• Never create a new session without user approval.

Agent (mode) control

• Open agent selector using:

/agents

• Available agents:
• Plan
• Build
• Always select Plan first.
• Switch agents whenever required using /agents.

Model selection

• Open model selector using:

/models

• Select the user-requested provider.
• If authentication is required:
• Copy the login link provided by Opencode.
• Send it to the user.
• Wait for confirmation before continuing.

Plan agent behavior

• Ask Opencode to analyze the task.
• Request a clear step-by-step plan.
• Allow Opencode to ask clarification questions.
• Review the plan carefully.
• If the plan is incorrect or incomplete:
• Ask Opencode to revise it.
• Do not allow code generation in Plan.

Build agent behavior

• Switch to Build using /agents.
• Ask Opencode to implement the approved plan.
• If Opencode asks any question:
• Immediately switch back to Plan.
• Answer and confirm the plan.
• Switch back to Build.

Completion

• Repeat the Plan → Build loop until all user requirements are satisfied.
• Never skip Plan.
• Never answer questions in Build.

Output format

• Show all slash commands explicitly.
• State which option is selected.
• Provide login links verbatim.