# Formation : Développement agentique & Spec-Driven Development

## 1. Pourquoi cette formation ?
L'ingénieur logiciel ne doit plus coder à l'aveugle via des copier-coller (vibe coding).
Le métier évolue vers l'orchestration, la spécification stricte et la revue de code.
Cette formation pratique apprend à piloter les agents autonomes avec une rigueur absolue.

## 2. Thématique et Public
- **Public** : Jeunes développeurs, anciens développeurs rouillés et lead tech.
- **Méthodologie** : Spec-Driven Development (SDD).
- **Résultat** : Un gain de productivité et un contrôle total sur tes dépôts.

## 3. Prêt à nous rejoindre ?
Clique sur le fichier "inscription.json" dans l'explorateur à gauche pour remplir ton dossier.

# Module 1 : Le nouveau paradigme de l'ingénieur logiciel

## Objectif : Devenir chef de chantier technique plutôt que simple codeur à la main.

## Concepts abordés :
- L'analogie du chef de chantier et des ouvriers spécialisés (les agents).
- Pourquoi le vibe coding échoue inévitablement sur les projets de production.

## Atelier pratique :
Auditer un projet "vibe-codé" buggé et concevoir un plan d'action de redressement.

# Module 2 : Anatomie des agents vs chatbots

## Objectif : Comprendre le fonctionnement interne d'un agent pour mieux le piloter.

## Concepts abordés :
- La boucle cognitive ReAct (Reason-Act).
- L'outillage system (filesystem, commands) et le protocole MCP.
- La gestion et l'optimisation de la fenêtre de contexte (tokens).

## Atelier pratique :
Analyser pas à pas le journal d'activité d'un agent pour identifier ses dérives.

# Module 3 : La recette du Spec-Driven Development (SDD)

## Objectif : Maîtriser le flux de travail rigoureux où le code est la dernière étape.

## Concepts abordés :
- Cadrage & Brainstorming initial (sans modification de code).
- Rédaction de la PRD et des Spécifications Techniques sans ambiguïté.
- Découpage en un plan d'implémentation chirurgical.

## Atelier pratique :
Rédiger la PRD et le plan d'implémentation pour un moteur de codes promotionnels.

# Module 4 : Le contrat d'interface agentique & la persistance

## Objectif : Configurer et brider l'agent à sa connexion sur un dépôt.

## Concepts abordés :
- Fichiers de règles (`GEMINI.md`, `CLAUDE.md`, `.cursorrules`).
- Persistance locale : configuration des Skills et des Workflows.
- Déclaration d'outils (JSON Schema) et Model Context Protocol (MCP).

## Atelier pratique :
Configurer un dépôt de microservice PDF avec un contrat d'interface et un linter MCP.

# Module 5 : La documentation continue comme source de vérité

## Objectif : Éviter la dérive de l'agent en maintenant la documentation à jour à chaque commit.

## Concepts abordés :
- Le triptyque : Changelog, Backlog, Wiki technique.
- Enregistrement des décisions d'architecture (ADR).

## Atelier pratique :
Simuler une demande d'évolution complexe et réaliser la mise à jour documentaire synchrone.

# Module 6 : Projet fil rouge - De l'idée à la production

## Objectif : Valider l'ensemble des compétences de la formation.

## Énoncé :
Développer l'API "TaskFlow" (CRUD, tags, rappels automatisés) en appliquant strictement le flux SDD, validé par des tests unitaires et d'intégration.