Lev-it/lev-skills

Demande à Matt

Tu ne te souviens pas de chaque compétence, alors demande.

Un flux est un chemin à travers les compétences. La plupart des chemins suivent un flux principal, et deux voies d'accès s'y rejoignent. Tout le reste est autonome.

Le flux principal : idée → déploiement

Le chemin qu'emprunte la plupart du travail. Tu as une idée et tu veux la construire.

1. /grill-with-docs — affine l'idée par un entretien. Commence ici quand tu as une base de code : il est avec état, conservant ce qu'il apprend dans CONTEXT.md et les ADR. (Pas de base de code ? Utilise /grill-me — voir Autonome.)
2. Branchement — peux-tu répondre à chaque question en conversation ? Si une question nécessite une réponse exécutable (état, logique métier, une interface que tu dois voir), fais un détour par un prototype, relié par /handoff dans les deux sens (voir Sessions croisées) :
   • /handoff sortir, puis ouvre une nouvelle session pointant vers ce fichier,
   • /prototype pour répondre à la question avec du code jetable,
   • /handoff revenir avec ce que tu as appris, et référence-le dans le fil d'idée original.
3. Branchement — est-ce une construction multi-session ?
   • Oui → /to-prd (transforme le fil en un PRD) → /to-issues (découpe le PRD en issues indépendantes). Comme les issues sont indépendantes, efface le contexte entre chacune : démarre une nouvelle session par issue et lance /implement en lui passant le PRD et l'issue unique à traiter.
   • Non → /implement ici, dans la même fenêtre de contexte.

Hygiène du contexte

Garde les étapes 1 à 3 dans une seule fenêtre de contexte ininterrompue — ne compacte pas et n'efface pas avant la fin de /to-issues — afin que le questionnement, le PRD et les issues reposent tous sur la même réflexion. Chaque /implement démarre ensuite sur une base vierge, à 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 avec acuité. Si une session s'en approche avant /to-issues, ne continue pas en mode dégradé — utilise /handoff et continue 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 les 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 /implement prendra en charge plus tard.

  Le triage est uniquement pour les issues que tu n'as pas créées — rapports de bugs, demandes de fonctionnalités entrantes, tout ce qui arrive brut. Les issues produites par /to-issues sont déjà prêtes pour l'agent, donc ne les trie pas.

Santé de la base de code

Pas du travail sur les fonctionnalités — de la maintenance.

• /improve-codebase-architecture — exécute-le chaque fois que tu as un moment libre pour garder la base de code en bon état pour que les agents puissent y opérer. Il met en évidence des opportunités d'approfondissement ; en choisir une génère une idée que tu peux apporter dans le flux principal via /grill-with-docs.

Sessions croisées

• /handoff — quand un fil est plein ou que tu dois bifurquer (par exemple vers une session /prototype), il condense la conversation dans un fichier markdown. Tu ne continues pas sur place — tu ouvres une nouvelle session et références ce fichier pour transporter le contexte. C'est le pont entre les fenêtres de contexte, dans les deux sens. Utilise-le quand tu veux une session fraîche mais que tu as besoin que la conversation actuelle soit préservée.
• /compact (intégré) — reste dans la même conversation, en laissant résumer les échanges précédents. Utilise-le lors des pauses intentionnelles entre les phases, quand cela ne te dérange pas de perdre l'historique textuel. Ne compacte pas en milieu de phase — l'agent pourrait perdre le fil. /handoff bifurque ; /compact continue.

Autonome

Hors du flux principal.

• /grill-me — le même entretien impitoyable que /grill-with-docs, mais pour quand tu n'as pas de base de code. Sans état : il ne sauvegarde rien localement, ne construit pas de CONTEXT.md. Utilise-le pour affiner tout plan ou conception qui ne vit pas dans un dépôt.
• /teach — apprends un concept sur plusieurs sessions, en utilisant le répertoire courant comme espace de travail avec état.
• /writing-great-skills — référence pour bien écrire et modifier les compétences.

Précondition

/setup-matt-pocock-skills — exécute-le avant ton premier flux d'ingénierie pour configurer le suivi des issues, les étiquettes de triage et la disposition des documents que les autres compétences supposent. Les gestionnaires d'issues personnalisés fonctionnent aussi.