# SuperGemini v4.0.0 🚀
[![Website Preview](https://img.shields.io/badge/Visit-Website-blue?logo=google-chrome)](https://superclaude-org.github.io/SuperGemini_Website/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://img.shields.io/pypi/v/SuperGemini.svg)](https://pypi.org/project/SuperGemini/)
[![Version](https://img.shields.io/badge/version-4.0.0-blue.svg)](https://github.com/SuperClaude-Org/SuperGemini_Framework)
[![GitHub issues](https://img.shields.io/github/issues/SuperClaude-Org/SuperGemini_Framework)](https://github.com/SuperClaude-Org/SuperGemini_Framework/issues)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/SuperClaude-Org/SuperGemini_Framework/blob/master/CONTRIBUTING.md)
[![Contributors](https://img.shields.io/github/contributors/SuperClaude-Org/SuperGemini_Framework)](https://github.com/SuperClaude-Org/SuperGemini_Framework/graphs/contributors)
[![Website](https://img.shields.io/website?url=https://superclaude-org.github.io/SuperGemini_Website/)](https://superclaude-org.github.io/SuperGemini_Website/)

SuperGemini is a meta-programming configuration framework that enhances Gemini CLI with structured development capabilities. It provides 18 slash commands in TOML format, 13 specialized AI agents with Persona Mode, behavioral instructions, and workflow automation for systematic software development.

## Quick Start

```bash
# Install SuperGemini Framework
pip install SuperGemini

# Setup SuperGemini for Gemini CLI
SuperGemini install

# Use with Gemini CLI
# Example: /sg:analyze src/
# Example: /sg:implement user authentication
```

## What is SuperGemini? 💎

SuperGemini transforms Gemini CLI into a structured development platform by providing:

- **18 Slash Commands**: TOML-based commands for systematic workflow automation (/sg:analyze, /sg:implement, etc.)
- **Persona Mode**: 13 specialized AI agents that embody specific roles (system-architect, security-engineer, etc.)
- **Behavioral Instructions**: Core principles and rules for consistent development practices
- **Workflow Automation**: Systematic approaches to analysis, implementation, and optimization

Unlike traditional tools, SuperGemini uses **Persona Mode** where Gemini CLI embodies agent roles rather than spawning separate sub-agents.

[![GitHub Sponsors](https://img.shields.io/badge/sponsor-30363D?style=for-the-badge&logo=GitHub-Sponsors&logoColor=#white)](https://github.com/sponsors/SuperClaude-Org)

## Documentation

### Getting Started
- [Quick Start Guide](Getting-Started/quick-start.md)
- [Installation Guide](Getting-Started/installation.md)

### User Guides
- [Commands Reference](User-Guide/commands.md) - 18 TOML-based slash commands
- [Agents Guide](User-Guide/agents.md) - 13 specialized AI personas
- [Behavioral Modes](User-Guide/modes.md) - Context-aware operation modes
- [Flags Guide](User-Guide/flags.md) - Command flags and options

### Developer Resources
- [Technical Architecture](Developer-Guide/technical-architecture.md)
- [Contributing Code](Developer-Guide/contributing-code.md)
- [Testing & Debugging](Developer-Guide/testing-debugging.md)

### Reference
- [Best Practices](Reference/best-practices.md)
- [Examples Cookbook](Reference/examples-cookbook.md)
- [Troubleshooting](Reference/troubleshooting.md)

## Contributing

**Current Priorities:**
- 📝 Documentation improvements and usage examples
- 🎯 TOML command workflow patterns and best practices
- 🤖 New AI agent personas for specialized domains
- 🧪 Testing and validation for Gemini CLI integration
- 🌐 Translation and internationalization

See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed contribution guidelines.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

**Contributors:** [View all contributors](https://github.com/SuperClaude-Org/SuperGemini_Framework/graphs/contributors)
