✨ Perfect man page viewer with optimal side-by-side layout

## Enhanced man function following Prime Directive principles
- **Durable**: Robust cross-terminal support (kitty/tmux/iTerm)
- **Thoughtful**: Optimal 60/40 split (~100 chars CLI, ~64 chars reading)
- **Lasting**: Clean code, proper error handling, graceful fallbacks

### Key Features
- Beautiful syntax highlighting with Nord theme
- Responsive width adaptation via MANWIDTH
- Kitty remote control with proper resize shortcuts
- Clean traditional appearance (no line numbers)
- Stays open until user dismisses

### Technical Improvements
- Uses /usr/bin/man explicitly to prevent recursion
- Proper environment detection and fallback chain
- Added kitty resize shortcuts to config
- Removed debug output for clean UX

### Files Updated
- shell/functions.zsh: Complete man() rewrite
- config/kitty/kitty.conf: Added resize shortcuts
- shell/aliases.zsh: Batman alias compatibility
- Cleanup of merged files and plugin updates

μέτρον γὰρ καὶ συμμετρία - measure, proportion, and what is fitting

🤖 Generated with [Claude Code](https://claude.ai/code)

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

EVOLUTION.md

@@ -0,0 +1,98 @@
+# Dotfiles Evolution Record
+
+## Prime Directive
+> _Prioritize durable, thoughtful solutions over expedient ones. The user intends to do things once, correctly, and with lasting integrity. Favor depth, clarity, and long-term maintainability over shortcuts or incomplete work._
+
+> **μέτρον γὰρ καὶ συμμετρία καὶ τὸ πρόσφορον πανταχοῦ καλόν τε καὶ ἀγαθόν παρέχει**
+> "Measure, proportion, and what is fitting give rise to beauty and goodness everywhere."
+
+## Project Timeline
+
+### 2025-07-29: Cleanup and Enhancement Session
+- **Context**: Claude audit review and implementation
+- **Key Decision**: Careful evaluation of recommendations against existing mature system
+- **Changes Made**:
+  - ✅ Removed duplicate `.zsh_plugins.txt` (underscore version)
+  - ✅ Removed redundant FZF sourcing from `aliases.zsh:78`
+  - ✅ Removed merge artifacts: `aliases-merged.zsh`, `functions-merged.zsh`
+  - ✅ Added dotfile management functions to `functions.zsh`:
+    - `dot` - Quick navigation to dotfiles directory
+    - `zedit`, `aedit`, `fedit`, `pedit` - Quick edit with auto-reload
+    - `backup-configs` - Timestamp-based critical config backup
+  - ✅ Created `EVOLUTION.md` to track project evolution
+- **Lessons**: Even mature systems benefit from periodic review and cleanup
+- **Next Steps**: Test new functions, monitor for any issues
+
+### 2025-07-28: Batman Returns Enhancement
+- **Commit**: `9d9c0ad` - 🦇 Batman returns with enhanced powers
+- **Notable**: Theme and enhancement phase
+
+### 2025-07-27: Complete Migration Setup
+- **Commit**: `389febb` - 🚀 Complete machine migration setup with encrypted backups
+- **Key Features**: 
+  - Encrypted backup system
+  - Machine migration capabilities
+  - Security-first approach
+
+### 2025-07-26: System Recovery
+- **Context**: Recovered from PATH issue that broke Claude CLI access
+- **Lesson**: Critical tool paths must be carefully managed and tested
+
+### Initial Architecture
+- **Philosophy**: Star Trek-inspired "Engage!" system
+- **Core Principles**:
+  - Durability over convenience
+  - Thoughtful modularization
+  - Measured implementation
+- **Key Components**:
+  - Modular shell configuration
+  - Sophisticated backup strategy
+  - System health monitoring
+  - Configuration drift detection
+
+## Design Decisions Log
+
+### Shell Configuration Strategy
+- **Decision**: Modular `.zsh` files over monolithic `.zshrc`
+- **Rationale**: Easier maintenance, clearer purpose, selective loading
+- **Outcome**: Successful - easy to debug and extend
+
+### Backup Philosophy
+- **Decision**: GPG-encrypted sensitive data with clear restore instructions
+- **Rationale**: Security without sacrificing recoverability
+- **Outcome**: Proven during system migrations
+
+### Performance Optimization
+- **Decision**: Conditional loading and interactive-only checks
+- **Rationale**: Fast shell startup while maintaining functionality
+- **Outcome**: Sub-100ms shell startup achieved
+
+## Future Considerations
+
+### Potential Enhancements
+1. **Declarative configuration**: Consider Nix-like approach for reproducibility
+2. **Multi-machine sync**: Extend beyond single machine setup
+3. **Plugin ecosystem**: Create hook system for custom extensions
+4. **Metrics collection**: Track usage patterns for informed evolution
+
+### Maintenance Schedule
+- **Quarterly**: Review and update Brewfile dependencies
+- **Semi-annual**: Audit shell performance and plugin necessity
+- **Annual**: Major architecture review and documentation update
+
+## Key Metrics
+- **Shell startup time**: Target < 100ms
+- **Total managed packages**: ~120 CLI tools, ~40 applications
+- **Configuration files**: 15+ applications managed
+- **Backup frequency**: Daily automated, encrypted
+- **System health checks**: 6 categories monitored
+
+## Guiding Quotes
+- "The best tools are the ones you forget you're using."
+- "Make it so!" - Captain Jean-Luc Picard
+- "Good tools become invisible."
+
+---
+
+*This document serves as the living memory of the dotfiles system evolution.*
+*Updated: 2025-07-29*