Our review
Implements a feature by following a pre-established development plan, with automatic quality checks (PHPStan, PSR-12 formatting).
Strengths
- Ensures adherence to the plan and project conventions
- Automates quality checks (PHPStan level 9) and PSR-12 formatting after each edit
- Integrates TDD approach for unit test creation
Limitations
- Requires an existing plan generated by a previous phase (e.g., /dev:plan)
- Quality checks depend on the presence of tools like PHPStan or php-cs-fixer in the project
- Automatic hooks only cover PHP files
When you have a detailed plan and want to implement a feature step-by-step with built-in quality controls.
For simple or exploratory tasks that don't need a formal plan, or if the project doesn't use PHP.
Security analysis
SafeThe skill uses Bash hooks to run linters and formatters (PHPStan, php-cs-fixer) on PHP files, which are legitimate development quality tools. There are no destructive commands, no exfiltration, and no obfuscated payloads. The workflow instructs the agent to implement code according to a plan, which is within the agent's normal operation.
No concerns found
Examples
/dev:code path/to/plan.md/dev:codeContinue with Phase 5: implement the feature according to the plan we created earlier.name: dev:code description: Implémenter selon le plan (Phase 5) argument-hint: [path-to-plan] model: sonnet allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, TaskCreate, TaskUpdate, TaskList] version: 1.0.0 license: MIT hooks: PreToolUse: - matcher: "Read" hooks: - type: command command: | # Hook 3: Vérifier qu'on a un plan à suivre if [ -f ".claude/data/.dev-workflow-state.json" ]; then PLAN_PATH=$(jq -r '.planPath // empty' .claude/data/.dev-workflow-state.json 2>/dev/null || echo "") if [ -z "$PLAN_PATH" ] || [ ! -f "$PLAN_PATH" ]; then echo "❌ ERREUR : Aucun plan trouvé" echo "Lance d'abord : /dev:plan" exit 1 fi fi once: true PostToolUse: - matcher: "Edit" hooks: - type: command command: | # Hook 1: PHPStan après chaque Edit (fichiers PHP uniquement) FILE=$(echo "$CLAUDE_TOOL_ARGS" | grep -oP '(?<=file_path: ).*?(?=,|$)' || echo "")
if [ -n "$FILE" ] && [[ "$FILE" == *.php ]]; then
echo "🔍 Vérification PHPStan de $FILE..."
if [ -f "Makefile" ] && grep -q "^phpstan:" Makefile; then
make phpstan FILES="$FILE" 2>/dev/null || vendor/bin/phpstan analyse "$FILE" --level=9 --no-progress 2>/dev/null || echo "⚠️ PHPStan non disponible"
elif [ -f "vendor/bin/phpstan" ]; then
vendor/bin/phpstan analyse "$FILE" --level=9 --no-progress || {
echo "⚠️ Erreurs PHPStan détectées dans $FILE"
echo "Corrige-les avant de continuer"
}
fi
fi
once: false
- matcher: "Write"
hooks:
- type: command
command: |
# Hook 2: Auto-format après Write (fichiers PHP uniquement)
FILE=$(echo "$CLAUDE_TOOL_ARGS" | grep -oP '(?<=file_path: ).*?(?=,|$)' || echo "")
if [ -n "$FILE" ] && [[ "$FILE" == *.php ]] && [ -f "$FILE" ]; then
echo "🎨 Auto-formatage PSR-12 de $FILE..."
if [ -f "vendor/bin/php-cs-fixer" ]; then
vendor/bin/php-cs-fixer fix "$FILE" --rules=@PSR12 --quiet 2>/dev/null && echo "✅ Formaté : $FILE" || echo "⚠️ Formatage ignoré"
elif [ -f "Makefile" ] && grep -q "^fix:" Makefile; then
make fix FILES="$FILE" 2>/dev/null || echo "⚠️ Formatage ignoré"
fi
fi
once: false
Objectif
Phase 5 du workflow de développement : implémenter la feature selon le plan généré.
Variables
PATH_TO_PLAN: $ARGUMENTS
Instructions à Exécuter
IMPORTANT : Exécute ce workflow étape par étape :
1. Vérifier le contexte et charger le plan
- Extrais PATH_TO_PLAN depuis $ARGUMENTS
- Si PATH_TO_PLAN n'est pas fourni :
- Lis
.claude/data/.dev-workflow-state.jsonavec Read - Extrais
planPathdu JSON
- Lis
- Si toujours pas de plan, affiche une erreur et arrête
2. Demander approbation avant implémentation
⚠️ CRITIQUE : Ne PAS commencer l'implémentation sans approbation explicite.
Attendre confirmation avant de continuer.
3. Lire le plan
- Lire le fichier plan complet
- Extraire les étapes d'implémentation
- Identifier les fichiers à créer/modifier
4. Implémenter étape par étape
Pour chaque étape du plan :
- Créer une todo pour l'étape
- Lire les fichiers concernés (si modification)
- Implémenter le code
- Respecter :
- Les conventions du projet (CLAUDE.md)
- Les patterns identifiés dans l'exploration
- Les décisions prises en phase 2
- Marquer la todo comme complétée
5. Créer les tests
- Créer les tests unitaires spécifiés dans le plan
- Suivre l'approche TDD si possible
- S'assurer que les tests passent
6. Vérifications qualité
Lancer les vérifications :
make phpstan # PHPStan niveau 9
make fix # Formatage PSR-12
⚠️ Corriger TOUTES les erreurs PHPStan avant de continuer.
7. Mettre à jour le workflow state
8. Rapport
Règles
- Approbation obligatoire avant de commencer
- PHPStan = 0 erreurs (bloquant CI)
- Respecter le plan (pas d'improvisation)
- Tests pour chaque composant
- Conventions françaises pour les variables et documentation
Next.js App Router Expert
Development
A skill that turns Claude into a Next.js App Router expert.
README Generator
Development
Creates professional and comprehensive README.md files for your projects.
API Documentation Writer
Development
Generates comprehensive API documentation in OpenAPI/Swagger format.