feat: Comprehensive Amplifier improvements with self-healing, Aider, and caching #29
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
🌍 Enable Amplifier's powerful AI agents and tools on any codebase, anywhere This major enhancement allows developers to harness Amplifier's 20+ specialized agents (zen-architect, bug-hunter, security-guardian, etc.) on any project without copying files or modifying existing repositories. ✨ New Features: - Global 'amplifier' command for system-wide access - Smart auto-detection of Amplifier installation location - Enhanced startup scripts with comprehensive error handling - Seamless integration with existing Claude workflows - Cross-platform compatibility (macOS, Linux, WSL) 🚀 Usage: make install-global # Install global command amplifier ~/my-project # Use Amplifier on any project amplifier --help # Show usage examples 📈 Benefits: - All 20+ specialized agents available on any codebase - Shared knowledge base across all projects - Same powerful automation and quality tools - Project isolation - changes only affect target project - No need to modify or copy files to existing projects 🔧 Implementation: - Enhanced amplifier-anywhere.sh with robust error handling - New bin/amplifier wrapper for global installation - Updated Makefile with install-global targets - Comprehensive documentation in README - Fixed Claude settings path resolution This democratizes access to Amplifier's AI development superpowers, making every codebase instantly compatible with the full Amplifier toolkit.
- Fix handling of Claude flags when no directory specified - Ensure --version flag works correctly without triggering full startup - Improve argument parsing logic to handle edge cases - Maintain backward compatibility with all usage patterns Tested scenarios: ✅ amplifier --version (shows version only) ✅ amplifier --print 'command' (uses current dir + Claude args) ✅ amplifier /path/to/project --model sonnet (explicit dir + args) ✅ amplifier /nonexistent/path (proper error handling) ✅ amplifier --help (shows help text)
- Modify .gitignore to permit bin/amplifier global command - Maintain exclusion of other build artifacts - Enable proper version control of global installation script
- Modified bin/amplifier to capture and pass the original PWD - Updated amplifier-anywhere.sh to use ORIGINAL_PWD when available - Fixes issue where 'amplifier' from any directory would default to amplifier repo instead of current dir
…ntegration, and knowledge synthesis caching
## 🚀 Major Features Added
### 1. Self-Healing System
- Implemented automated code health monitoring and healing
- Health metrics tracking: complexity, LOC, type errors
- Batch healing with configurable thresholds
- Safety checks and validation framework
- Evolution-based experiments for aggressive improvements
### 2. Aider Integration
- Full Aider CLI wrapper with Amplifier presets
- Support for zen philosophy mode (ruthless simplification)
- Multiple modes: chat, edit, architect
- Custom prompting with zen principles
### 3. Knowledge Synthesis Improvements
- Added smart caching system with TTL support
- Configuration management for synthesis parameters
- Improved error handling and retry logic
- Better progress tracking and partial result saving
### 4. Claude Code Slash Commands
- Fixed `/heal` command for auto-healing workflow
- Fixed `/aider` command for direct Aider access
- Proper bash execution syntax
- Added status checks and examples
### 5. Modular Architecture
- New `amplifier.cli` package structure
- Separated healing components into dedicated module
- Evolution experiments for advanced healing
- Improved code organization
## 📁 Directory Structure Changes
```
amplifier/
├── cli/ # New CLI package
│ ├── commands/ # Command implementations
│ │ ├── heal.py
│ │ └── aider.py
│ └── core.py # Main CLI entry point
├── healing/ # Healing subsystem
│ ├── core/ # Core healing logic
│ ├── analysis/ # Code analysis tools
│ ├── experiments/ # Evolution experiments
│ └── prompts/ # AI prompts
├── evolution/ # Evolution framework
└── knowledge_synthesis/ # Enhanced with caching
├── cache.py
└── config.py
```
## 🔧 Technical Improvements
- Type safety with proper annotations
- Comprehensive error handling
- Logging and monitoring
- Git integration for safe operations
- Validation and safety checks
- Performance optimizations
## 📚 Documentation
- Added comprehensive healing documentation
- Aider workflow guides
- Test coverage reports
- PR submission guidelines
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added --yes/-y option to skip confirmation prompt - Updated slash command to use --yes flag automatically - Enables automation-friendly healing without user interaction
- Add comprehensive .gitignore entries for temporary files - Add bin/amplifier-global for global installation without venv - Add tools/configure_shell.py to configure PATH in shell files - Clean up test and temporary artifacts from repo
- Remove mock_heal_test.py (temporary test script) - Remove demo_utils.backup (backup file from testing)
…oting Guide - Introduced a comprehensive document detailing the Sidechain Architecture in Claude Code, covering core design, agent identification, lifecycle, technical details, and implementation best practices. - Added a Troubleshooting Guide addressing common issues encountered during Claude Code session processing, including solutions and code examples for each issue.
… builder Add comprehensive documentation from empirical analysis of Claude Code's session logging system, including: - Session format specification with DAG structure and message schemas - Summary files analysis for branch checkpointing - Compact operations validation from testing across multiple projects Also includes WIP implementation of claude_code_transcripts_builder.py tool that processes Claude Code session logs to generate human-readable transcripts. The tool handles DAG structures, compact boundaries, and generates organized markdown output. Key learnings documented: - Messages form DAGs not linear chains - Compact operations create new roots in same file - "Redo from here" creates internal branches - Sessions can fork across files Tool features (WIP): - Processes .jsonl session files from ~/.claude/projects - Extracts all conversation paths from DAG structure - Handles compact boundaries with logical parent connections - Generates markdown transcripts with metadata 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
michaeljabbour
added a commit
to michaeljabbour/amplifier
that referenced
this pull request
Sep 30, 2025
Complete comprehensive technical specification library with all 44 principles: **People (6 specs)** - #1 Small AI-first working groups - #2 Strategic human touchpoints only - #3 Prompt engineering as core skill - microsoft#4 Test-based verification over code review - microsoft#5 Conversation-driven development - microsoft#6 Human escape hatches always available **Process (13 specs)** - microsoft#7 Regenerate, don't edit - microsoft#8 Contract-first everything - microsoft#9 Tests as the quality gate - microsoft#10 Git as safety net - microsoft#11 Continuous validation with fast feedback - microsoft#12 Incremental processing as default - microsoft#13 Parallel exploration by default - microsoft#14 Context management as discipline - microsoft#15 Git-based everything - microsoft#16 Docs define, not describe - microsoft#17 Prompt versioning and testing - microsoft#18 Contract evolution with migration paths - microsoft#19 Cost and token budgeting **Technology (18 specs)** - microsoft#20 Self-modifying AI-first codebase - microsoft#21 Limited and domain-specific by design - microsoft#22 Layered virtualization - microsoft#23 Protected self-healing kernel - microsoft#24 Long-running agent processes - microsoft#25 Simple interfaces by design - microsoft#26 Stateless by default - microsoft#27 Disposable components everywhere - microsoft#28 CLI-first design - microsoft#29 Tool ecosystems as extensions - microsoft#30 Observability baked in - microsoft#31 Idempotency by design (reference) - microsoft#32 Error recovery patterns built in - microsoft#33 Graceful degradation by design - microsoft#34 Feature flags as deployment strategy - microsoft#35 Least-privilege automation - microsoft#36 Dependency pinning and security scanning - microsoft#37 Declarative over imperative **Governance (7 specs)** - microsoft#38 Access control and compliance - microsoft#39 Metrics and evaluation everywhere - microsoft#40 Knowledge stewardship and institutional memory - microsoft#41 Adaptive sandboxing with explicit approvals - microsoft#42 Data governance and privacy controls - microsoft#43 Model lifecycle management - microsoft#44 Self-serve recovery with known-good snapshots Each specification includes: - Plain-language definition - AI-first development rationale - 4-6 implementation approaches - 5 good/bad example pairs with working code - 6 related principles with relationships - 7 common pitfalls with examples - Tools organized by category - 12 actionable checklist items Statistics: - 44 specifications totaling ~10,000+ lines - 220+ good/bad code example pairs - 240+ implementation approaches - 300+ documented anti-patterns - 500+ tools and frameworks - 250+ cross-principle relationships Created through parallel AI agent execution demonstrating Principle microsoft#13 (Parallel Exploration by Default). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
michaeljabbour
added a commit
to michaeljabbour/amplifier
that referenced
this pull request
Sep 30, 2025
Add comprehensive CLI tool for managing AI-first principle specifications. **Features:** - List principles (with filtering by category/status) - Validate specifications against quality standards - Quality scoring with comprehensive checks - Progress tracking across all specifications - Stub generation for new principles **Tool Commands:** - list: View all principles with filtering - validate: Check specification structure - check-quality: Comprehensive quality scoring - update-progress: Statistics by category - create: Generate new principle stubs **Quality Checks:** - Required sections present - Minimum 5 example pairs - 6+ related principles - 8-12 checklist items - 5-7 common pitfalls - Complete metadata **Documentation:** - tools/README.md: Complete tool guide - Main README updated with Quick Start and usage **Demonstrates Principles:** - microsoft#28 CLI-First Design - microsoft#29 Tool Ecosystems as Extensions - microsoft#25 Simple Interfaces by Design - microsoft#31 Idempotency by Design - microsoft#9 Tests as Quality Gate Provides path for maintaining and expanding the specification library as Amplifier grows. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR introduces comprehensive improvements to the Amplifier toolkit, including:
/healand/aiderMajor Features
🔧 Self-Healing System
🤖 Aider Integration
💾 Knowledge Synthesis Caching
📝 Claude Code Commands
/heal- Run auto-healing workflow/aider- Launch Aider with optionsArchitecture Changes
Testing
Documentation
Usage
🤖 Generated with Claude Code