Implémenter une feature avec Task Runner et feature-dev

Contexte

Task Runner orchestre l’implémentation des tâches de docs/todo.md une par une. Pour les features M/L/XL, il s’intègre avec le plugin officiel feature-dev d’Anthropic qui propose un workflow structuré en 7 phases : define, plan, build, verify, review, ship, orchestrate. Ce workflow garantit une implémentation sans détours.

Prérequis

• Plugin feature-dev installé dans Claude Code
• docs/todo.md bien formé avec tâches claires
• Git configuré
• Suite de tests fonctionnelle

Étapes

1. Charger la prochaine tâche

/ulk:task-runner

Task Runner affiche :

=== État du projet ===

📊 Progression globale : 12/28 tâches (42%)

🔴 P0 - Bloquant    : 3 tâches — 1 faite
🟠 P1 - Critique    : 5 tâches — 2 faites
🟡 P2 - Important   : 8 tâches — 4 faites
🟢 P3 - Nice-to-have: 12 tâches — 5 faites

⏳ En cours actuellement : 
   #12 - Ajouter authentification OAuth

=== Prochaine tâche recommandée ===

#15 · Feature [Créer dashboard utilisateur]
Priorité   : P1
Estimation : 5h
Dépendances: #12 (OAuth) — DONE ✓
Débloque   : #16, #18, #22

2. Lancer le workflow feature-dev

Pour une feature M/L/XL, utilise le plugin :

/feature-dev "#15 - Créer dashboard utilisateur"

Le plugin proposera une structure en 7 phases automatiques.

3. Suivre les 7 phases

Phase 1 (Define) — Définition du besoin

Acceptation critères: 
- User voit ses stats
- Widgets personnalisables
- Real-time updates

Phase 2 (Plan) — Architecture et estimation

Stack : React + TanStack Query + WebSocket
Fichiers à créer: 4
Dépendances: @tanstack/react-query (already installed)
Temps estimé: 4-5h

Phase 3 (Build) — Implémentation

# Task Runner crée les fichiers
# Implémente les composants
# Ajoute les tests unitaires

Phase 4 (Verify) — Tests

npm test -- dashboard.test.ts
# ✓ 12 tests passed

Phase 5 (Review) — Révision du code

/pr-review-toolkit:review-pr
# Detecte bugs, types, coverage

Phase 6 (Ship) — Déploiement

git push origin feature/dashboard
gh pr create --title "feat: dashboard utilisateur"

Phase 7 (Orchestrate) — Mise à jour docs

# docs/todo.md marquée complète
# docs/spec.md mise à jour
# CLAUDE.md enrichi du contexte

4. Mettre à jour la todo

Une fois complétée, Task Runner marque la tâche :

# docs/todo.md
- [x] #15 - Créer dashboard utilisateur [2026-04-14]

5. Passer à la tâche suivante

/ulk:task-runner

Task Runner affiche la nouvelle prochaine tâche.

Exemple de sortie

✅ Feature complétée

#15 - Créer dashboard utilisateur
  Temps réel: 4h 23m
  Tests: ✓ 12 passed
  Coverage: 85%
  Review: ✓ Approuvé
  PR: #342 (merged)

🎯 Prochaine tâche recommandée:
  #16 - Intégrer analytics au dashboard (P1, 3h)

Variantes

• Batch mode : Exécuter 10+ tâches P0+P1 en autonome avec /batch
• Feature fast-track : Sauter la phase Review si urgent
• Manual override : Forcer une tâche spécifique avec task-runner #42

Agents enchaînés

Flux typique :

• Task Runner (04) phase build → Robocop (11) si tests échouent
• Task Runner (04) phase review → 2b3 (08) checkpoint
• Task Runner (04) phase ship → Blackemperor (18) mode=release pour PR

Batch mode - Exécution autonome

Pour exécuter toutes les P0+P1 de manière autonome :

/batch "Exécute les tâches P0 puis P1 de docs/todo.md une par une : lire la tâche, lancer feature-dev, tester, commiter, passer à la suivante"

Robuste pour plusieurs heures de travail autonome.

Troubleshooting

Symptôme	Cause probable	Résolution
Dépendance non résolue	#12 non complétée	Marquer #12 en cours ou sauter la tâche
Tests qui échouent	Code incomplet	Lancer /batch ou appeler Robocop
feature-dev non trouvé	Plugin non installé	Installer via marketplace Claude Code

Voir aussi

• 26-2b3-checkpoint.md — Checkpoint après feature
• 27-robocop-errorfix.md — Fix les tests en échec
• 25-godspeed-diagnostic.md — État initial avant feature