thebeardedbearsas/atomic-tasks

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 :

• [ ] Le test écrit passe
• [ ] L'endpoint répond avec le bon code HTTP
• [ ] Le build compile
• [ ] Le linter passe
• [ ] Le comportement utilisateur est observable

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