From 4ee797ee09905697c093375af04140f185490036 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 19 May 2026 00:11:56 +0000 Subject: [PATCH] docs: correct engine.bare support matrix for codex and gemini MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The engine feature comparison table in engines.md incorrectly showed engine.bare as supported (✅) for Codex and Gemini. The compiler only honors bare mode for Copilot and Claude — it emits a warning and ignores the flag for all other engines (see pkg/workflow/agent_validation.go:229 and TestSupportsBareMode in pkg/workflow/engine_config_test.go). Closes the documentation drift noted in #33081. Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/src/content/docs/reference/engines.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/src/content/docs/reference/engines.md b/docs/src/content/docs/reference/engines.md index c81155d54f3..dc23809ad3f 100644 --- a/docs/src/content/docs/reference/engines.md +++ b/docs/src/content/docs/reference/engines.md @@ -40,7 +40,7 @@ Not all features are available across all engines. The table below summarizes pe | `tools.web-search` | via MCP | via MCP | ✅ (opt-in) | via MCP | via MCP | via MCP | via MCP | | `engine.agent` (custom agent file) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | | `engine.api-target` (custom endpoint) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| `engine.bare` (disable context loading) | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | +| `engine.bare` (disable context loading) | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | | `engine.harness` (custom harness script) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | | Tools allowlist | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | @@ -330,8 +330,9 @@ The underlying mechanism is engine-specific: |--------|--------| | Copilot | Passes `--no-custom-instructions` — suppresses `.github/AGENTS.md` and user-level custom instructions | | Claude | Passes `--bare` — suppresses CLAUDE.md memory files | -| Codex | Passes `--no-system-prompt` — suppresses the default system prompt | -| Gemini | Sets `GEMINI_SYSTEM_MD=/dev/null` — overrides the built-in system prompt with an empty file | + +> [!NOTE] +> `engine.bare` is only honored for the `copilot` and `claude` engines. Setting `bare: true` on `codex`, `gemini`, `crush`, `opencode`, or `pi` emits a compiler warning and has no effect. Defaults to `false`.