📚 AI Coding Instructions Framework

Framework complet d'instructions pour agents de codage IA, organisé par domaine d'expertise.

🎯 Objectif

Fournir des directives claires et actionnables pour que vos agents IA puissent :

• Écrire du code de haute qualité
• Maintenir des standards cohérents
• Résoudre les problèmes de manière systématique
• Concevoir des architectures robustes
• Mettre en place des tests complets

� Structure du Framework

� core/ - Fondamentaux

Fichiers essentiels utilisés dans tous les scénarios.

| Fichier | Description | |---------|-------------| | protocol.md | Commandes et protocoles de base | | decision-log.md | Suivi des décisions architecturales | | risk-levels.md | Classification des niveaux de risque |

� scenarios/ - Cas d'Usage

Guides spécifiques pour chaque situation de développement.

| Fichier | Quand l'utiliser | |---------|------------------| | new-project.md | Démarrage d'un nouveau projet | | existing-project.md | Intégration à un projet existant | | feature-addition.md | Ajout de nouvelles fonctionnalités | | feature-removal.md | Suppression sécurisée de code | | bug-fixing.md | Résolution de bugs | | refactoring.md | Refactoring et amélioration | | feature-workflow.yaml | Workflow structuré YAML |

✅ quality/ - Qualité

Standards et processus d'assurance qualité.

| Fichier | Description | |---------|-------------| | code-standards.md | Standards de code | | testing-strategy.md | Stratégies de test | | review-guidelines.md | Guidelines de review |

🏗️ architecture/ - Architecture

Patterns et principes de conception.

| Fichier | Description | |---------|-------------| | design-patterns.md | Patterns de conception | | system-design.md | Conception de systèmes |

🛡️ governance/ - Gouvernance

Gestion et responsabilités.

| Fichier | Description | Status | |---------|-------------|--------| | ai-responsibility.md | Responsabilités des agents IA | Recommandé | | pr-template.md | Template de pull request | Recommandé | | versioning.md | Stratégies de versioning | OBLIGATOIRE |

🚀 Scénarios d'Utilisation

🆕 Nouveau Projet

1. core/risk-levels.md          → Évaluer la complexité
2. scenarios/new-project.md     → Setup initial
3. architecture/system-design.md → Concevoir l'architecture
4. quality/code-standards.md    → Établir les standards
5. quality/testing-strategy.md  → Setup des tests

🚀 Ajout de Feature

1. core/decision-log.md         → Documenter la décision
2. scenarios/feature-addition.md → Implémenter la feature
3. quality/testing-strategy.md  → Tester
4. governance/pr-template.md  → Préparer la PR

🐛 Résolution de Bug

1. scenarios/bug-fixing.md      → Investiger
2. core/risk-levels.md         → Évaluer l'impact
3. quality/testing-strategy.md → Tests de régression
4. quality/review-guidelines.md → Review

🔄 Refactoring

1. core/risk-levels.md         → Évaluer le risque
2. scenarios/refactoring.md     → Planifier
3. quality/code-standards.md  → Appliquer les standards
4. quality/testing-strategy.md → Vérifier

📊 Métriques de Succès

• Couverture de test : > 80%
• Dette technique : Réduite progressivement
• Temps de setup : < 30 minutes
• Régressions : Minimisées

🤖 Pour les Agents IA

1. Lire le contexte : Comprendre le type de tâche
2. Sélectionner le guide : Choisir le fichier approprié
3. Suivre la méthodologie : Appliquer les étapes
4. Documenter : Enregistrer les décisions
5. Vérifier : S'assurer de la conformité

📜 Versions

• v2.0.0 (2026-03-03) : Réorganisation en framework structuré
• v1.3.0 : Workflow YAML et guides additionnels
• v1.0.0 : Collection initiale

Framework conçu pour une collaboration efficace entre humains et agents IA.