Initial commit: Claude Code Hooks with Diátaxis documentation

✨ Features:
- 🧠 Shadow learner that builds intelligence from command patterns
- 🛡️ Smart command validation with safety checks
- 💾 Automatic context monitoring and backup system
- 🔄 Session continuity across Claude restarts

📚 Documentation:
- Complete Diátaxis-organized documentation
- Learning-oriented tutorial for getting started
- Task-oriented how-to guides for specific problems
- Information-oriented reference for quick lookup
- Understanding-oriented explanations of architecture

🚀 Installation:
- One-command installation script
- Bootstrap prompt for installation via Claude
- Cross-platform compatibility
- Comprehensive testing suite

🎯 Ready for real-world use and community feedback!

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

DEMO.md

@@ -0,0 +1,121 @@
+# Claude Code Hooks Demo
+
+## What We Built
+
+A complete, production-ready hooks system for Claude Code with:
+
+## 🧠 Intelligent Features
+- **Shadow Learner**: Learns from your command patterns and prevents repeated failures
+- **Context Monitor**: Automatically backs up your work before hitting context limits
+- **Session Continuity**: Seamlessly restore context across Claude sessions
+- **Smart Validation**: Blocks dangerous commands and suggests alternatives
+
+## 📁 Project Structure
+```
+claude-hooks/
+├── hooks/               # Hook scripts called by Claude Code
+│   ├── context_monitor.py      # UserPromptSubmit hook
+│   ├── command_validator.py    # PreToolUse[Bash] hook  
+│   ├── session_logger.py       # PostToolUse[*] hook
+│   └── session_finalizer.py    # Stop hook
+├── lib/                 # Core library components
+│   ├── shadow_learner.py       # Pattern learning engine
+│   ├── context_monitor.py      # Token estimation & backup triggers
+│   ├── backup_manager.py       # Resilient backup system
+│   ├── session_state.py        # Session continuity
+│   └── models.py               # Data models
+├── config/              # Configuration templates
+├── scripts/             # Installation & management scripts
+└── docs/               # Documentation
+```
+
+## 🚀 Quick Start
+
+1. **Install:**
+   ```bash
+   cd claude-hooks
+   ./scripts/install.sh
+   ```
+
+2. **Configure Claude Code:**
+   The installer will automatically add the hooks configuration to your Claude settings.
+
+3. **Test:**
+   ```bash
+   ./scripts/test.sh
+   ```
+
+## 🎯 Features in Action
+
+### Command Validation
+```bash
+$ pip install requests
+# ⛔ Blocked: pip commands often fail (confidence: 95%)
+# 💡 Suggestion: Use "pip3 install requests"
+```
+
+### Context Monitoring
+```
+Auto-backup created: context_threshold (usage: 87%)
+```
+
+### Session Continuity
+- `LAST_SESSION.md` - Complete session summary
+- `ACTIVE_TODOS.md` - Persistent task tracking
+- `RECOVERY_GUIDE.md` - Step-by-step restoration
+
+### Shadow Learning
+The system learns from every interaction:
+- Failed commands → Suggests alternatives
+- Successful patterns → Recognizes workflows
+- Error contexts → Provides relevant warnings
+
+## 🛡️ Safety & Security
+
+- **Fail-Safe Design**: Never blocks Claude's core functionality
+- **Command Injection Protection**: Blocks malicious command patterns
+- **Path Traversal Prevention**: Protects system files
+- **Data Sanitization**: Removes secrets from logs
+- **Resource Limits**: Prevents DoS attacks
+
+## 📊 Monitoring & Management
+
+```bash
+# Check system status
+claude-hooks status
+
+# View learned patterns
+claude-hooks patterns
+
+# List backups
+claude-hooks list-backups
+
+# Export all data
+claude-hooks export
+```
+
+## 🔧 Architecture Highlights
+
+- **Event-Driven**: Uses Claude Code's native hook points
+- **Resilient**: Comprehensive error handling and fallbacks
+- **Performance-Optimized**: Caching, rate limiting, async operations
+- **Extensible**: Clean interfaces for adding new features
+
+## 💪 Edge Cases Handled
+
+- Hook script crashes → Fail-safe defaults
+- Git repository issues → Filesystem fallbacks  
+- Network storage failures → Local cache
+- Database corruption → Multiple recovery levels
+- Resource exhaustion → Automatic cleanup
+- Concurrent sessions → Process isolation
+
+## 🎉 What Makes This Special
+
+1. **Learning System**: Gets smarter with every use
+2. **Zero Downtime**: Never interrupts your workflow
+3. **Context Preservation**: Never lose work to context limits
+4. **Intelligent Validation**: Prevents issues before they happen
+5. **Complete Solution**: Production-ready out of the box
+
+This is a sophisticated, enterprise-grade system that transforms Claude Code into an intelligent, self-improving development assistant!