{"id":49538411,"url":"https://github.com/jcarlosrodicio/opencode-agent-orchestration-kit","last_synced_at":"2026-05-06T17:00:55.713Z","repository":{"id":355113458,"uuid":"1225420959","full_name":"jcarlosrodicio/opencode-agent-orchestration-kit","owner":"jcarlosrodicio","description":"Starter kit for OpenCode agent orchestration with product-development workflows, Open Design integration, Superpowers, Docker, and docs.","archived":false,"fork":false,"pushed_at":"2026-05-04T16:08:25.000Z","size":1439,"stargazers_count":27,"open_issues_count":1,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-05T16:40:40.186Z","etag":null,"topics":["agent-orchestration","ai-agents","developer-tools","docker","open-design","opencode","product-development","superpowers"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jcarlosrodicio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE.md","maintainers":null,"copyright":null,"agents":"docs/agents.md","dco":null,"cla":null}},"created_at":"2026-04-30T09:01:47.000Z","updated_at":"2026-05-04T19:33:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jcarlosrodicio/opencode-agent-orchestration-kit","commit_stats":null,"previous_names":["jcarlosrodicio/opencode-agent-orchestration-kit"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/jcarlosrodicio/opencode-agent-orchestration-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarlosrodicio%2Fopencode-agent-orchestration-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarlosrodicio%2Fopencode-agent-orchestration-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarlosrodicio%2Fopencode-agent-orchestration-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarlosrodicio%2Fopencode-agent-orchestration-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jcarlosrodicio","download_url":"https://codeload.github.com/jcarlosrodicio/opencode-agent-orchestration-kit/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarlosrodicio%2Fopencode-agent-orchestration-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32703532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-orchestration","ai-agents","developer-tools","docker","open-design","opencode","product-development","superpowers"],"created_at":"2026-05-02T13:04:30.665Z","updated_at":"2026-05-06T17:00:55.658Z","avatar_url":"https://github.com/jcarlosrodicio.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# opencode-agent-orchestration-kit\n\nA starter kit for configuring OpenCode with a product-development agent orchestration flow, Open Design integration, optional Impeccable design context, Superpowers workflow discipline, and optional AHE observability sidecars.\n\nThis project is for developers who want a reproducible global OpenCode setup without hand-writing agents, commands, skills, tools, and Docker notes from scratch.\n\nThis repository is not affiliated with OpenCode, Open Design, Impeccable, or Superpowers.\n\n## Architecture\n\nBy default, free-form messages open with `lead` as a bounded router. Lead quickly chooses `developer`, `researcher`, `designer`, or `specifier`, and asks the user when ambiguity changes the correct flow. Small, clear, low-risk changes are usually delegated straight to `developer`.\n\nCore feature flow:\n\n```text\nlead -\u003e designer if applicable -\u003e researcher -\u003e specifier -\u003e developer -\u003e reviewer\n```\n\nScoped research/spec flow:\n\n```text\nscoper -\u003e researcher -\u003e scoper synthesis -\u003e specifier\n```\n\nPlan-only flow:\n\n```text\nlead -\u003e researcher -\u003e specifier -\u003e reviewer\n```\n\nDesign flow:\n\n```text\ndesigner -\u003e open-design\n```\n\nOptional harness-evolution flow:\n\n```text\nevaluator -\u003e debugger -\u003e evolver -\u003e lead approval -\u003e developer -\u003e evaluator -\u003e debugger -\u003e reviewer\n```\n\nHarness contracts are versioned inside the shipped OpenCode config:\n\n- `opencode/AGENTS.md`: short index for agents.\n- `opencode/docs/ai/harness/`: agent, command, evidence, and check contracts.\n- `opencode/docs/ai/evolution/`: AHE benchmark and evolution records.\n- `opencode/scripts/check-harness.mjs`: local mechanical validation for the harness.\n\n## Skills and integrations\n\nIncluded locally:\n\n- `open-design`: shipped in this repo at `opencode/skills/open-design`. It wraps Open Design workbench usage through `OPEN_DESIGN_URL` and the `open_design_*` tools.\n\nReferenced from upstream:\n\n- `superpowers`: not vendored in this repo. It is enabled through the upstream OpenCode plugin `superpowers@git+https://github.com/obra/superpowers.git`, so OpenCode downloads/loads it from upstream when plugins are supported and network access is available.\n\nOptional, user-installed:\n\n- `impeccable`: not included in this repo. Install it from upstream if you want `designer` to use it when `PRODUCT.md` or `DESIGN.md` are missing.\n\n## Quick install\n\n```bash\ngit clone https://github.com/jcarlosrodicio/opencode-agent-orchestration-kit.git\ncd opencode-agent-orchestration-kit\n./install.sh\n```\n\nThen configure your environment:\n\n```bash\ncp env.example .env\nsource .env\nopencode auth login\nopencode\n```\n\n## Use without installing globally\n\n```bash\nexport OPENCODE_CONFIG_DIR=\"$PWD/opencode\"\nexport OPEN_DESIGN_URL=\"https://open-design.example.com\"\nopencode\n```\n\nThis is the safest way to test the kit before touching your global config.\n\n## Global install\n\n```bash\n./install.sh\n```\n\nThe installer copies agents, commands, skills, and tools to `${OPENCODE_CONFIG_DIR:-$HOME/.config/opencode}`. It creates a backup when existing files are present. It does not overwrite `opencode.json` or `AGENTS.md` unless you pass `--force`.\n\n```bash\n./install.sh --target \"$HOME/.config/opencode\"\n./install.sh --force\n```\n\nIf your existing `opencode.json` was preserved, add Superpowers manually. This references the upstream plugin; it does not copy Superpowers into this repository:\n\n```json\n{\n  \"plugin\": [\"superpowers@git+https://github.com/obra/superpowers.git\"]\n}\n```\n\nFor reproducibility you may pin a version:\n\n```json\n{\n  \"plugin\": [\"superpowers@git+https://github.com/obra/superpowers.git#v5.0.5\"]\n}\n```\n\n## Models\n\nThe example config reads models from environment variables:\n\n```bash\nexport OPENCODE_MODEL=\"openai/gpt-5.5\"\nexport OPENCODE_SMALL_MODEL=\"$OPENCODE_MODEL\"\nexport OPENCODE_LEAD_MODEL=\"$OPENCODE_MODEL\"\nexport OPENCODE_DEVELOPER_MODEL=\"$OPENCODE_MODEL\"\n```\n\nSee `env.example` for all role-specific variables.\n\n## Open Design configuration\n\nSet `OPEN_DESIGN_URL` to the base URL of your Open Design workbench.\n\nValid:\n\n```bash\nexport OPEN_DESIGN_URL=\"https://open-design.example.com\"\nexport OPEN_DESIGN_URL=\"http://192.168.1.50:7456\"\n```\n\nInvalid:\n\n```bash\nexport OPEN_DESIGN_URL=\"https://open-design.example.com/projects/my-project\"\nexport OPEN_DESIGN_URL=\"https://open-design.example.com/projects/my-project/files/index.html\"\n```\n\nDo not expose Open Design directly to the Internet without authentication, VPN, Tailscale, WireGuard, or a secure reverse proxy.\n\n## Command examples\n\n```text\n/feature Create onboarding with plan selection and welcome screen\n/plan Add a dry-run flag to the harness check without implementing it yet\n/scope Research Stripe Checkout integration and generate an MVP spec\n/mvp-spec Email notifications when an agent finishes a task\n/design Read PRODUCT.md and DESIGN.md, create an editable Open Design project, and generate a first version\n/review\n```\n\nWithout a slash command, simple implementation requests go directly through `developer`. Use `/plan` when you want research, spec, and reviewer feedback without implementation; use `/feature` when you want the full orchestration flow.\n\n## Validate the kit\n\n```bash\nnpm run check\n```\n\nThis runs the repository checks plus the harness validator in `opencode/scripts/check-harness.mjs`.\n\n## Docker Open Design\n\n```bash\ncd docker/open-design\ncp .env.example .env\ndocker compose up -d --build\n```\n\nAuthenticate OpenCode inside the container if you want Open Design to use OpenCode as the design engine:\n\n```bash\ndocker exec -it open-design bash\nopencode auth login\nopencode models openai --refresh\nexit\n```\n\nThen set:\n\n```bash\nexport OPEN_DESIGN_URL=\"http://192.168.1.50:7456\"\n```\n\n## Security\n\n- Do not commit `.env`, auth files, sessions, logs, or provider credentials.\n- Do not commit private `PRODUCT.md` or `DESIGN.md` files unless intended.\n- Open Design can run local agent CLIs and write files inside project workspaces.\n- Prefer localhost, LAN, VPN, Tailscale, WireGuard, or authenticated HTTPS reverse proxy.\n\n## Troubleshooting\n\n- `OPEN_DESIGN_URL is not set`: export the base URL, not a project URL.\n- `/api/health` fails: check Open Design is running and reachable from your OpenCode process.\n- OpenCode does not appear in Open Design agents: run `opencode auth login` and ensure `opencode` is on `PATH`.\n- `crypto.randomUUID` fails on HTTP LAN: use HTTPS or the optional upstream frontend patch described in docs.\n- Superpowers skills do not load: restart OpenCode and verify the plugin line in `opencode.json`.\n- Designer cannot see Open Design: verify `OPEN_DESIGN_URL`, tool registration, and `opencode/tools/open_design.ts`.\n\n## License\n\nApache License 2.0. See `LICENSE` and `NOTICE.md`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcarlosrodicio%2Fopencode-agent-orchestration-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjcarlosrodicio%2Fopencode-agent-orchestration-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcarlosrodicio%2Fopencode-agent-orchestration-kit/lists"}