For projects that already use context-forge, a dedicated initialization command should be used:claude-agents init --respect-context-forge. The command intelligently handles three aspects of compatibility: 1) storing agent commands in a proprietary directory (.claude/commands/agents/) to avoid naming conflicts; 2) securely updating the CLAUDE.md file without destroying existing configurations; and 3) automatically adapting to the structure of the PRP (Project Relationship Planning) file. This design ensures that the two tools work together, retaining the project planning capabilities of context-forge while overlaying the specialized agent capabilities of Sub-agents.
This answer comes from the articleSub-agents: Tools for adding and managing AI sub-agents for Claude CodeThe
