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 <noreply@anthropic.com>
This commit is contained in:
fruit
2026-09-04 13:03:40 -05:00
committed by GitHub
co-authored by Claude Fable 5.1
parent 5457373419
commit 882d4cda89
+17
View File
@@ -1,5 +1,22 @@
# OpenCode Integration # 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 are `.md` files with YAML frontmatter stored in
`.opencode/agents/`. The converter maps named colors to hex codes and adds `.opencode/agents/`. The converter maps named colors to hex codes and adds
`mode: subagent` so agents are invoked on-demand via `@agent-name` rather `mode: subagent` so agents are invoked on-demand via `@agent-name` rather