Communitygithub.com

leonhoffmann86/team-sprint

🏃 Sprint — chaque tâche TODO reçoit un mini-sprint complet : planification→implémentation→revue autonome pour Claude Code via une chaîne d'agents git-hook, worktree isolé, porte déterministe et revue à échec fermé

Qu'est-ce que team-sprint ?

Cette compétence transforme une idée brute en une tâche bien structurée dans `TODO.md`, prête à être exécutée par une chaîne d'agents autonome. Elle ne fait jamais d'implémentation elle-même : son rôle est le raffinement. Elle débute par la lecture de la constitution du projet (AGENTS.md, CLAUDE.md, sprint.conf) pour comprendre les conventions, notamment les niveaux de risque et les règles de cycle de vie des TODO. Ensuite, elle ancre l'idée dans le code réel en utilisant de préférence le graphe de code (MCP) ou en recourant à Grep/Glob, puis interroge l'idée pour en cerner la portée réelle, détecter les décisions produit qui incombent à l'humain, et évaluer le niveau de risque. Enfin, elle rédige un item structuré avec un impératif clair, un critère de complétude concret et des indications de fichiers/fonctions, et l'écrit dans `TODO.md` avant de proposer à l'utilisateur de lancer la chaîne complète en commitant le fichier. La compétence est conçue pour Claude Code et s'appuie sur un mécanisme de git-hooks et de worktrees isolés pour garantir que chaque tâche est exécutée dans un espace déterministe et sécurisé, avec une revue à échec fermé qui empêche toute fusion non validée.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add leonhoffmann86/team-sprint

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Vous transformez une idée brute en une tâche bien formée dans TODO.md. L'idée brute :

$ARGUMENTS

Ceci est un workflow de raffinement, pas d'implémentation. N'écrivez pas de code. N'écrivez pas dans TODO.md tant que la tâche n'est pas claire et que l'utilisateur ne l'a pas approuvée. Travaillez en ces étapes :

1. Lire la constitution

Trouvez les fichiers de constitution du projet et lisez-les — respectez leurs conventions, en particulier les niveaux de risque et toute règle concernant les agents autonomes / le cycle de vie des TODO.

  • Si sprint.conf existe, lisez les fichiers listés dans SPRINT_CONSTITUTION_FILES (dans l'ordre).
  • Sinon, lisez les fichiers AGENTS.md, CLAUDE.md qui existent (ainsi que tout guide spécifique au projet qu'ils référencent, par exemple un CLAUDE.md frontend).
  • Parcourez .githooks/README.md s'il est présent, afin de décrire correctement l'effet en aval. Si aucun de ces fichiers n'existe, indiquez à l'utilisateur que le dépôt n'est pas encore amorcé et proposez /sprint:bootstrap.

2. Ancrer l'idée dans le code réel (ne pas deviner)

Trouvez les symboles/fichiers réels que l'idée touche et son rayon d'impact :

  • Graphe de code (recommandé, s'il est disponible) : les outils mcp__codegraph__* (codegraph_search, …_callers, …_callees, …_impact, …_context), ou la CLI (codegraph context "<l'idée>", codegraph callers <symbole>, codegraph impact <symbole>) ; exécutez codegraph sync . d'abord si l'index semble obsolète.
  • Solution de repli (pas de graphe de code) : utilisez Grep/Glob pour localiser les symboles pertinents et leurs appelants. Lisez les quelques fichiers qui comptent vraiment. Nommez les fonctions/fichiers concrets et l'endroit où la modification atterrit.

3. L'interroger (le cœur de cette compétence)

Confrontez l'idée à ce que le code fait déjà. Faites émerger :

  • S'agit-il d'une question ou d'une tâche ? S'il s'agit vraiment d'une question ("…ou est-ce que j'ai oublié quelque chose ?"), répondez-y d'abord à partir du code — la logique existante peut déjà en couvrir une partie.
  • La portée réelle et le plus petit changement qui apporte de la valeur.
  • Le niveau de risque (selon la constitution / AGENTS.md). S'il est élevé, dites-le — il ne sera pas implémenté automatiquement ; la chaîne le délègue à un humain.
  • Les décisions qui appartiennent à l'utilisateur, pas à vous (choix produit/UX/politique). Posez ces quelques décisions à l'utilisateur avec AskUserQuestion. N'inventez pas de réponses à de véritables choix produit ; corrigez les hypothèses erronées à l'aide de preuves issues de la base de code.

4. Rédiger UN item structuré (les quatre ingrédients)

Rédigez un projet avec :

  1. une tâche impérative claire (pas de question),
  2. le niveau de risque,
  3. un critère de complétude concret (quel test ciblé doit passer / quel comportement est vérifiable),
  4. des indications de fichiers/fonctions issues de l'étape 2. Limitez-vous au plus petit changement utile. Montrez le projet et affinez-le jusqu'à ce que l'utilisateur soit satisfait.

5. L'écrire dans TODO.md, puis passer la main

  • Ajoutez l'élément approuvé sous forme d'entrée - [ ] près du sommet de TODO.md.
  • Demandez s'il faut en faire l'élément actif unique — si oui, déplacez les autres éléments actifs dans un bloc <!-- … --> (ou sous ## 🚧 Reporté) selon la convention de saut, afin que la chaîne ne prenne que celui-ci.
  • Ne commitez pas automatiquement. Dites à l'utilisateur : commiter TODO.md démarre la chaîne planification→implémentation→revue (l'implémentation atterrit sur la branche d'implémentation, rien n'est fusionné automatiquement). Proposez de commiter s'il souhaite que le processus commence maintenant.

Gardez le dialogue serré : ancrez d'abord, ne posez que les décisions qui comptent, puis rédigez.

Skills associés