/wayfinder : le skill d'agent IA pour planifier dans le brouillard de guerre
Créé par Matt Pocock, le skill /wayfinder propose un cadre d'orchestration pour planifier les projets complexes sans épuiser la fenêtre de contexte de vos agents. En découpant la phase de conception en sous-sessions spécialisées, cet outil prépare des tâches prêtes pour une exécution autonome. Découverte d'une méthode rigoureuse pour structurer la gestion de projet guidée par l'IA.
Fil « Le skill Wayfinder pour la planification logicielle avec agents IA »
Surmonter la limite de contexte en phase de conception
Lorsqu'on prépare du travail pour des agents exécutés en tâche de fond (dits AFK, pour Away From Keyboard, c'est-à-dire sans intervention humaine immédiate), la phase de planification devient rapidement un goulot d'étranglement. Établir une spécification détaillée consomme rapidement une part importante de la fenêtre de contexte (la quantité maximale de texte et de jetons de mots que le modèle d'IA peut traiter dans une seule session).
Pour résoudre ce problème, le développeur Matt Pocock — auteur du projet aux 220 000 étoiles sur GitHub « AI Skills for Real Engineers » — a lancé le skill /wayfinder (une compétence préprogrammée sous forme de consignes structurées pour un agent). Son rôle est d'agir comme un orchestrateur qui gère et découpe la réflexion globale en plusieurs sessions indépendantes.
Un langage omniprésent pour guider l'agent
L'élément clé de /wayfinder repose sur la maîtrise de la terminologie, ou l'utilisation de « mots-guides » (leading words). Pour éviter que le modèle ne confonde les entités, le skill formalise une structure stricte autour de trois piliers :
- La carte (map) : le document central récapitulant l'ensemble des décisions déjà prises et l'avancement du projet.
- Les tickets : les tâches unitaires attribuées à des sessions autonomes.
- Les sessions : les exécutions isolées de l'agent sur un sujet précis.
Dans /wayfinder, les tickets se déclinent en quatre catégories : prototypage, recherche, tâches réservées à l'humain, et tickets de grilling (des sessions d'alignement où l'agent pose des questions poussées au développeur pour clarifier un besoin).
Explorer la carte pas à pas
Inspiré de la notion de « brouillard de guerre » issue des jeux vidéo de stratégie, ce skill accepte l'incertitude initiale d'un projet. Au lieu de forcer une architecture complète dès le départ, /wayfinder permet d'avancer progressivement : chaque sous-session exécutée dissipe une partie du flou et vient mettre à jour la carte globale.
« Vous pouvez prendre certaines décisions, et ces décisions vous mènent plus loin dans le brouillard de guerre. Une fois que vous avez compris le flux d'informations, vous avez votre skill. » — Matt Pocock
Contrairement au skill grill-me (utilisé pour aligner le développeur et l'agent sur une petite fonctionnalité au cours d'une seule conversation), /wayfinder intervient quand le chemin reste totalement à définir et nécessite une exploration multi-threads.
# Exemple d'initialisation du skill dans un agent comme Claude Code
/wayfinder plan "Rearchitecturer le site web personnel avec 20 ans d'historique"
Cette méthodologie montre que la réussite du travail avec les assistants autonomes dépend moins de la puissance brute du modèle que de la rigueur du modèle de données et du vocabulaire fournis à l'agent.