Configurer votre agent de codage

agentee est conçu pour être piloté par un agent de codage : Claude Code, Codex, Cursor, pi ou tout autre outil capable d'exécuter des commandes shell et de modifier des fichiers. Il y a deux éléments à configurer. La skill indique à l'agent comment travailler. Le serveur MCP est optionnel et offre aux clients qui parlent MCP les mêmes opérations sous forme d'outils.

#Installer la skill

Une skill est un fichier SKILL.md que l'agent charge lorsqu'une tâche correspond à sa description. La skill agentee couvre la boucle de modification, de vérification et de rendu, l'ordre pour construire un design, les pièges du format de fichier, la manière de placer pour l'assemblage et le test, et comment itérer sur les simulations sans gaspiller des heures de GPU.

La méthode la plus rapide est l'installateur de skills, qui détecte les agents sur votre machine et place le fichier là où chacun le cherche :

npx skills add https://agentee.sh

Il lit le registre de skills publié par agentee.sh à l'adresse /.well-known/agent-skills/index.json, qui liste la skill avec un digest SHA-256 de son fichier. npx skills add v0l/agentee installe la même skill depuis le dépôt GitHub à la place.

Pour installer manuellement, placez le fichier dans le dossier de skills de votre agent. Pour Claude Code :

mkdir -p ~/.claude/skills/agentee
curl -fsSL https://agentee.sh/.well-known/agent-skills/agentee/SKILL.md -o ~/.claude/skills/agentee/SKILL.md

Chaque archive de version contient également la skill sous skills/agentee, correspondant au binaire à côté. Si vous compilez depuis un clone, liez ce dossier à votre dossier de skills pour que la skill se mette à jour avec le code.

#Ajouter le serveur MCP

Sans MCP, l'agent utilise l'interface en ligne de commande à travers son shell, ce qui fonctionne partout. Avec MCP, il obtient des outils typés, et render_item renvoie le PNG directement dans la conversation, donc un modèle avec vision regarde la carte sans aller-retour de fichier.

agentee mcp sert un répertoire de projet sur stdio. Pointez-le vers le répertoire contenant le TOML.

Claude Code, depuis le répertoire du projet :

claude mcp add agentee -- agentee mcp "$PWD"

Codex, dans ~/.codex/config.toml :

[mcp_servers.agentee]
command = "agentee"
args = ["mcp", "/path/to/project"]

Cursor, Claude Desktop et la plupart des autres clients prennent la forme JSON commune, dans .cursor/mcp.json, claude_desktop_config.json ou les propres paramètres du client :

{
  "mcpServers": {
    "agentee": {
      "command": "agentee",
      "args": ["mcp", "/path/to/project"]
    }
  }
}

Le serveur n'écrit pas de TOML pour l'agent. Il lit, vérifie, rend, route, simule et écrit le paquet de fabrication ; l'agent modifie toujours les fichiers avec ses propres outils ou avec agentee edit dans un shell. La page MCP liste tous les outils.

#Donnez-lui la référence de format

La skill est la méthode de travail. La référence complète, clé par clé, est séparée, pour ne coûter du contexte que si nécessaire : agentee docs l'affiche, et l'outil MCP format_reference la renvoie. La skill indique à l'agent de lire la section correspondant au type de fichier qu'il s'apprête à écrire. Le même texte est sur ce site sous Référence, et en un seul fichier à /llms-full.txt.

#Rédigez un cahier des charges exploitable

Un agent conçoit une carte comme un ingénieur junior : bien quand les exigences sont écrites, mal quand il doit les deviner. Un cahier des charges utile indique :

• Ce que fait la carte, et ce qui s'y connecte : connecteurs, tensions, courants, signaux et leurs vitesses.
• Le fabricant et le nombre de couches, ou le budget à ne pas dépasser. jlcpcb avec un empilement de deux ou quatre couches convient à la plupart des premières cartes.
• Limites de taille, trous de fixation et position obligatoire des connecteurs.
• Les composants déjà choisis, par numéro de pièce du fabricant. Les composants choisis par l'agent doivent figurer dans DESIGN.md avec la raison du choix.
• Ce qui doit être simulé : le chemin RF, une voie USB, la chute de tension d'un rail, un régulateur chaud.

Par exemple :

Design a 4 layer JLCPCB board, at most 40 x 30 mm, that powers a Raspberry Pi
Pico from USB-C or a 2S LiPo through an ideal diode OR, with a 3.3 V 1 A buck
for an external sensor header. Put the USB-C and the battery JST-PH on the
same short edge. Use parts JLCPCB stocks. Write DESIGN.md as you go, run a DC
drop sim of the 3.3 V rail at 1 A and a thermal sim with the buck at 0.6 W.

Demandez un DESIGN.md à côté des fichiers. La skill indique à l'agent d'en maintenir un, avec le circuit, pourquoi chaque composant a été choisi, les règles de routage dont le circuit a besoin et ce qui reste à vérifier. C'est le document que vous relisez, et celui que la prochaine session lit en premier.

#Observez-le travailler

Lancez agentee view dans le projet pendant que l'agent travaille. La fenêtre se recharge à chaque modification de fichier, vous voyez donc chaque placement et chaque piste se poser, et vous pouvez arrêter l'agent s'il s'oriente là où vous ne voulez pas. Sur un routage, vous pouvez déplacer les composants et tracer les pistes vous-même ; l'enregistrement écrit les modifications dans le même fichier que l'agent lit ensuite. Voir Le visualiseur.

#Ce qu'il faut attendre

L'agent s'appuiera fortement sur la vérification, et c'est le but : chaque diagnostic nomme le fichier, l'élément et l'endroit, et la plupart nomment une valeur qui passe. Ce qui reste à vous :

• Le choix des composants. L'agent choisit des composants plausibles ; vous savez lesquels sont disponibles et fiables. agentee parts aide pour le stock et le prix.
• L'intention de placement. Le placement automatique est un début. L'endroit où un connecteur va sur un produit, ou le côté vers lequel un dissipateur fait face, est votre décision. Déplacez ces composants dans le visualiseur et verrouillez-les.
• Budgets de simulation. Une exécution FDTD peut prendre des dizaines de minutes. La skill indique à l'agent de faire d'abord une exécution à sec et d'itérer grossièrement, mais précisez-le dans le brief si le temps GPU compte.
• Tout ce que les fichiers ne voient pas : l'ajustement mécanique au-delà de l'export STEP, les tests réglementaires, le micrologiciel.