Communitygithub.com

AmosChenZixuan/Agentic-working-contract

Compétences d'agent que j'utilise quotidiennement.

Qu'est-ce que Agentic-working-contract ?

Cette compétence d'agent, nommée 'Razor', est un principe de conception minimaliste destiné aux développeurs et aux agents d'IA travaillant sur la création de solutions logicielles. Elle guide l'agent à travers un processus en deux étapes : d'abord, identifier le besoin réel de l'utilisateur en allant au-delà de la demande formulée, puis concevoir la solution la plus simple possible pour répondre à ce besoin. La compétence est utile car elle aide à éviter le sur-développement, la complexité inutile et l'ajout de fonctionnalités spéculatives, ce qui permet de gagner du temps et de réduire les coûts de maintenance. Elle est conçue pour être utilisée dans des environnements de développement où un agent d'IA (comme Claude Code, Cursor, ou Codex) doit générer du code ou des spécifications. Le processus inclut la reconstruction du besoin, la dérivation d'une conception minimale, la comparaison des propositions avec cette conception pour identifier le superflu, et la vérification qu'aucune fonctionnalité essentielle (comme la validation ou la sécurité) n'a été supprimée. Un modèle de sortie structuré est fourni pour documenter le besoin réel, la conception minimale, les éléments coupés comme sur-conception, et les éléments à conserver.

Compatible avec~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add AmosChenZixuan/Agentic-working-contract

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Razor

La conception correcte est la moins coûteuse qui répond totalement au besoin réel de l'utilisateur — rien de plus pour des besoins qui n'existent pas encore. Deux coupes : trouver le besoin, puis adapter la solution.

1. Trouver le vrai besoin. Ce que les gens demandent est une solution qu'ils ont déjà imaginée, pas le besoin sous-jacent — et ce qu'ils disent n'est souvent pas ce qu'ils pensent. La demande énoncée, la solution imaginée et le besoin réel sont trois choses différentes. Reconstruisez le besoin à partir des principes de base : à qui cela s'adresse-t-il, et que cherchent-ils vraiment à faire, maintenant. Vous ne pouvez pas couper contre une cible que vous n'avez pas trouvée — si ce n'est pas clair, demandez.

2. Adapter la solution (Occam). La conception correcte est le nombre minimum de pièces mobiles qui répondent à ce besoin ; chaque couche, option, abstraction ou garde supplémentaire est un coût — à construire, lire, tester, casser et modifier — à moins qu'un besoin présent ne le justifie. Pour trouver le minimum, arrêtez-vous au premier échelon qui tient :

  • Est-ce que cela doit exister ? → non : abandonnez (YAGNI).
  • Est-ce que quelque chose le résout déjà — ce code, la bibliothèque standard, une fonctionnalité de la plateforme, une dépendance installée ? → utilisez-le, ne le construisez pas.
  • Peut-on faire une chose évidente au lieu d'un système ? → faites cela.

Paresseux sur la solution, jamais sur la compréhension du problème.

Processus

  1. Reconstruisez le vrai besoin (coupe 1) ; énoncez-le en une ligne.
  2. Dérivez la conception minimale — partez de la chose la plus bête qui fonctionne, n'ajoutez que ce que le besoin impose (coupe 2).
  3. Comparez la proposition avec cette conception. Tout ce qui est en trop est un candidat à la coupe ; nommez le signal d'alarme (YAGNI, abstraction prématurée, sur-défense, réinvention, option spéculative).
  4. Ne coupez pas trop. Relisez le besoin et remettez tout ce qu'il nécessite réellement. Étroit ≠ fragile — ne coupez jamais la validation, la gestion des erreurs, la sécurité ou l'accessibilité réelles.

Sortie

Utilisez ce modèle et restez concis — un scalpel, pas un essai :

## Vrai besoin
<une ligne — ce dont l'utilisateur a vraiment besoin, pas ce qu'il a demandé>

## Conception minimale
<l'approche la plus étroite qui y répond>

## Coupe comme sur-conception
- <chose> — <signal d'alarme + pourquoi aucun besoin présent ne la justifie>

## Conserver (ne pas sur-couper)
<tout ce qui semble coupable mais qui est réellement nécessaire, pour ne pas être supprimé plus tard.
Omettre cette section si rien ne se qualifie.>

Si la conception est déjà minimale, dites-le et arrêtez-vous.

Skills associés