Repository navigation
[docs] docs: unbloat troubleshooting/common-issues.md - #72280
Conversation
github-actions
Bot
added
automation
doc-unbloat
documentation
|
✅ Test Quality Sentinel completed test quality analysis. Test Quality SentinelOutcome: The agent completed and reported no action. A no-op output alone does not verify that all required work was completed or that publication was possible. Agent messages are omitted from this comment. The category uses structured run status, not interpretation of agent prose.
|
There was a problem hiding this comment.
🟢 Approval recommended
The configuration examples remain intact, and the remaining wording suggestions are non-blocking.
1 open issue
What changed in this PR
This documentation-only PR makes gh-aw’s common-issues troubleshooting guide more concise while retaining existing code samples, tables, links, and warnings.
Changes:
- Condenses OpenCode MCP and safe-output guidance.
- Shortens watchdog, failure-diagnosis, and debug-logging explanations.
| File | Description |
|---|---|
docs/src/content/docs/troubleshooting/common-issues.md |
Tightens troubleshooting prose without changing configuration examples or runtime behavior. |
Review effort: Max
| ### OpenCode MCP Tools Not Being Called | ||
|
|
||
| OpenCode-compatible engines do not auto-discover MCP servers, so use an explicit `opencode.jsonc` config. Keep the local AWF API proxy at `http://host.docker.internal:10004` when using `--enable-api-proxy`; `MCP_GATEWAY_PORT` and `MCP_GATEWAY_AGENT_ID` are expanded from workflow env at runtime, so substitute concrete values outside a workflow: | ||
| OpenCode-compatible engines do not auto-discover MCP servers, so declare them in an explicit `opencode.jsonc`. `MCP_GATEWAY_PORT` and `MCP_GATEWAY_AGENT_ID` are expanded from workflow env at runtime; substitute concrete values outside a workflow: |
|
🎉 This pull request is included in a new release. Release: |
Summary
Condensed verbose prose in
docs/src/content/docs/troubleshooting/common-issues.md(OpenCode MCP section, debug logging, watchdog note, safe-outputs note, failure causes). All code samples, tables, links and warnings preserved.The edit is small (about 7 lines added, 9 removed, roughly 150 words trimmed). The file was already fairly dense, so it falls short of the 20% reduction target.