🧠 Mini-CoderBrain

Data-Driven Behavioral Intelligence with Customizable AI Modes

Mini-CoderBrain is a revolutionary universal AI context awareness system that gives Claude perfect memory and understanding of your project. Features customizable behavior profiles, modular patterns library, and automatic effectiveness tracking.

Latest Features: Behavior Profiles (4 AI modes), Patterns Library (4,700 lines), Smart Metrics (automatic tracking), Comprehensive Test Suite. All while maintaining 79.8% token efficiency!

✨ Key Features

🎭 Behavior Profiles ✨ NEW

4 Core Profiles - default, focus, research, implementation
Customizable AI Modes - Match behavior to your task
Token Flexible - focus (150), default (200), research (300)
Custom Profiles - Create your own with markdown templates
Profiles Guide - Complete documentation

📚 Patterns Library ✨ NEW

4,700 Lines - Comprehensive behavioral training
5 Core Patterns - Pre-response protocol, context usage, proactive behavior, anti-patterns, tool selection
Zero Token Cost - Read on-demand, never injected
Modular System - Update patterns independently
Patterns Guide - Complete reference

📊 Smart Metrics ✨ NEW

Automatic Tracking - Tool usage, session data, profile performance
/metrics Command - Session, weekly, profile comparison views
Privacy-First - No code content, only metadata
Optimization - Data-driven workflow improvements
Metrics Guide - Usage guide

🎯 Intelligent Setup & Validation

Smart initialization wizard - Adapts to empty/existing/complex projects
Context quality scoring - Measurable 40-100% quality scores
Validation on session-start - Automatic quality checks
/validate-context - Check quality anytime

⚡ Perfect Context Awareness (Core)

Auto-loads project context once per session
Zero duplication - 79.8% token reduction
Cross-session memory - Claude remembers everything
Instant file access - /map-codebase for precision development
Persistent memory bank - productContext, systemPatterns, progress tracking

🚀 Quick Start (v2.0 - 2 Minutes)

Step 1: Install (30 seconds)

# Clone the repository
git clone https://github.com/kunwar-shah/mini-coder-brain.git
cd mini-coder-brain

# Run installer
chmod +x install.sh
./install.sh /path/to/your/project

Step 2: Initialize Context (MANDATORY ⚠️)

Open your project in Claude Code and run:

# Option A: With documentation (BEST - 90-95% quality)
/init-memory-bank --docs-path ./docs

# Option B: Auto-detect (GOOD - 75-85% quality)
/init-memory-bank

# Option C: Interactive (MINIMUM - 60-70% quality)
/init-memory-bank

Step 3: Verify Quality

/validate-context

Expected output:

📊 Context Quality: 85% (Recommended) ✅
✅ Ready for development!

That’s it! Claude now has measurable, high-quality context awareness.

📚 Documentation

🎯 Why Mini-CoderBrain?

The Problem

Ever had to explain your project structure to Claude again in a new conversation? Repeated the same context over and over? Lost track of decisions made in previous sessions?

The Solution

Mini-CoderBrain gives Claude perfect memory:

Remembers your project architecture
Knows your coding standards
Tracks development progress
Recalls all technical decisions
Maintains focus across sessions

The Result

✅ Zero repeated explanations - Claude knows your project
✅ Perfect continuity - Seamless context across sessions
✅ Faster development - No time wasted on context
✅ Better decisions - Access to full project history
✅ Longer conversations - Automatic memory optimization

🌟 What Makes It Special?

Universal Compatibility

Works with any project:

JavaScript/TypeScript (React, Node, Next.js, etc.)
Python (Django, Flask, FastAPI, etc.)
Rust, Go, Java, C++, PHP, Ruby
Mobile (React Native, Flutter, Swift, Kotlin)
Any framework, any language, any size

Zero Configuration

No config files to edit
No dependencies to install
No learning curve
Just drop in and go

Enterprise-Grade Features

Automatic project structure detection
Intelligent context optimization
Real-time activity tracking
Smart memory cleanup
Cross-session persistence

📊 Performance

25% longer conversations before token limits
Zero context duplication in prompts
79.9% token reduction vs. previous versions
Perfect continuity across unlimited sessions

🛠️ Core Commands (v2.0)

# Essential (Use These!)
/init-memory-bank              # Initialize context (MANDATORY)
/validate-context              # Check quality score
/update-memory-bank            # Update after major work (renamed from /umb)
/map-codebase                  # Instant file access system
/memory-cleanup                # Automatic bloat prevention

# Advanced
/import-docs ./path            # Import documentation
/memory-sync                   # Full context synchronization
/context-update                # Real-time context updates

See Commands Guide for complete documentation

💡 Example Use Cases

For Solo Developers

Track feature development across sessions
Remember architectural decisions
Maintain coding standards
Monitor progress toward goals

For Teams

Share project context automatically
Document decisions with timestamps
Maintain consistent patterns
Onboard new team members instantly

For Learning

Document learning progress
Track concepts mastered
Build knowledge base
Maintain study goals

🏆 Success Stories

“Mini-CoderBrain transformed how I work with Claude. It’s like having a senior developer who actually remembers our entire project history.” - Developer

“I dropped it into my React project and immediately saw the difference. Claude stopped asking about my tech stack and just started coding.” - Full-Stack Developer

“The automatic cleanup is brilliant. I never hit ‘Prompt is too long’ anymore.” - Python Developer

🤝 Contributing

We welcome contributions! See our Contributing Guide for details.

Ways to Contribute

🐛 Report bugs
💡 Suggest features
📖 Improve documentation
🔧 Submit pull requests

📄 License

MIT License - see LICENSE for details.

🔗 Links

GitHub: kunwar-shah/mini-coder-brain
Issues: Report a bug
Discussions: Join the conversation

Ready to supercharge your development workflow?

Get Started Now →