A comprehensive system for managing AI interactions through memory management, lessons learned tracking, and dual-mode operation (Plan/Agent). This system ensures consistent, high-quality development while maintaining detailed project documentation and knowledge retention.
-
Memory System (
@memories.md)- Tracks all interactions chronologically
- Auto-updates with timestamps and tags
- Maintains project context and decisions
- Uses version control format [v1.0.0]
- Supports #tags for easy searching
-
Lessons Learned (
@lessons-learned.md)- Captures solutions and best practices
- Uses structured format: Issue → Solution → Impact
- Categorizes by component, TypeScript, errors, etc.
- Prioritizes issues (Critical/Important/Enhancement)
- Links to related code examples
-
Scratchpad (
@scratchpad.md)- Manages current phase and tasks
- Tracks implementation progress
- Uses clear status markers [X], [-], [ ], [!], [?]
- Maintains task dependencies
- Updates confidence metrics
Trigger: "plan"
Purpose: Information gathering and planning
Requirements:
- Parse user input
- Cross-reference requirements
- Generate clarifying questions
- Calculate confidence score
- Create task breakdownTrigger: "agent"
Activation Requirements:
- 95% confidence level
- All questions answered
- Tasks defined
- No blocking issues
- Requirements verified-
Initialize Planning 🎯
- Use "plan" trigger - System creates new scratchpad entry - Generates minimum 3 questions - Sets initial confidence score
-
Build Confidence 📈
- Answer all questions - Verify requirements - Update task dependencies - Monitor confidence score
-
Execute Implementation ⚡
- Reach 95% confidence - Use "agent" trigger - System implements solution - Updates documentation
USER: "plan implement a new button component"
AI: 🎯 PLAN MODE ACTIVATED
Current Task: Implement new button component
Questions:
1. What variants are needed? (primary/secondary/outline)
2. Should it support icons?
3. What sizes are required?
Confidence: 65%
USER: "primary and secondary variants, with icons, three sizes"
AI: Updated Understanding:
- Primary/Secondary variants
- Icon support
- Small/Medium/Large sizes
Confidence: 95%
USER: "agent"
AI: ⚡ AGENT MODE ACTIVATED
- Creating Button component
- Implementing variants
- Adding icon support
- Testing accessibilityUSER: "plan fix the form submission error"
AI: 🎯 PLAN MODE ACTIVATED
Current Task: Debug form submission error
Questions:
1. When does the error occur?
2. Any error messages in console?
3. Which form component is affected?
Confidence: 50%
USER: "happens on login form, console shows validation error"
AI: Chain of Thought Analysis:
1. Login form validation
2. Console error check
3. Input validation rules
Confidence: 95%
USER: "agent"
AI: ⚡ AGENT MODE ACTIVATED
- Debugging validation
- Fixing error handling
- Testing submissionUSER: "plan setup new Next.js project"
AI: 🎯 PLAN MODE ACTIVATED
Current Task: Initialize Next.js project
Questions:
1. Which version of Next.js?
2. TypeScript or JavaScript?
3. Which UI components needed?
Confidence: 70%
USER: "Next.js 14, TypeScript, Shadcn UI"
AI: Project Structure:
- Next.js 14 setup
- TypeScript configuration
- Shadcn UI integration
Confidence: 95%
USER: "agent"
AI: ⚡ AGENT MODE ACTIVATED
- Creating project
- Setting up TypeScript
- Installing dependenciesUSER: "plan update API documentation"
AI: 🎯 PLAN MODE ACTIVATED
Current Task: Update API docs
Questions:
1. Which endpoints need updates?
2. Any new parameters added?
3. Response format changes?
Confidence: 60%
USER: "new authentication endpoints"
AI: Documentation Plan:
- Auth endpoints
- Request/Response formats
- Example usage
Confidence: 95%
USER: "agent"
AI: ⚡ AGENT MODE ACTIVATED
- Updating docs
- Adding examples
- Verifying formats- Memories: Every interaction
- Lessons: After solutions
- Scratchpad: During implementation
[v1.0.0] Format for all entries
- Development updates
- Manual updates
- Progress tracking@memories.md ↔️ @lessons-learned.md ↔️ @scratchpad.md.cursor/
├── memories.md # Interaction history
├── lessons-learned.md # Solutions & practices
├── scratchpad.md # Current phase tracking
├── project-requirements.md # Project specs
└── rules/ # System rules
└── .cursorrules # Core rules file
-
Memory Management
- Use timestamps consistently
- Include relevant #tags
- Cross-reference related entries
- Keep single-line format
-
Task Tracking
- Generate unique task IDs
- Track dependencies
- Update status in real-time
- Maintain hierarchy
-
Documentation
- Update in real-time
- Include version numbers
- Cross-reference related files
- Follow structured formats
-
Required Open Tabs:
1️⃣ Active working file 2️⃣ Cursor Settings (Feature → Resync) 3️⃣ .cursorrules (for auto-reload) -
Quick Reload Process:
1. Ctrl+Shift+P 2. "Developer: Reload Window" 3. Wait 3-10 seconds
- Keep .cursorrules file open
- Monitor confidence scores
- Use proper triggers
- Follow version format
- Cross-reference frequently
Feel free to enhance this system:
- Add custom rules
- Improve tracking
- Enhance metrics
- Share practices
MIT License - Free to use and modify!
- Instagram: https://www.instagram.com/clover_nat/
- Facebook: https://www.facebook.com/nathanielmarquez.20
- Twitter: https://x.com/T1nker1220
If this system helps you, consider supporting:
- PayPal: https://www.paypal.me/JohnNathanielMarquez
- GCash: 09605088715
For full context and discussions: https://forum.cursor.com/t/rules-for-ultra-context-memories-lessons-scratchpad-with-plan-and-act-modes/48792/22?u=t1nker-1220
Note: This system is designed for seamless AI interaction management. For detailed implementation guidelines, refer to the individual rule files. 🚀