Pu11en/sysmap

Planifica y explica sistemas a través de un mapa guardado e interactivo. Útil para diseño colaborativo, continuar una conversación de planificación, explicar sistemas o preparar un plan acordado para la implementación. Mantén las preguntas de diseño en el chat.

¿Qué es sysmap?

Esta habilidad para agentes de IA permite planificar y documentar sistemas complejos mediante la creación de mapas visuales y navegables, manteniendo la discusión en el chat. Es ideal para equipos de desarrollo que necesitan diseñar colaborativamente, explicar arquitecturas existentes o preparar planes detallados antes de implementar. La habilidad se basa en un formato de origen `.plan.json` único por conversación, que actúa como fuente autoritativa para generar dibujos y descripciones del sistema. Define cada parte del sistema con campos específicos (trabajo, entrada, salida, reglas, límites, etc.), mantiene separados el almacenamiento de las acciones, y conecta las partes mediante enlaces explícitos. Incluye reglas para verificar hechos, separar decisiones aceptadas de propuestas, y avanzar de manera incremental colaborativa. Al finalizar, verifica la coherencia del mapa generado y la navegación entre páginas hijas. Soporta plataformas como Claude Code y Cursor, y está diseñado para agentes que trabajan con archivos markdown y herramientas de renderizado de gráficos.

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

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Planificar a través de un mapa del sistema

Crea un entendimiento compartido antes de dibujar o construir. El mapa muestra el comportamiento del sistema; el chat contiene la discusión. La planificación nunca otorga permiso para implementar el producto.

Lee la guía de planificación antes de comenzar o reanudar la planificación. Define el formato de origen, registros de partes, navegación y verificaciones. Para la configuración del ayudante y comandos, lee el README.

Comenzar desde la evidencia

Continúa el archivo de origen .plan.json guardado de la conversación. Lee su objetivo, decisiones, preguntas abiertas y posición actual de planificación. Inspecciona la evidencia relevante del proyecto antes de describir el comportamiento existente. Carga solo la parte actual y sus vecinos cuando el origen sea grande.

Para una nueva conversación, elige un nombre de origen descriptivo único. Nunca sobrescribas el plan de otra conversación. El plan de origen es autoritativo; los dibujos y manifiestos generados no son planes editables.

Separa hechos verificados, planes acordados, incógnitas y propuestas no aceptadas. Cita evidencia. Nunca infieras una decisión anterior a partir de una etiqueta vaga ni inventes hechos para cerrar una brecha.

Definir el significado antes de dibujar

Para cada parte, registra su trabajo único, entrada, trabajo, resultado, reglas, siguiente destinatario, límite y evidencia. Usa los nombres de campo definidos en la guía.

Mantén el almacenamiento separado de las acciones. Distingue un estado de espera del trabajo. Conecta cada resultado con la entrada esperada de la siguiente parte. Recorre un ejemplo concreto a través de las partes conectadas.

Usa etiquetas cortas y flechas con nombre. Las páginas hijas explican su parte padre. Conéctalas mediante destinos de detail explícitos, nunca con nombres coincidentes o enlaces adivinados. Mantén las elecciones de herramientas, preguntas de diseño y comentarios sobre características eliminadas fuera del gráfico.

Colaborar y avanzar

Responde primero la pregunta actual. Lee las decisiones establecidas antes de hacer otra pregunta. Las solicitudes de cambio claras actualizan el origen mientras preservan decisiones no relacionadas. El acuerdo acepta solo la propuesta realmente mostrada.

Después de resolver un punto, avanza hacia la siguiente parte no resuelta significativa. Explica su propósito, propón un enfoque fundamentado, luego haz una pregunta concreta cuando cambie el diseño. No conviertas la planificación en una entrevista ni te detengas en "guardado".

Etiqueta los valores predeterminados menores como propuestas. No decidas silenciosamente sobre permisos, privacidad, costo o evidencia factual. Resuelve la confusión antes de avanzar. Si no quedan decisiones materiales, resume la preparación y ofrece implementación por separado o autorizada.

Verificar antes de afirmar finalización

Después de cambiar un plan, constrúyelo e inspecciona las conexiones afectadas y el significado de las páginas hijas. Si hay acceso al navegador, inspecciona también el dibujo y la navegación. Informa honestamente sobre las verificaciones no disponibles.

Las pruebas del ayudante verifican la estructura y la salida generada, no la verdad del sistema, interacciones reales del navegador, ni la compatibilidad con todos los entornos de agente.

Skills relacionados