What happened
On PR #241 (conforma/user-guide), the code agent ran as workflow 29010964798 in conforma/.fullsend. The parent session invoked Agent with subagent_type 'code', producing subagent a3f0319d63f6805d3 with allowedTools: []. This subagent could not use Bash, which is required for gh, git, scan-secrets, and all CLI steps. It burned 164 transcript lines and 80+ tool calls attempting workarounds: reading /proc/self/environ, WebFetching GitHub URLs (which need auth), WebSearching for the issue, editing settings.json, reading session metadata. After exhausting options (~5 minutes), it gave up. The parent then spawned subagent add2d17dfc4af7d2c with subagent_type 'claude', which had Bash and completed the fix efficiently in 61 transcript lines and ~30 tool calls. A third subagent (acdd0c12ef9c594d9, 12 lines) verified the results. Total code agent cost: $5.70 for a single-file documentation fix.
What could go better
The first subagent should have had Bash access from the start. The ~$2.50 and ~5 minutes spent on the failed subagent were pure waste. The recovery path (falling back to subagent_type 'claude') worked but should not have been necessary. High confidence this is a recurring pattern: any code agent run that spawns with subagent_type 'code' will hit the same issue since this type does not actually configure tool access.
Proposed change
Issue #2098 already identifies the root cause: subagent_type is not a real Claude Code concept. The 'code' type does not compose agent definitions or grant tool access. The fix in #2098 should ensure the code agent's subagent dispatch either uses the correct agent definition with tools: ['Bash'] in frontmatter, or uses the default ('claude') type which inherits the parent's tool access. This evidence from a newly onboarded repo (conforma/user-guide) confirms the issue persists as of 2026-07-09.
Validation criteria
After #2098 is merged, verify on a subsequent code agent run that the first subagent has Bash access and does not produce 'Bash exists but is not enabled' errors. The code agent cost for a comparable one-file documentation fix should be under $3.00 with zero recovery cycles.
Generated by retro agent from conforma/user-guide#241
What happened
On PR #241 (conforma/user-guide), the code agent ran as workflow 29010964798 in conforma/.fullsend. The parent session invoked Agent with subagent_type 'code', producing subagent a3f0319d63f6805d3 with allowedTools: []. This subagent could not use Bash, which is required for gh, git, scan-secrets, and all CLI steps. It burned 164 transcript lines and 80+ tool calls attempting workarounds: reading /proc/self/environ, WebFetching GitHub URLs (which need auth), WebSearching for the issue, editing settings.json, reading session metadata. After exhausting options (~5 minutes), it gave up. The parent then spawned subagent add2d17dfc4af7d2c with subagent_type 'claude', which had Bash and completed the fix efficiently in 61 transcript lines and ~30 tool calls. A third subagent (acdd0c12ef9c594d9, 12 lines) verified the results. Total code agent cost: $5.70 for a single-file documentation fix.
What could go better
The first subagent should have had Bash access from the start. The ~$2.50 and ~5 minutes spent on the failed subagent were pure waste. The recovery path (falling back to subagent_type 'claude') worked but should not have been necessary. High confidence this is a recurring pattern: any code agent run that spawns with subagent_type 'code' will hit the same issue since this type does not actually configure tool access.
Proposed change
Issue #2098 already identifies the root cause: subagent_type is not a real Claude Code concept. The 'code' type does not compose agent definitions or grant tool access. The fix in #2098 should ensure the code agent's subagent dispatch either uses the correct agent definition with tools: ['Bash'] in frontmatter, or uses the default ('claude') type which inherits the parent's tool access. This evidence from a newly onboarded repo (conforma/user-guide) confirms the issue persists as of 2026-07-09.
Validation criteria
After #2098 is merged, verify on a subsequent code agent run that the first subagent has Bash access and does not produce 'Bash exists but is not enabled' errors. The code agent cost for a comparable one-file documentation fix should be under $3.00 with zero recovery cycles.
Generated by retro agent from conforma/user-guide#241