Bug: Agent namespace mismatch - workflows:plan fails to invoke compound-engineering agents

[Leeycw96]

Problem Description

When executing /workflows:plan, attempts to invoke repo-research-analyst and learnings-researcher agents fail with "Agent type 'not found'" error.

Environment

• Claude Code: 2.1.47
• Compound-Engineering MCP: 2.35.1
• Platform: macOS

Reproduction Steps

1. Execute /workflows:plan command
2. System automatically enters Phase 1: Local Research
3. Call Task repo-research-analyst(...) and Task learnings-researcher(...)
4. Returns error below

Error Message

Error: Agent type 'repo-research-analyst' not found. Available agents: Bash, general-purpose, statusline-setup, Explore, Plan, claude-code-guide,
compound-engineering:design:design-implementation_reviewer, compound-engineering:design:design_iterator, compound-engineering:design:figma-design-sync,
compound-engineering:docs:ankane-readme_writer, compound-engineering:research:best-practices-researcher, compound-engineering:research:framework-docs-researcher,
compound-engineering:research:git-history-analyzer, compound-engineering:research:learnings-researcher, compound-engineering:research:repo-research-analyst,
compound-engineering:review:agent-native-reviewer, compound-engineering:review:architecture-strategist, compound-engineering:review:code-simplicity-reviewer,
compound-engineering:review:data-integrity-guardian, compound-engineering:review:data-migration-expert, compound-engineering:review:deployment-verification-agent,
compound-engineering:review:dhh-rails-reviewer, compound-engineering:review:julik-frontend-races-reviewer, compound-engineering:review:kieran-python-reviewer,
compound-engineering:review:kieran-rails-reviewer, compound-engineering:review:kieran-typescript-reviewer,
compound-engineering:review:pattern-recognition-specialist,
compound-engineering:review:performance-oracle, compound-engineering:review:schema-drift-detector, compound-engineering:review:security-sentinel,
compound-engineering:workflow:bug-reproduction-validator, compound-engineering:workflow:every-style-editor, compound-engineering:workflow:lint,
compound-engineering:workflow:pr-comment-resolver, compound-engineering:workflow:spec-flow-analyzer

Root Cause Analysis

Problem Nature

The agent registry uses exact string matching, but short names were used in the calls.

Detailed Analysis

Call Method	Result
Task repo-research-analyst(...)	❌ Not Found
Task compound-engineering:research:repo-research-analyst(...)	✅ Success

Available agent list (registry):
compound-engineering:research:repo-research-analyst
compound-engineering:research:learnings-researcher
compound-engineering:research:best-practices-researcher
compound-engineering:research:framework-docs-researcher
compound-engineering:workflow:spec-flow-analyzer
...

System looks for repo-research-analyst, but only full names like compound-engineering:research:repo-research-analyst exist in the registry.

Impact

• /workflows:plan cannot execute Phase 1 Local Research properly
• /workflows:brainstorm may have the same issue
• All workflows relying on compound-engineering agents

Suggested Fix

Scope

Review all markdown documents in the repository that reference agents and ensure they use full namespace names (e.g.,
compound-engineering:research:repo-research-analyst) instead of short names (e.g., repo-research-analyst).

Affected Documents

Check for patterns like:

• Task repo-research-analyst
• Task learnings-researcher
• Task best-practices-researcher
• Task framework-docs-researcher
• Task git-history-analyzer
• Any other compound-engineering agent short names

Recommended Changes

Replace short names with full namespace names in all .md files:

Short Name	Full Name
repo-research-analyst	compound-engineering:research:repo-research-analyst
learnings-researcher	compound-engineering:research:learnings-researcher
best-practices-researcher	compound-engineering:research:best-practices-researcher
framework-docs-researcher	compound-engineering:research:framework-docs-researcher
git-history-analyzer	compound-engineering:research:git-history-analyzer

Labels

• bug
• agent
• workflow
• documentation

---