From da6122d12a4398f61fc058d8ba6c856fe56e7684 Mon Sep 17 00:00:00 2001 From: GitHub Copilot Date: Fri, 20 Mar 2026 03:36:52 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20fix=20compile=20target=20docs=20?= =?UTF-8?q?=E2=80=94=20add=20opencode,=20replace=20copilot=20with=20vscode?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Replace all copilot target references with vscode in the compilation guide - Add --target opencode example to the quick-start block - Add .opencode/ row to the auto-detection table - Add opencode row to the output files table - Clarify aliases note Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/src/content/docs/guides/compilation.md | 23 ++++++++++++--------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/docs/src/content/docs/guides/compilation.md b/docs/src/content/docs/guides/compilation.md index ec0b9e55..8f95c2b3 100644 --- a/docs/src/content/docs/guides/compilation.md +++ b/docs/src/content/docs/guides/compilation.md @@ -20,34 +20,37 @@ When you run `apm compile` without specifying a target, APM automatically detect | Project Structure | Target | What Gets Generated | |-------------------|--------|---------------------| -| `.github/` folder only | `copilot` | AGENTS.md (instructions only) | -| `.claude/` folder only | `claude` | CLAUDE.md (instructions only) | -| Both folders exist | `all` | Both AGENTS.md and CLAUDE.md | -| Neither folder exists | `minimal` | AGENTS.md only (universal format) | +| `.github/` folder only | `vscode` | AGENTS.md + .github/ | +| `.claude/` folder only | `claude` | CLAUDE.md + .claude/ | +| `.opencode/` folder only | `opencode` | AGENTS.md + .opencode/ | +| Multiple target folders | `all` | All outputs | +| No target folders | `minimal` | AGENTS.md only (universal format) | ```bash apm compile # Auto-detects target from project structure -apm compile --target copilot # Force GitHub Copilot, Cursor, Codex, Gemini +apm compile --target vscode # Force GitHub Copilot, Cursor, Codex, Gemini apm compile --target claude # Force Claude Code, Claude Desktop +apm compile --target opencode # Force OpenCode ``` You can set a persistent target in `apm.yml`: ```yaml name: my-project version: 1.0.0 -target: copilot # or vscode, claude, or all +target: vscode # or claude, opencode, or all ``` ### Output Files | Target | Files Generated | Consumers | |--------|-----------------|-----------| -| `copilot` | `AGENTS.md` | GitHub Copilot, Cursor, OpenCode, Codex, Gemini | -| `claude` | `CLAUDE.md` | Claude Code, Claude Desktop | -| `all` | Both `AGENTS.md` and `CLAUDE.md` | Universal compatibility | +| `vscode` | `AGENTS.md` + `.github/` | GitHub Copilot, Cursor, Codex, Gemini | +| `claude` | `CLAUDE.md` + `.claude/` | Claude Code, Claude Desktop | +| `opencode` | `AGENTS.md` + `.opencode/` | OpenCode | +| `all` | `AGENTS.md` + `CLAUDE.md` + all folders | Universal compatibility | | `minimal` | `AGENTS.md` only | Works everywhere, no folder integration | -> **Aliases**: `vscode` and `agents` are accepted as aliases for `copilot`. +> **Aliases**: `agents` is accepted as an alias for `vscode`. `copilot` is also accepted in `apm.yml` but is not a valid `--target` flag value. > **Note**: `AGENTS.md` and `CLAUDE.md` contain **only instructions** (grouped by `applyTo` patterns). Prompts, agents, commands, hooks, and skills are integrated by `apm install`, not `apm compile`. See the [Integrations Guide](../../integrations/ide-tool-integration/) for details on how `apm install` populates `.github/prompts/`, `.github/agents/`, `.github/skills/`, `.claude/commands/`, `.cursor/rules/`, `.cursor/agents/`, `.opencode/agents/`, and `.opencode/commands/`.