A collection of files designed to supercharge your Roo Code experience and maximize productivity.
These productivity-enhancing templates can be added to your projects to modify how Roo Code's LLM behaves, creating a more efficient and effective development workflow.
Solve the context window overload problem once and for all.
This project is progressing rapidly based on feedback from users, check back often for updates
The Handoff System provides a streamlined approach to manage LLM context across extended development sessions. This innovative system tackles a fundamental issue in extended LLM interactions - as sessions progress, LLMs accumulate context that becomes increasingly bloated with irrelevant information, consuming valuable tokens and degrading performance.
Key Benefits:
- Maintain peak LLM performance throughout long projects by starting fresh when needed
- Reduce token consumption and costs by eliminating redundant context
- Preserve focus on what matters most with clean, relevant context windows
- Break through stubborn debugging challenges with "fresh eyes" - sometimes a clean perspective solves problems that an overloaded context window cannot
- Document project progress automatically as a natural side-effect of the system
- More streamlined than memory banks while achieving similar benefits with less complexity
- Inspired by battle-tested knowledge handoff techniques refined during intelligence operations where 24/7 situational awareness is mission-critical
During extended debugging sessions, it may feel frustrating to start over with a fresh LLM, but it's often better than continuing down a deteriorating path. The "fresh eyes" of a new session with focused context can break through obstacles that an overloaded session might struggle with.
Getting Started with the Handoff System:
- For a comprehensive explanation of the system architecture and concepts, read the detailed guide
- Choose your implementation approach:
- For a basic implementation that works with any LLM, follow the basic guide
- For an advanced implementation with custom Roo-Code modes, follow the advanced guide
- For custom mode integration, refer to custom modes documentation
- Find all configuration files (
.clinerules,.roomodes) in the handoffs directory
Compatibility Note: Optimized for Claude 3.7 Sonnet with thinking enabled (minimum 2k reasoning, optimal at 8k)
A practical cheatsheet of one-liners and code snippets in Python, Bash, Node.js, and PowerShell for handling large files that would normally exceed LLM context windows. Extract exactly what you need without overwhelming your LLM. This file is designed to be given to the LLM as a reference and to remind it how to do some things.
Unlock the full potential of Roo Code's custom modes system with this detailed guide covering data structures, tool groups, file restrictions, and best practices with practical examples. This file is designed to be given to the LLM to create your own specific custom modes.
A comprehensive collection of documentation resources for Roo Code, organized by technical depth and audience:
- User-Friendly Guides: Practical guides for everyday Roo Code users covering features, customization, and best practices without technical complexity. Use these to udnerstand whats going on to decide if you need to feed a techincal doc into the llm for some purpose.
- Technical Documentation: In-depth technical documentation for developers and advanced users who want to understand implementation details. The original goal of these were to create technical documents that could be fed back into Roo for it to understand subssytems. It works pretty well.
Each resource includes detailed implementation instructions within its files. Simply clone this repository, copy the desired files into your project, and follow the specific setup instructions within each resource.
Recommended Learning Path:
- Start with the Handoff System architecture overview to understand the concepts
- Choose your implementation path:
- For basic usage, follow the basic implementation guide
- For advanced features, follow the advanced implementation guide
- Explore the custom modes documentation for advanced integration
- Reference the Large File Handling Cheatsheet for complementary techniques
- Review the Roo Code documentation for general usage guidance
RooCode-Tips-Tricks/
├── README.md # This file - project overview
├── handoffs/ # Handoff system core files
│ ├── .clinerules # Main handoff system rules
│ ├── .clinerules-handoff-manager # Specialized handoff manager rules
│ ├── .clinerules-milestone-manager # Specialized milestone manager rules
│ ├── .roomodes # Custom mode definitions
│ ├── handoff-system.md # Comprehensive system documentation
│ ├── handoff-system-basic.md # Basic implementation guide
│ ├── handoff-system-advanced.md # Advanced implementation guide
│ └── 0-instructions/ # Templates and instructions for handoffs
│ ├── 0-intro.md
│ ├── 1-handoff-instructions.md
│ ├── 2-milestone-instructions.md
│ └── ...
├── cheatsheets/ # Supplementary resources
│ ├── custom-modes-llm-instruction.md # Custom modes documentation
│ ├── llm-large-file-cheatsheet.md # Handling large files techniques
│ ├── roo-code-lightweight-integration.md # Integration proposal
│ └── roo-code-handoff-integration-theory.md # Full integration architecture
└── personal_roo_docs/ # Roo Code documentation collection
├── README.md # Documentation overview
├── normal/ # User-friendly guides
│ ├── experimental-features.md
│ ├── mcp-server-integration.md
│ ├── managing-context-window.md
│ └── ...
└── technical/ # Developer documentation
├── experimental-features.md
├── mcp-server-integration.md
├── managing-context-window.md
└── ...
We've organized additional resources in the cheatsheets directory:
- Custom Modes LLM Instructions: Create specialized modes
- Large File Handling: Handle files that exceed context windows
- Roo-Code Lightweight Integration: Integration proposal with minimal changes
- Roo-Code Comprehensive Integration: Theoretical full integration architecture
The personal_roo_docs directory contains two levels of documentation:
- User Guides: Perfect for new users and those wanting practical usage tips
- Technical Docs: Ideal for developers and those needing implementation details
Both documentation sets cover the same core topics but at different technical depths, making them suitable for different audiences.
This project is open source and available under the MIT License.
Happy Coding with Roo! 🐨