From 882d4cda895c31a8e18c8da304741d3216b08585 Mon Sep 17 00:00:00 2001 From: fruit <1746125922@qq.com> Date: Sat, 5 Sep 2026 02:03:40 +0800 Subject: [PATCH] docs(opencode): warn against manual source file copying (#833) Top-of-file note in integrations/opencode/README.md: copying source .md files into .opencode/agents/ fails OpenCode schema validation; run scripts/install.sh --tool opencode, which resolves named colors to hex and omits the tools field. Follow-up to #832 / #796. Co-Authored-By: Claude Fable 5.1 --- integrations/opencode/README.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/integrations/opencode/README.md b/integrations/opencode/README.md index eef275b2..bfd605a1 100644 --- a/integrations/opencode/README.md +++ b/integrations/opencode/README.md @@ -1,5 +1,22 @@ # OpenCode Integration +> **❌ Don't do this:** +> +> ```bash +> # WRONG — will fail with schema validation errors +> cp agency-agents/engineering/*.md .opencode/agents/ +> ``` +> +> **✅ Do this instead:** +> +> ```bash +> /path/to/agency-agents/scripts/install.sh --tool opencode +> ``` +> +> The source files use named colors and a `tools` field that OpenCode rejects. +> The installer converts them to `#RRGGBB` hex and strips incompatible fields +> automatically. + OpenCode agents are `.md` files with YAML frontmatter stored in `.opencode/agents/`. The converter maps named colors to hex codes and adds `mode: subagent` so agents are invoked on-demand via `@agent-name` rather