🧭 DevPilot CLI

🇬🇧 English | 🇫🇷 Français

🇬🇧 English

🚀 Meta-Framework for AI-Assisted Development

DevPilot is a powerful CLI meta-framework that supercharges AI coding assistants (Claude Code, Cursor, Windsurf, Aider) with persistent memory, intelligent context awareness, and adaptive guidance.

Never lose context again. DevPilot's anti-drift system ensures your AI assistant always remembers your project state, decisions, and architecture.

✨ Key Features

🧠 Anti-Drift Memory System

• Persistent memory across all sessions (status.yaml, context.yaml)
• AI always reads memory before each action
• Decision tracking and history
• Checkpoint system for safe rollbacks
• Golden rules enforcement

🤖 21 Specialized AI Agents

• 7 Core Agents: Pilot, Analyst, PM, Architect, Developer, QA, SecOps
• 10 Specialist Agents: API Designer, DevOps, DBA, Mobile Dev, Data Scientist, and more
• 4 Creative Agents: Brainstormer, Innovator, Storyteller, Strategist

🛤️ 4 Development Tracks

• ⚡ Quick: Rapid prototyping (70% coverage, basic security)
• 📋 Standard: Balanced approach (80% coverage, standard security)
• 🏢 Enterprise: Production-ready (90% coverage, enhanced security)
• 🔒 Secure: Maximum security (95% coverage, full OWASP compliance)

🔌 Claude Code Integration

Use real slash commands:

• /pilot - Main orchestrator
• /dev - Development agent
• /qa - Quality assurance
• /secure - Security audit
• /analyst, /pm, /archi - and more!

🌍 Adaptive & Bilingual

• Adapts to your skill level: beginner → senior
• Native French & English support
• Automatic tool detection (Claude Code, Cursor, Windsurf, Aider)

📦 Installation

npm install -g devpilot-cli

🏁 Quick Start

# 1. Initialize DevPilot in your project
cd your-project
devpilot init

# 2. Install Claude Code commands (enables /pilot, /dev, etc.)
devpilot install-skills

# 3. Use with Claude Code
claude
/pilot

# 4. Or use without slash (works with all AI tools)
pilot

🎯 Available Commands

| Command | Agent | Description | |---------|-------|-------------| | /pilot | 🧭 Pilot | Main orchestrator - shows status and suggests next steps | | /analyst | 📊 Analyst | Analyzes requirements and creates project brief | | /pm | 📋 PM | Product Manager - creates PRD and user stories | | /archi | 🏗️ Architect | Designs system architecture and tech stack | | /dev | 💻 Developer | Implements features following architecture | | /qa | 🧪 QA | Writes and executes tests | | /secure | 🔒 SecOps | Security audit (OWASP Top 10) | | /status | 📊 Status | Displays current project status |

🧠 How It Works

graph LR
    A[You] -->|/pilot| B[DevPilot]
    B -->|Reads| C[status.yaml]
    B -->|Reads| D[context.yaml]
    C --> E[Project State]
    D --> F[Golden Rules]
    E --> G[AI Agent]
    F --> G
    G -->|Takes Action| H[Your Project]
    H -->|Updates| C
    H -->|Updates| D

1. You type /pilot (or any agent command)
2. DevPilot reads _devpilot/status.yaml and _devpilot/memory/context.yaml
3. AI agent activates with full project context
4. Agent takes action following golden rules
5. Memory updates automatically

Result: AI never loses context, always follows your architecture, respects your rules.

📚 Documentation

• Quick Start Guide
• Installation Guide
• Contributing
• Changelog

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

📄 License

MIT License - see LICENSE for details

🇫🇷 Français

🚀 Meta-Framework pour le Développement Assisté par IA

DevPilot est un puissant meta-framework CLI qui surcharge les assistants de codage IA (Claude Code, Cursor, Windsurf, Aider) avec une mémoire persistante, une conscience contextuelle intelligente et un guidage adaptatif.

Ne perdez plus jamais le contexte. Le système anti-drift de DevPilot garantit que votre assistant IA se souvient toujours de l'état de votre projet, de vos décisions et de votre architecture.

✨ Fonctionnalités Principales

🧠 Système de Mémoire Anti-Drift

• Mémoire persistante entre toutes les sessions (status.yaml, context.yaml)
• L'IA lit toujours la mémoire avant chaque action
• Suivi des décisions et historique
• Système de checkpoints pour rollbacks sécurisés
• Application des règles d'or

🤖 21 Agents IA Spécialisés

• 7 Agents Core : Pilot, Analyst, PM, Architect, Developer, QA, SecOps
• 10 Agents Spécialistes : API Designer, DevOps, DBA, Mobile Dev, Data Scientist, etc.
• 4 Agents Créatifs : Brainstormer, Innovator, Storyteller, Strategist

🛤️ 4 Pistes de Développement

• ⚡ Quick : Prototypage rapide (70% coverage, sécurité basique)
• 📋 Standard : Approche équilibrée (80% coverage, sécurité standard)
• 🏢 Enterprise : Prêt pour la production (90% coverage, sécurité renforcée)
• 🔒 Secure : Sécurité maximale (95% coverage, conformité OWASP complète)

🔌 Intégration Claude Code

Utilisez de vraies commandes slash :

• /pilot - Orchestrateur principal
• /dev - Agent développeur
• /qa - Assurance qualité
• /secure - Audit de sécurité
• /analyst, /pm, /archi - et plus encore !

🌍 Adaptatif & Bilingue

• S'adapte à votre niveau : débutant → senior
• Support natif français & anglais
• Détection automatique des outils (Claude Code, Cursor, Windsurf, Aider)

📦 Installation

npm install -g devpilot-cli

🏁 Démarrage Rapide

# 1. Initialiser DevPilot dans votre projet
cd votre-projet
devpilot init

# 2. Installer les commandes Claude Code (active /pilot, /dev, etc.)
devpilot install-skills

# 3. Utiliser avec Claude Code
claude
/pilot

# 4. Ou utiliser sans slash (fonctionne avec tous les outils IA)
pilot

🎯 Commandes Disponibles

| Commande | Agent | Description | |----------|-------|-------------| | /pilot | 🧭 Pilot | Orchestrateur principal - affiche le status et suggère les prochaines étapes | | /analyst | 📊 Analyst | Analyse les besoins et crée le brief projet | | /pm | 📋 PM | Product Manager - crée le PRD et les user stories | | /archi | 🏗️ Architect | Conçoit l'architecture système et la stack technique | | /dev | 💻 Developer | Implémente les features en suivant l'architecture | | /qa | 🧪 QA | Écrit et exécute les tests | | /secure | 🔒 SecOps | Audit de sécurité (OWASP Top 10) | | /status | 📊 Status | Affiche le status actuel du projet |

🧠 Comment Ça Marche

graph LR
    A[Vous] -->|/pilot| B[DevPilot]
    B -->|Lit| C[status.yaml]
    B -->|Lit| D[context.yaml]
    C --> E[État Projet]
    D --> F[Règles d'Or]
    E --> G[Agent IA]
    F --> G
    G -->|Agit| H[Votre Projet]
    H -->|Met à jour| C
    H -->|Met à jour| D

1. Vous tapez /pilot (ou toute commande agent)
2. DevPilot lit _devpilot/status.yaml et _devpilot/memory/context.yaml
3. L'agent IA s'active avec le contexte complet du projet
4. L'agent agit en suivant les règles d'or
5. La mémoire se met à jour automatiquement

Résultat : L'IA ne perd jamais le contexte, suit toujours votre architecture, respecte vos règles.

📚 Documentation

• Guide de Démarrage Rapide
• Guide d'Installation
• Contribuer
• Changelog

🤝 Contribuer

Les contributions sont bienvenues ! Voir CONTRIBUTING.md pour les directives.

📄 Licence

Licence MIT - voir LICENSE pour les détails

🌟 Star History

💖 Support

If you find DevPilot useful, please consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs
• 💡 Suggesting features
• 🤝 Contributing code

Made with ❤️ for developers who want AI assistance without losing control