Demandez à Matt
Vous ne vous souvenez pas de chaque compétence, alors demandez.
Un flux est un chemin à travers les compétences. La plupart des chemins suivent un flux principal, et deux voies d'accès le rejoignent. Tout le reste est autonome, ou une couche de vocabulaire qui s'exécute en dessous.
Le flux principal : idée → livraison
Le chemin que la plupart des travaux empruntent. Vous avez une idée et vous voulez la construire.
-
/grill-with-docs— affinez l'idée par entretien. Commencez ici quand vous avez une base de code : elle est avec état, conservant ce qu'elle apprend dansCONTEXT.mdet les ADR. (Pas de base de code ? Utilisez/grill-me— voir Autonome. Les deux exécutent la même primitive/grilling;grill-with-docsest celle qui laisse une trace écrite.) -
Embranchement — pouvez-vous régler chaque question par la conversation ? Si une question nécessite une réponse exécutable (état, logique métier, une UI que vous devez voir), faites un détour par un prototype, ponté par
/handoffdans les deux sens (voir Sessions croisées) :/handoffsortir, puis ouvrez une nouvelle session sur ce fichier,/prototypepour répondre à la question avec du code jetable,/handoffrevenir avec ce que vous avez appris, et référencez-le depuis le fil de discussion de l'idée originale.
-
Embranchement — s'agit-il d'une construction multi-sessions ?
- Oui →
/to-prd(transformez le fil de discussion en PRD) →/to-issues(divisez la PRD en issues pouvant être prises indépendamment). Comme les issues sont indépendantes, effacez le contexte entre chacune d'elles : démarrez une session fraîche par issue et lancez/implementen lui passant la PRD et l'issue unique à traiter. - Non →
/implementici même, dans la même fenêtre de contexte.
Dans les deux cas,
/implementconstruit chaque issue en pilotant/tdden interne — une tranche rouge-vert à la fois — puis se termine en exécutant/code-review, une revue à deux axes (Normes + Spécifications) du diff, avant de commiter. Utilisez/tddseul quand vous voulez juste construire un comportement concret en test-first sans spécification complète, et/code-reviewseul quand vous voulez passer en revue une branche ou une PR par rapport à un point de référence. - Oui →
Hygiène du contexte
Gardez les étapes 1 à 3 dans une même fenêtre de contexte ininterrompue — ne compactez pas et n'effacez pas avant /to-issues — pour que le grilling, la PRD, et les issues soient tous bâtis sur la même réflexion. Chaque /implement démarre ensuite frais, en travaillant à partir de l'issue.
La limite est la zone intelligente : la fenêtre (~120k tokens sur les modèles de pointe) dans laquelle le modèle raisonne encore nettement. Si une session s'en approche avant /to-issues, ne poussez pas sur un modèle dégradé — faites /handoff et continuez dans un nouveau fil.
Voies d'accès
Une situation de départ qui génère du travail, puis rejoint le flux principal.
-
Les bugs et demandes s'accumulent →
/triage. Il déplace les issues à travers les rôles de triage et produit des issues prêtes pour l'agent, que/implementreprendra plus tard.Le triage est uniquement pour les issues que vous n'avez pas créées — rapports de bugs, demandes de fonctionnalités entrantes, tout ce qui arrive brut. Les issues que
/to-issuesa produites sont déjà prêtes pour l'agent, donc ne les triez pas. -
Quelque chose est cassé →
/diagnosing-bugs. Pour les cas difficiles : le bug qui résiste à un premier coup d'œil, l'instabilité intermittente, la régression qui s'est glissée entre deux états connus comme bons. Il refuse de théoriser avant d'avoir une boucle de rétroaction serrée — une commande qui est déjà rouge sur ce bug — puis corrige avec un test de régression. Son débriefing passe à/improve-codebase-architecturequand la vraie découverte est qu'il n'y a pas de bon point de coupure pour verrouiller le bug.
Santé de la base de code
Pas du travail sur les fonctionnalités — de l'entretien.
/improve-codebase-architecture— exécutez dès que vous avez un moment libre pour garder la base de code propice au travail des agents. Il fait remonter des opportunités d'approfondissement ; en choisir une génère une idée que vous pouvez emmener dans le flux principal à/grill-with-docs. C'est l'étude qui trouve les candidats ;/codebase-design(ci-dessous) est l'établi sur lequel vous concevez celui que vous avez choisi.
Vocabulaire sous-jacent
Deux références invoquées par le modèle qui s'exécutent en dessous des autres compétences — chacune est la source unique de vérité pour son vocabulaire. Utilisez-les directement quand ce sont les mots, pas le processus, qui posent problème ; ou laissez les compétences ci-dessus les invoquer.
/domain-modeling— affinez le langage domaine du projet : défiez un terme flou, résolvez un mot surchargé ("compte" faisant trois jobs), enregistrez une décision difficile à revenir en arrière comme un ADR. C'est la discipline active que/grill-with-docspilote pour maintenirCONTEXT.mdcomme un glossaire propre./codebase-design— le vocabulaire des modules profonds (module, interface, profondeur, point de coupure, adaptateur, levier, localité) pour concevoir la forme d'un module : beaucoup de comportement derrière une petite interface à un point de coupure propre./tddet/improve-codebase-architectureparlent tous deux ce langage.
Sessions croisées
/handoff— quand un fil de discussion est plein ou que vous devez bifurquer (par exemple dans une session/prototype), cela compacte la conversation en un fichier Markdown. Vous ne continuez pas sur place — vous ouvrez une nouvelle session et référencez ce fichier pour transporter le contexte. C'est le pont entre les fenêtres de contexte, dans les deux sens. Utilisez-le quand vous voulez une session fraîche mais que vous devez préserver la conversation actuelle./compact(intégré) — restez dans la même conversation, en laissant les tours précédents être résumés. Utilisez-le lors de pauses intentionnelles entre les phases, quand cela ne vous dérange pas de perdre l'historique textuel. Ne compactez pas en milieu de phase — l'agent pourrait perdre le fil./handoffbifurque ;/compactcontinue.
Autonomes
Hors du flux principal.
/grill-me— le même entretien acharné que/grill-with-docs, mais pour quand vous n'avez pas de base de code. Sans état : il ne sauvegarde rien localement, ne construit pas deCONTEXT.md. Utilisez-le pour affiner tout plan ou conception qui ne vit pas dans un dépôt./prototype— un petit programme jetable qui répond à une question de conception : ce modèle d'état semble-t-il correct, ou à quoi devrait ressembler cette UI. Jetable dès le premier jour — gardez la réponse, supprimez le code. C'est le détour à l'étape 2 du flux principal, mais utilisez-le à tout moment quand une question de conception est difficile à trancher sur le papier./research— déléguez la lecture de fond à un agent d'arrière-plan : il étudie une question à partir de sources primaires, puis laisse un fichier Markdown cité dans le dépôt. Continuez à travailler pendant qu'il lit. Le fichier qu'il produit est quelque chose à emmener dans le flux principal à/grill-with-docs— la recherche alimente la réflexion, elle ne la remplace pas./teach— apprenez un concept sur plusieurs sessions, en utilisant le répertoire courant comme espace de travail avec état./writing-great-skills— référence pour écrire et éditer des compétences efficacement.
Précondition
/setup-matt-pocock-skills — exécutez avant votre premier flux d'ingénierie pour configurer le gestionnaire d'issues, les étiquettes de triage et la disposition des documents que les autres compétences supposent. Les gestionnaires d'issues personnalisés fonctionnent également.