| name | atomic-tasks |
| description | Pattern GSD (Get Shit Done) - découper en tâches atomiques avec contextes subagent frais pour combattre le context rot. Use when planning complex work or working past 50% context usage. |
| context | fork |
Atomic Tasks — Pattern GSD (Get Shit Done)
Pattern inspiré de gsd-build/get-shit-done (Lex Christopherson, adopté par Amazon/Google/Shopify/Webflow).
Objectif : combattre le context rot (dégradation de la qualité au-delà de ~50% de contexte utilisé) en découpant le travail en tâches atomiques exécutées dans des subagents à contexte frais.
Les 5 étapes du pattern GSD
1. Split work — Découper
Découper la feature en tâches atomiques :
- Chacune exprimable en 1-3 phrases
- Chacune réalisable en < 30 minutes
- Chacune testable indépendamment
- Chacune committable en un commit atomique
❌ MAUVAIS : "Ajouter le système d'authentification"
✅ BON :
1. "Créer la table users avec migration"
2. "Implémenter POST /auth/register avec validation email"
3. "Implémenter POST /auth/login retournant JWT"
4. "Ajouter middleware JWT verification"
5. "Tests d'intégration du flow login"
2. Small plans — Plans courts par tâche
Pour chaque tâche atomique, un plan court :
- 1 objectif
- 3-5 étapes max
- Critères de succès explicites (test qui passe, endpoint qui répond, fichier qui existe)
3. Fresh subagent contexts — Contexte neuf à chaque tâche
Règle fondamentale : chaque tâche atomique s'exécute dans un subagent à contexte frais (via Task tool ou /clear entre tâches).
| Raison | Impact |
|---|
| Contexte < 30% au démarrage | Qualité réponses maximale |
| Pas de résidus de la tâche précédente | Zéro confusion cross-task |
| Coût tokens optimisé | Pas de relecture inutile du contexte accumulé |
| Parallélisable | Plusieurs subagents en simultané |
Implémentation :
- Utiliser
Agent tool avec subagent_type=general-purpose ou spécialisé
- Passer UNIQUEMENT le contexte nécessaire (pas tout le projet)
- Demander un rapport concis à la fin (< 200 mots)
4. Atomic git commits — Commits atomiques
Chaque tâche = 1 commit. Jamais de commit qui mélange 2 tâches.
✅ BON :
commit 1 : "feat(auth): add users table migration"
commit 2 : "feat(auth): implement register endpoint"
commit 3 : "feat(auth): implement login endpoint"
❌ MAUVAIS :
commit 1 : "feat: auth system + bug fixes + refactor"
Bénéfice : git bisect efficace, reverts ciblés, review facilitée.
5. Verify goals — Vérifier chaque objectif
Avant de passer à la tâche suivante, vérifier explicitement que l'objectif est atteint :
Règle : pas de "je pense que ça marche". Preuve ou pas fini.
Signaux qu'il faut appliquer ce pattern
- Contexte utilisé > 50%
- Tâche qui s'étale sur > 1h sans livrable intermédiaire
- Réponses de Claude qui deviennent moins précises
- Besoin de re-expliquer des choses déjà dites
- Multiple responsabilités dans une seule demande
Anti-patterns à éviter
| Anti-pattern | Pourquoi mauvais |
|---|
| Kitchen-sink session | Tout faire dans 1 session = context rot garanti |
| Tâche non testable | Impossible à vérifier = jamais "done" |
| Commit mélangé | Review impossible, revert dangereux |
| Pas de clear entre tâches | Pollution inter-tâches |
| Planification excessive | 10 étapes pour changer 1 ligne = overhead |
Intégration Claude Craft
/workflow:analyze — phase d'analyse BMAD doit produire des tâches atomiques/common:ralph-run — Ralph doit itérer sur des tâches atomiques, une par boucle- Agent tool — chaque tâche complexe déléguée à un subagent frais
- Rule 12 (context-management) —
/clear obligatoire entre tâches non liées
- Rule 23 (karpathy-principles) — minimal code par tâche
Ressources
- gsd-build/get-shit-done
- Rule
.claude/rules/01-workflow-analysis.md
- Rule
.claude/rules/12-context-management.md
- Command
/common:sub-agents-patterns
Date de dernière mise à jour : 2026-04-15
Version : 1.0.0
