icpg

Vue d’ensemble de la compétence icpg

Ce que fait la compétence icpg

La compétence icpg ajoute une couche « WHY » à la compréhension du code. Au lieu de se limiter à cartographier la structure, elle relie les fonctions, les classes et les modules à la raison de leur existence, à leur propriétaire, et à la question de savoir s’ils correspondent encore à leur intention d’origine. Si vous avez besoin de icpg pour la code review, pour un refactoring ou pour de la maintenance autonome, sa valeur principale est de réduire l’approximation avant une modification de code.

Pour qui c’est le plus adapté

icpg convient aux ingénieurs et aux agents qui travaillent dans des bases de code actives, où le comportement, la propriété et l’intention de conception comptent davantage qu’un simple balayage syntaxique. Il est particulièrement utile quand un dépôt a accumulé de la dérive, que l’historique des tâches est flou ou que reviennent sans cesse des questions du type « pourquoi ce code a-t-il été écrit ? ».

Ce qui le distingue

La compétence s’appuie sur les ReasonNodes, les contrats formels et la détection de dérive sur plusieurs dimensions. Autrement dit, icpg n’est pas seulement une carte du code ; c’est une couche d’aide à la décision pour l’analyse avant tâche. Concrètement, cela améliore la sécurité des changements, clarifie le contexte de review et réduit les modifications qui enfreignent silencieusement l’intention initiale.

Comment utiliser la compétence icpg

Installer et repérer le fichier central

Utilisez le flux d’installation de la compétence du dépôt, puis commencez par skills/icpg/SKILL.md. Comme ce dépôt n’expose ni scripts d’aide ni dossiers de support, le fichier de compétence est la principale source de vérité. Pour décider rapidement si l’installation vaut le coup, lisez le frontmatter et les premières sections avant tout le reste.

Transformer un objectif vague en prompt exploitable

icpg usage donne les meilleurs résultats si vous fournissez une tâche précise, un chemin cible et la forme de sortie attendue. De bons exemples ressemblent à ceci : « Review src/payments/charge.ts for intent drift before I change retry logic » ou « Bootstrap ReasonNodes for the auth flow and identify missing ownership links. » Des demandes faibles comme « analyze this repo » restent trop larges et passent généralement à côté de la force de icpg, qui est le suivi d’intention.

Workflow conseillé pour une première utilisation

Commencez par demander quelle est la finalité prévue du code cible, puis demandez quelles contraintes ou quels contrats le protègent, puis cherchez où la dérive est probable. Cette séquence correspond à la conception de la compétence et aide l’agent à passer de la structure à l’intention, puis au risque. Pour les workflows icpg guide, gardez la demande centrée sur un seul module ou un seul jeu de modifications plutôt que sur tout le dépôt.

Ce qu’il faut lire en premier dans le dépôt

Commencez par SKILL.md, en particulier l’énoncé d’objectif, les exemples CLI, ainsi que les sections sur le principe central, les requêtes canoniques avant tâche, ReasonNode et les types d’arêtes. Ce sont les éléments les plus susceptibles d’influencer la décision d’adoption et la qualité des sorties icpg pour la code review.

FAQ sur la compétence icpg

icpg est-il réservé aux agents autonomes ?

Non. icpg est utile aux humains comme aux agents, mais il est particulièrement convaincant lorsqu’un système a besoin d’un raisonnement reproductible avant tâche. Si vous voulez seulement un résumé ponctuel, un prompt classique peut suffire ; si vous cherchez une code review sensible à l’intention ou une préparation de changement, icpg est un meilleur choix.

En quoi icpg diffère-t-il d’un prompt générique sur le code ?

Un prompt générique peut résumer le code, mais icpg est conçu pour préserver l’intention, la propriété et le contexte de dérive d’une tâche à l’autre. Il est donc plus utile quand il faut répondre à « à quoi sert ce code ? » avant de le modifier, et pas seulement à « que fait ce code ? ».

icpg est-il adapté aux débutants ?

Oui, il peut être utilisé par des débutants, mais les meilleurs résultats viennent d’utilisateurs capables de nommer précisément un fichier, une fonctionnalité ou une frontière de changement. Si vous découvrez le dépôt, commencez par un seul module et demandez son intention, ses contraintes et ses risques de review plutôt qu’une analyse de tout le système.

Dans quels cas ne faut-il pas utiliser icpg ?

Évitez icpg quand la tâche est triviale, que le code est isolé ou que vous n’avez besoin que d’une explication rapide et superficielle. Ce n’est pas non plus un bon choix si vous ne pouvez fournir ni zone cible ni contexte de changement, car la valeur de la compétence dépend du lien entre le code et une raison précise d’exister.

Comment améliorer la compétence icpg

Donner un contexte de tâche plus solide

Les meilleurs résultats icpg viennent de prompts qui précisent l’objectif du changement, les fichiers concernés et ce qui ne doit surtout pas casser. Par exemple, « review src/billing for drift after the new tax rule » est plus fort que « check billing code ». Cela aide la compétence à faire ressortir les bons ReasonNodes et les bonnes contraintes pour icpg for Code Review.

Demander l’intention avant l’implémentation

Un mode d’échec fréquent consiste à passer directement aux modifications sans demander d’abord ce que le code était censé protéger. Améliorez la sortie en demandant d’abord la finalité d’origine, le contrat actuel et la dérive suspectée, puis seulement le plan de changement. Cet ordre réduit les régressions évitables et rend la review plus digne de confiance.

Utiliser la première réponse pour affiner la seconde

Si la première passe est trop large, resserrez le périmètre par module, étape de workflow ou frontière de propriété. Si la réponse est trop superficielle, demandez le contrat manquant, la dimension de dérive la plus probable ou la requête canonique avant tâche la mieux adaptée au besoin. Itérer de cette manière améliore généralement le signal plus qu’une simple demande de réponse plus longue.

Rester aligné avec la conception de la compétence

La compétence icpg est la plus forte lorsqu’on lui demande du suivi de raisons, de la détection de dérive et de l’analyse avant tâche, pas seulement une explication du code. Si vous voulez de meilleurs résultats avec icpg usage, indiquez ce que signifie « terminé », le type de changement envisagé et la partie de la base de code concernée.