-
Notifications
You must be signed in to change notification settings - Fork 49
Description
Description
The documentation labels Claude and Codex engines as "experimental" which creates an unnecessary perception of instability, despite evidence that Claude is production-ready (29 Claude workflows exist in this repository).
Affected File
docs/src/content/docs/reference/engines.md (line 12)
Current State
The documentation currently states:
"Claude and Codex engines are available but marked as experimental. They are not documented here but can still be used by setting
engine: claudeorengine: codexin your workflow frontmatter. For production workflows, we recommend using the GitHub Copilot CLI engine."
Problems
- Misleading: 29 production Claude workflows in this repo demonstrate stability
- Inconsistent: Says "not documented here" but documentation exists below in same file
- Discouraging: Creates hesitation for Claude users without evidence of instability
Suggested Change
Replace the "experimental" banner with a neutral note:
> [!NOTE]
> Multiple AI Engines Supported
> GitHub Agentic Workflows supports multiple AI engines: GitHub Copilot CLI (default), Anthropic Claude, and OpenAI Codex. All engines support the same tools, triggers, and safe outputs. Choose the engine that best fits your needs and API access.Impact
Severity: High (perception issue) - Affects adoption confidence
Audience: Claude Code users, non-Copilot developers
Benefit: Improves Claude adoption by removing false "experimental" stigma
Success Criteria
- "Experimental" banner removed from
engines.md - Neutral "Multiple AI Engines Supported" note added
- No language suggesting Copilot is only production-ready engine
- Documentation builds successfully
Source
Extracted from Claude Code User Documentation Review discussion #12027
Finding: Obstacle 1 - "Experimental" Label Creates Perception Claude is Unstable
Assessment Score: 8.5/10 (points deducted for this issue)
Context
This is part of a broader effort to improve multi-engine documentation parity. Claude users currently feel like second-class citizens despite having full feature parity (except Copilot-specific bot features).
AI generated by Discussion Task Miner - Code Quality Improvement Agent
- expires on Feb 10, 2026, 9:06 PM UTC