Grill with Docs (Claude Code skill)
Variante musclée de Grill Me. /grill-with-docs lance une session de cadrage qui ne se contente pas de poser des questions : elle confronte ton plan au glossaire métier (CONTEXT.md), à tes décisions documentées (ADRs), et au code existant. Quand tu emploies un terme flou ou qui contredit le glossaire, la skill stoppe net : « ton glossaire dit X, mais tu décris Y, c'est lequel ? » Met à jour CONTEXT.md et propose un ADR uniquement quand 3 conditions sont réunies (décision difficile à inverser, surprenante sans contexte, vrai trade-off).
Forces
- Confronte la spec au glossaire métier existant, révèle les conflits de vocabulaire avant le code
- Update CONTEXT.md inline pendant la session, pas en post-mortem
- Cadre l'usage des ADRs : 3 conditions strictes, sinon skip, anti-bloat documentation
- Cross-référence avec le code : si tu dis « on annule l'order entier » mais que le code permet l'annulation partielle, la skill le surface
Limites
- Friction réelle : la session prend 30-60 min pour une feature non-triviale
- Inutile sans CONTEXT.md ni ADRs préexistants, le superpouvoir vient de l'historique documenté
- Plus opinionated que /grill-me, peut frustrer les équipes qui veulent juste démarrer
Pour qui
- Équipes DDD qui maintiennent un CONTEXT.md vivant et veulent que Claude le respecte
- Devs seniors qui ont déjà 10+ ADRs et veulent éviter de re-débattre les décisions actées
- Architectes qui veulent industrialiser la discipline glossaire+ADR sans la documenter à la main