Frequently Asked Questions
Q: Will the setup overwrite my existing files?
A: No, the installer is designed to be safe. It detects existing files and will prompt you to choose whether to skip, overwrite, always overwrite, or never overwrite for each conflict. For maximum safety, it's always a good practice to run the installer on a new Git branch.
Q: Can I use this with other AI coding tools like Cursor, Cline, or the Gemini CLI?
A: Partially. The 3-tier documentation structure is a powerful concept that can benefit any AI tool (you would just need to rename CLAUDE.md to match your tool's convention). However, the Commands and Hooks are highly optimized for Claude Code's multi-agent capabilities and specific lifecycle events. Using the orchestration and automation features with other tools would require significant adaptation.
Q: How much will this cost in tokens?
A: This framework is powerful but token-intensive due to its reliance on comprehensive context loading and multi-agent workflows. It is strongly recommended to use it with a flat-rate subscription like Claude Pro rather than a pay-per-token API model. The Claude 3 Opus model currently performs best for complex instruction following.
Q: Can I use other coding consultant MCPs instead of the recommended Gemini Assistant?
A: While technically possible, the command templates and context-injection hooks are specifically configured and optimized for the Gemini Assistant MCP server linked during installation. Using an alternative consultant MCP would require you to adjust the command templates (/gemini-consult), hooks (gemini-context-injector.sh), and potentially the MCP-ASSISTANT-RULES.md structure to match the specific interface and capabilities of the other service.
Q: Can I use this framework with an existing project?
A: Yes, absolutely! The framework is ideal for bringing structure to existing projects. When installing, the setup script will detect existing files like CLAUDE.md and let you choose whether to keep them.
To get started, the best approach is to have Claude Code generate the initial project-structure.md file for you. You can use a prompt like this:
"Read and understand the project_structure.md template in docs/ai-context/project_structure.md. Your task is to fill out this template with our project's details. For this, send out sub-agents in parallel across the whole codebase. Once the sub-agents get back, ultrathink and create the markdown file."
Once you have the project structure documented, you can use the /create-docs command to systematically generate the Tier 2 and Tier 3 CONTEXT.md files for your main components.