Pu11en/sysmap

Planifiez et expliquez des systèmes à l'aide d'une carte enregistrée et cliquable. Idéal pour la conception collaborative, la poursuite d'une conversation de planification, l'explication de systèmes ou la préparation d'un plan convenu pour la mise en œuvre. Conservez les questions de conception dans le chat.

Qu'est-ce que sysmap ?

Ce skill, Pu11en/sysmap, permet à un agent IA d'agir comme un architecte système collaboratif, en planifiant et en documentant des systèmes à travers une carte interactive enregistrée. Il est utile pour les développeurs et les équipes qui souhaitent créer une compréhension partagée avant de coder, que ce soit pour une nouvelle conception, l'analyse d'un système existant, ou la poursuite d'une session de planification. Le skill s'appuie sur un fichier `.plan.json` unique comme source de vérité, et génère des dessins et des vues de navigation à partir de celui-ci. Il fonctionne en guidant l'agent à travers un processus structuré : définition des composants (avec leur entrée, travail, résultat, règles, etc.), maintien de séparations claires (stockage vs actions, états d'attente vs travail), et collaboration via des questions et des propositions. Le skill insiste sur le fait que la planification n'autorise jamais la mise en œuvre et qu'il faut citer les preuves, séparer les faits vérifiés des propositions, et vérifier les changements avant de terminer. Il supporte les environnements où l'agent peut lire et écrire des fichiers et, optionnellement, accéder à un navigateur pour inspecter les dessins générés. Le workflow est conçu pour éviter les suppositions et garantir que chaque décision est explicitement convenue, ce qui le rend idéal pour les processus de conception rigoureux.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pu11en/sysmap/tree/HEAD

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

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

Documentation

Planifier via une carte système

Créez une compréhension partagée avant de dessiner ou de construire. La carte montre le comportement du système ; le chat contient la discussion. La planification n'accorde jamais la permission de mettre en œuvre le produit.

Lisez le guide de planification avant de commencer ou de reprendre la planification. Il définit le format source, les enregistrements de parties, la navigation et les vérifications. Pour la configuration de l'assistant et les commandes, lisez le README.

Partir des preuves

Continuez avec le seul fichier .plan.json enregistré de la conversation. Lisez son objectif, ses décisions, ses questions ouvertes et sa position actuelle de planification. Inspectez les preuves pertinentes du projet avant de décrire le comportement existant. Chargez uniquement la partie courante et ses voisines lorsque la source est volumineuse.

Pour une nouvelle conversation, choisissez un nom de source descriptif unique. Ne remplacez jamais le plan d'une autre conversation. Le plan source est faisant autorité ; les dessins et les manifestes générés ne sont pas des plans modifiables.

Séparez les faits vérifiés, les plans convenus, les inconnues et les propositions non acceptées. Citez les preuves. N'inférez jamais une décision antérieure à partir d'une étiquette vague et n'inventez pas de faits pour combler une lacune.

Définir le sens avant de dessiner

Pour chaque partie, enregistrez sa tâche unique, son entrée, son travail, son résultat, ses règles, son destinataire suivant, sa limite et ses preuves. Utilisez les noms de champs définis dans le guide.

Gardez le stockage séparé des actions. Distinguez un état d'attente du travail. Connectez chaque résultat à l'entrée attendue de la partie suivante. Parcourez un exemple concret à travers les parties connectées.

Utilisez des étiquettes courtes et des flèches nommées. Les pages enfants expliquent leur partie parente. Connectez-les via des destinations detail explicites, jamais par des noms correspondants ou des liens supposés. Gardez les choix d'outils, les questions de conception et les commentaires sur les fonctionnalités supprimées en dehors du graphe.

Collaborer et avancer

Répondez d'abord à la question en cours. Lisez les décisions prises avant de poser une autre question. Les modifications demandées claires mettent à jour la source tout en préservant les décisions non liées. L'accord n'accepte que la proposition effectivement montrée.

Après avoir réglé un point, avancez vers la prochaine partie non résolue significative. Expliquez son objectif, proposez une approche fondée, puis posez un choix concret lorsqu'il modifie la conception. Ne transformez pas la planification en entretien et ne vous arrêtez pas à « enregistré ».

Étiquetez les défauts mineurs comme des propositions. Ne décidez pas silencieusement des autorisations, de la confidentialité, des coûts ou des preuves factuelles. Résolvez la confusion avant d'avancer. S'il ne reste aucune décision matérielle, résumez l'état de préparation et proposez une révision ou une mise en œuvre autorisée séparément.

Vérifier avant de prétendre à l'achèvement

Après avoir modifié un plan, construisez-le et inspectez les connexions affectées et le sens des pages enfants. Si l'accès au navigateur est disponible, inspectez également le dessin et la navigation. Signalez honnêtement les vérifications indisponibles.

Les tests de l'assistant vérifient la structure et la sortie générée, pas la vérité du système, les interactions réelles avec le navigateur, ni la compatibilité avec tous les environnements d'agents.

Skills associés