agentleFS
TheBeardedBearSASTheBeardedBearSAS/claude-craft/.claude/skills/atomic-tasks/SKILL.md

atomic-tasks

Skill108 starsChanged 6 days agoMITView on GitHub

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.

The file

Files
SKILL.md

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).

RaisonImpact
Contexte < 30% au démarrageQualité réponses maximale
Pas de résidus de la tâche précédenteZéro confusion cross-task
Coût tokens optimiséPas de relecture inutile du contexte accumulé
ParallélisablePlusieurs 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-patternPourquoi mauvais
Kitchen-sink sessionTout faire dans 1 session = context rot garanti
Tâche non testableImpossible à vérifier = jamais "done"
Commit mélangéReview impossible, revert dangereux
Pas de clear entre tâchesPollution inter-tâches
Planification excessive10 é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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.