wayfinder

Installation
SKILL.md

Une idée encore vague dépasse ce qu’une seule session peut contenir : le chemin vers la destination n’est pas encore visible. Wayfinder sert à découvrir cet itinéraire, pas à réaliser la construction elle-même. Le skill crée une carte partagée dans l’outil de suivi du dépôt, puis traite un à un ses tickets de décision — des questions dont la résolution produit une décision, et non une tranche de mise en œuvre — jusqu’à ce que la voie soit claire.

La destination dépend de l’effort ; la nommer constitue le premier acte de cartographie et donne sa forme à chaque ticket. Il peut s’agir d’une spécification à transmettre, d’une décision structurante à prendre avant la planification ou d’un changement achevé, comme une migration de données. La carte ne dépend pas du domaine : ingénierie, contenu pédagogique ou tout autre travail présentant la même forme.

Planifier sans réaliser

Par défaut, Wayfinder planifie : chaque ticket résout une décision et la carte se termine lorsqu’il ne reste plus rien à décider avant la construction. L’envie de commencer la mise en œuvre signale généralement que vous avez atteint le bord de la carte et qu’il faut transmettre le travail. Les Notes peuvent explicitement modifier cette règle pour un effort particulier ; sinon, produisez des décisions, pas des livrables.

Référencer les tickets par leur titre

Chaque carte et chaque ticket possèdent un titre. Dans tout texte destiné à l’humain — narration et décisions déjà prises — utilisez ce titre, jamais un simple identifiant, numéro ou slug. Une suite comme #42, #43, #44 est illisible ; des titres se comprennent immédiatement. Conservez l’identifiant et l’URL dans le lien associé au titre, sans les utiliser à sa place.

La carte

La carte est un ticket unique de l’outil de suivi, étiqueté wayfinder:map. Il constitue l’artefact canonique et ses tickets de décision sont des tickets enfants.

La carte est un index, pas un entrepôt. Elle répertorie les décisions et pointe vers les tickets qui en contiennent le détail. Chaque décision n’existe qu’à un seul endroit — son ticket — ; la carte n’en conserve que l’essentiel et le lien.

L’emplacement de la carte, de ses tickets enfants, de ses blocages et de ses requêtes de frontière dépend de l’outil de suivi. Cette configuration doit déjà exister ; sinon, exécutez /setup-mabza-skills. Consultez la section « Opérations d’orientation » du document de suivi pour connaître les conventions du dépôt. Si aucun outil n’est configuré, utilisez le suivi Markdown local.

Installs
9
Repository
mabzadev/skills
First Seen
Aug 20, 2026