Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/moham1999/claude-multi-ai-framework itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 23, 2026Claude Multi-AI Framework
A language-agnostic, multi-AI orchestration framework for software development automation with pluggable language adapters.
🎯 What Is This?
A production-ready framework that enables AI agents (Claude Code, Gemini CLI, GPT-4, etc.) to work together on software projects across any programming language through a plugin-based adapter system.
Key Innovation: Generic agents + language-specific skill adapters = Universal automation
✨ Features
- 🌐 Multi-AI Support: Claude Code, Gemini CLI, GPT-4, and extensible to any AI
- 🔌 Language Adapters: Plug-and-play skills for PHP, Python, Java, JavaScript, and more
- 🤖 Specialized Agents: Code validation, testing, research, session management
- 📝 Context Management: Auto-synced context files for all AI providers
- ⚡ Auto-Orchestration: Skills activate based on task patterns
- 🎓 Guided Learning: Interactive tutorials for framework mastery
📦 What's Included
Agents (4 Generic + 2 TODO)
- ✅ code-validator - Generic validation with language adapter loading
- ✅ context-sync - Synchronizes multi-AI context files
- ✅ session-closer - Automated session finalization with git
- ✅ external-ai-coordinator - Multi-AI ensemble coordination
- 🔲 test-implementer - TODO: Refactor to use adapters
- 🔲 research-specialist - TODO: Refactor to use adapters
Skills (5 Total)
- php-validation - PHP/PSR-12/security validation (proof of concept)
- multi-agent-orchestrator - Auto-coordinates complex workflows
- ensemble-decision - Multi-AI voting for decisions
- guided-learning - Interactive learning system
- gemini-integration - Gemini CLI integration helper
Commands (13 Slash Commands)
/research,/quick-research,/dev-research/hybrid-implement,/test-validate-loop/ensemble-decide,/route-ai/gemini,/use-gemini/session-close- And more...
🚀 Quick Start
Installation
# Clone the repository
git clone https://github.com/YOUR_USERNAME/claude-multi-ai-framework.git
cd claude-multi-ai-framework
# Install globally
./install.sh
# Or manually:
cp -r agents ~/.claude/
cp -r skills ~/.claude/
cp -r commands ~/.claude/
cp config/ai-registry.json ~/.claude/
Initialize a New Project
cd your-project
~/.claude/init-project.sh "My Project" "PHP" "Project description"
This creates:
.claude/claude.md- Claude Code context.claude/gemini.md- Gemini CLI context.claude/gpt4.md- GPT-4 context.claude/settings.json- Hooks and permissions.agent-state/- Agent communication infrastructure
Use in Your Project
# Start Claude Code (auto-loads claude.md)
claude
# Or use Gemini CLI (auto-loads gemini.md)
gemini
# Framework provides all agents and skills automatically
🏗️ Architecture
The Adapter Pattern
Generic Agent (e.g., code-validator)
↓
Detects Language (from context or project files)
↓
Loads Appropriate Adapter (e.g., php-validation)
↓
Executes with Language-Specific Knowledge
Benefits:
- One agent works with ALL languages
- Easy to add new languages (just create skill)
- No code duplication
- Follows industry best practices (validated by Gemini 2.5 Pro)
Multi-AI Context System
Project Context Files:
├── claude.md (auto-loaded by Claude Code)
├── gemini.md (auto-loaded by Gemini CLI)
└── gpt4.md (auto-loaded by GPT-4)
AI-agnostic content synchronized automatically via context-sync agent
📖 Documentation
- Adapter Interface - Specification for creating language adapters
- Agent-Agnostic Analysis - Multi-AI architecture details
- Refactoring Plan - Implementation roadmap
- Research Validation - Gemini's architectural review
🔧 Creating Language Adapters
Want to add support for a new language? It's easy:
-
Copy the adapter template:
cp -r skills/php-validation skills/rust-validation -
Update
SKILL.mdwith Rust-specific:- Linter (cargo clippy)
- Test framework (cargo test)
- Security patterns
- Best practices
-
Add to registry:
{ "rust": { "validation_skill": "rust-validation", "testing_skill": "rust-testing" } } -
Done! The framework now supports Rust.
See adapters/ADAPTER_INTERFACE.md for full specification.
🧪 Testing
# Test code-validator with PHP project
cd examples/php-sample
claude "validate all PHP files"
# Test with Python project
cd examples/python-sample
claude "validate all Python files"
# Multi-language project
cd examples/polyglot
claude "validate backend (Java) and frontend (JavaScript)"
🤝 Contributing
Contributions welcome! Priority areas:
- Language Adapters: Python, Java, JavaScript, TypeScript, Go, Rust
- Refactor Agents: test-implementer, research-specialist
- Documentation: Tutorials, examples, best practices
- Testing: Unit tests, integration tests, example projects
See CONTRIBUTING.md for guidelines.
📊 Project Status
- ✅ Multi-AI architecture (claude.md, gemini.md, gpt4.md)
- ✅ Adapter interface specification
- ✅ PHP validation adapter (proof of concept)
- ✅ Generic code-validator agent
- ✅ Context synchronization
- ✅ Session management automation
- ⏳ Python/Java/JavaScript adapters (planned)
- ⏳ Refactor test-implementer (planned)
- ⏳ Refactor research-specialist (planned)
🙏 Credits
Built on research validating industry best practices from:
- ESLint (plugin architecture)
- Docker (adapter pattern)
- Terraform (provider system)
- VS Code (extension model)
Architectural approach validated by:
- Gemini 2.5 Pro (independent research)
- Claude Sonnet 4.5 (implementation)
- Multi-agent collaboration testing
📄 License
MIT License - see LICENSE for details
🔗 Links
- Documentation: docs/
- Examples: examples/
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Built with ❤️ by the multi-AI community