Skip to content

Conversation

@michaeljabbour
Copy link

Summary

This PR adds standalone Aider tools to Amplifier, enabling AI-powered module regeneration using different development philosophies.

What's Included

  • amplifier/tools/aider_regenerator.py: Core regeneration tool with support for three philosophies (fractalized, modular, zen)
  • scripts/setup-aider.sh: Installation script for setting up Aider in an isolated environment
  • docs/aider-tools.md: Comprehensive documentation

Key Features

  • Philosophy-based regeneration: Choose between fractalized thinking, modular design, or zen simplicity
  • Batch processing: Regenerate multiple modules at once
  • Specification support: Regenerate based on explicit specifications
  • Isolated installation: Aider runs in its own virtual environment to avoid dependency conflicts

Usage Example

# Setup
bash scripts/setup-aider.sh

# Regenerate a module
python amplifier/tools/aider_regenerator.py amplifier/my_module.py --philosophy zen

Why This Matters

AI-powered code regeneration allows for:

  • Consistent code quality improvements
  • Philosophy-aligned refactoring
  • Automated technical debt reduction
  • Faster iteration on module design

Testing

The tool has been tested with:

  • Single module regeneration
  • Batch processing
  • Different philosophy modes
  • Error handling (missing files, timeout scenarios)

Dependencies

The tool is installed in an isolated .aider-venv environment to avoid conflicts with the main project dependencies.

🌍 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
- Add standalone aider_regenerator.py tool with three philosophies
- Create setup script for isolated Aider installation
- Include comprehensive documentation
- Enable philosophy-based module regeneration (fractalized, modular, zen)
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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant