---
id: TheBeardedBearSAS/claude-craft/atomic-tasks
version: "6ae46904"
license: MIT
install: manual
updated: 2026-07-27
---

# atomic-tasks — atomic-tasks equips Claude Code teams with a structured framework for decomposing large projects into focused, verifiable units of work. Built around sprint workflows and continuous integration patterns, it streamlines how teams coordinate development across multiple technology stacks while maintaining code quality through integrated review and testing cycles.

Publisher: TheBeardedBearSAS · Stars: 99 · Updated: 2026-07-27

Install (manual): `git clone https://github.com/TheBeardedBearSAS/claude-craft`

## SKILL.md

# Atomic Tasks — Pattern GSD (Get Shit Done)

Pattern inspiré de [gsd-build/get-shit-done](https://github.com/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](https://github.com/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


[View on SkillFed](https://skillfed.io/TheBeardedBearSAS/claude-craft/atomic-tasks) · [View on GitHub](https://github.com/TheBeardedBearSAS/claude-craft)