opencode-ceo

Build a disciplined, delivery-aware OpenCode workflow with a CEO agent, specialist delegation, persistent state, and GitHub handoff.

🚀 What This Project Does

opencode-ceo is an OpenCode plugin that turns software work into a controlled delivery pipeline. Instead of letting one agent improvise the whole task, it moves work through defined stages, persists decisions and artifacts, and can prepare Git branches and pull requests when the repository is ready.

🌍 Language Options

• English README
• Turkce README

⚡ Status At A Glance

• CI on main: enabled and protected
• Release workflow: configured in .github/workflows/release.yml
• Dependabot: configured in .github/dependabot.yml
• npm package publication: not published yet
• GitHub release: not created yet

If you are evaluating release readiness, start with the Release Guide.

✨ Why opencode-ceo?

• Deterministic pipeline ownership instead of one-shot agent output
• SQLite-backed artifacts, gates, and state for long-running sessions
• GitHub-aware delivery helpers for branch and PR preparation
• Configurable autonomy for teams that want review gates before delivery

🧭 Documentation Hub

Start here if you want the full docs map:

• Documentation Hub

Table of Contents

• What This Project Does
• Status At A Glance
• Documentation Hub
• Installation Status
• Configuration Example
• Pipeline Overview
• GitHub Delivery
• Local Verification
• Repository Controls

Core guides:

• Usage Guide
• Pull Request Guide
• Model Recommendations
• Release Guide
• Governance and Branch Policy
• Architecture

Repository policies:

• Contributing
• Security
• Support
• Code of Conduct
• Changelog
• License

📦 Installation Status

The package name is opencode-ceo, but the first public npm release has not been published yet.

Current options:

• local development from this repository
• future npm install after the first release

Planned install command after publication:

npm install opencode-ceo

⚙️ Configuration Example

{
  "plugins": [
    {
      "name": "opencode-ceo",
      "config": {
        "autonomyLevel": "gated",
        "gates": {
          "approve-plan": "manual",
          "approve-review": "auto",
          "approve-delivery": "manual"
        }
      }
    }
  ]
}

Minimal full-autonomy setup:

{
  "plugins": [
    {
      "name": "opencode-ceo",
      "config": {
        "autonomyLevel": "full"
      }
    }
  ]
}

🏗️ Pipeline Overview

[intake] -> [decompose] -> [implement] -> [review] -> [test] -> [deliver] -> [completed]
                 \-> [blocked]                                 \-> [failed]

Stage summary:

• intake: capture the task and detect the project stack
• decompose: build an implementation plan
• implement: produce the change set
• review: inspect correctness and risk
• test: validate behavior and regression safety
• deliver: prepare branch and PR output

For deeper detail, see Architecture.

🧠 Model Preferences

You can tune modelPreferences by stage. Suggested defaults and trade-offs live here:

• Model Recommendations

🔀 GitHub Delivery

opencode-ceo includes GitHub-aware delivery tools:

• ceo_branch_prepare creates ceo/<pipeline-id>/<slug> branches
• ceo_pr_prepare pushes the active branch to origin and opens a PR with gh pr create
• ceo_repo_fingerprint reports remote, git status, and general repo readiness

Before using PR automation locally:

gh auth login

🧪 Local Verification

bun install
bun run ci:verify

Useful individual commands:

• bun run build
• bun run typecheck
• bun test
• bun run pack:check

🛡️ Repository Controls

• protected main branch
• required quality, tests, and package checks
• linear history enforced
• force-push disabled on main
• conversations must be resolved before merge
• Dependabot active for npm and GitHub Actions
• CI currently listens to both main and master for compatibility, while main is the active branch policy target

Details: Governance and Branch Policy

📚 Next Steps

• operational setup: Usage Guide
• contribution flow: Pull Request Guide
• release flow: Release Guide
• repo policy: Governance and Branch Policy

📄 License

MIT