/apex

10 steps principal

Le skill principal du framework. APEX (Analyze-Plan-Execute-eXamine) est une méthodologie systématique pour implémenter n'importe quel changement de code.

Quand l'utiliser

• Features de toute taille
• Corrections de bugs complexes
• Refactoring important
• Tout changement nécessitant de la structure

Usage

/apex implement user registration
/apex -a -s fix login timeout bug
/apex -x -t add payment integration
/apex -r 01-auth-middleware     # reprendre

Flags

Flag	Description
-a	Auto — sauter les confirmations
-x	Examine — review adversariale au step 6
-s	Save — sauvegarder dans docs/apex/
-t	Test — inclure steps 8-9 (tests)
-e	Economy — pas de subagents
-r	Resume — reprendre une tâche précédente
-i	Interactive — configurer les flags

Pipeline

01 Init → 02 Analyze → 03 Plan → 04 Execute → 05 Validate
                                                    ↓
                        09 Run Tests ← 08 Tests ← 07 Resolve ← 06 Examine
                            ↓
                        10 Finish

Steps détaillés

Step 01 — Init

Établir le contexte : lire les fichiers pertinents, comprendre le scope.

Step 02 — Analyze

Analyser le problème en profondeur. Identifier les contraintes, dépendances, edge cases.

Step 03 — Plan

Créer un plan d'exécution détaillé : fichiers à modifier, ordre des opérations, risques.

Step 04 — Execute

Implémenter le plan. Code de production + documentation inline.

Step 05 — Validate

Vérifier que l'implémentation compile, que les tests passent, que le comportement est correct.

Step 06 — Examine (flag -x)

Review adversariale : chercher activement les failles, bugs, edge cases manqués.

Step 07 — Resolve

Corriger les problèmes trouvés par l'examen.

Step 08 — Tests (flag -t)

Écrire les tests unitaires et d'intégration.

Step 09 — Run Tests (flag -t)

Exécuter les tests et corriger les échecs.

Step 10 — Finish

Résumé final : ce qui a été fait, fichiers modifiés, décisions prises.

Outputs (flag -s)

docs/apex/{task-id}/
├── context.md      ← Step 01
├── analysis.md     ← Step 02
├── plan.md         ← Step 03
├── validation.md   ← Step 05
├── examination.md  ← Step 06
└── summary.md      ← Step 10