OpenCode plugin for Context-Driven Development workflow
npm install opencode-conductor

OpenCode Conductor is a reusable plugin for the OpenCode ecosystem. It ports the powerful "Context-Driven Development" (CDD) workflow originally popularized by the Gemini CLI Conductor, enabling AI agents to build complex features with high precision by grounding them in your project's specific product mission, technical stack, and development standards.
AI agents often fail on large tasks because they lose context or make assumptions that contradict your project's architecture. Conductor solves this by:
1. Grounding: Every implementation is preceded by a read of your core context files (product.md, tech-stack.md, workflow.md).
2. Tracking: Complex features are broken down into "Tracks," each with its own specification and step-by-step implementation plan.
3. State Management: It maintains a clear record of what has been built, what is pending, and how the feature was specified.
---
Add the plugin to your global opencode.jsonc configuration (usually found in ~/.config/opencode/opencode.jsonc):
``json`
{
"plugin": [
"opencode-conductor@latest"
]
}
OpenCode will automatically download and load the plugin the next time you start a session.
If you want to modify the plugin or use it locally without publishing:
`bash
git clone https://github.com/NocturnLabs/opencode-conductor.git
cd opencode-conductor
---
š ļø Getting Started
$3
In any project directory, run:
`text
/conductor-setup
`
This creates a conductor/ directory at your project root with template files.$3
Open the generated files and fill them out. The better the context, the better the AI's implementation:
- conductor/product.md: What is this project? Who is it for? What is the core mission?
- conductor/tech-stack.md: Which frameworks are we using? (e.g., Next.js, Tailwind, Prisma). Any specific versions?
- conductor/workflow.md: How do we code? (e.g., "Use functional components," "All tests in tests/," "Use TSDoc").$3
When you're ready to build a feature, create a track:
`text
/conductor-new id:"auth-system" title:"JWT Authentication System"
`
This creates conductor/tracks/auth-system/ with spec.md and plan.md.$3
Run the "do" command to let the agent start working:
`text
/conductor-do id:"auth-system"
`
The agent will:
1. Read all your core context files.
2. Read the track's specification and plan.
3. Execute the next uncompleted task in the plan.
4. Mark the task as completed when finished.---
š Command Reference
| Command | Description | Arguments |
| :--- | :--- | :--- |
|
/conductor-setup | Scaffolds the conductor/ directory and context files. | None |
| /conductor-new | Creates a new development track with spec/plan templates. | id (string), title (string) |
| /conductor-do | Reads context and implements pending tasks for a track. | id (string) |
| /conductor-status | Provides a high-level summary of all tracks and context health. | None |---
š Directory Structure
`text
conductor/
āāā product.md # High-level product mission
āāā tech-stack.md # Frameworks, languages, and tools
āāā workflow.md # Coding standards and processes
āāā tracks.md # Index of all tracks (managed by plugin)
āāā tracks/ # Feature-specific directories
āāā track-id/
āāā spec.md # Detailed technical specification
āāā plan.md # Checkbox-list of implementation tasks
āāā metadata.json # Status, title, and timestamps
`---
š¤ Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
$3
To publish a new version (org members only):
1. Update version in package.json.
2. Commit and push:
`bash
npm version patch # or minor/major
git push --tags
``This project is licensed under the MIT License - see the LICENSE file for details.