dibujar
Skill0 starsChanged todayMITView on GitHub
Genera los dibujos de la bóveda (roadmap general, modelo de datos, mapa de pantallas y arquitectura) como archivos SVG a partir de un archivo de datos. Usala siempre que haya que crear o actualizar uno de esos dibujos.
In this repository8 other files it gives its agents.
- adoptarSkill
- cerrar-specSkill
- estadoSkill
- iniciar-mobileSkill
- iniciar-proyectoSkill
- modulosSkill
- spec-implSkill
- specSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 35
No hay más dibujos que estos.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Dibujar
Cada dibujo es un archivo de datos (JSON) más un script que lo convierte en SVG. Nunca escribas ni edites un SVG a mano: se cambia el dato y se vuelve a generar. Así el dibujo no puede decir algo distinto de los datos, y actualizarlo cuesta una línea.
Hace falta Node (node --version). No hace falta Obsidian abierto ni ningún plugin: Obsidian muestra los SVG como imágenes.
Cómo se hace
- Escribí o cambiá el archivo de datos. Vive al lado del dibujo, con el mismo nombre:
Roadmap general.jsonyRoadmap general.svg. Generá el dibujo con el script que está en la carpeta de esta skill:
node "<carpeta de esta skill>/roadmap-general.js" "Roadmap general.json" "Roadmap general.svg"- Si el script corta con un error, el mensaje dice qué dato está mal (una flecha a algo que no existe, un tipo desconocido). Corregí el dato, no el script.
- Miralo antes de entregarlo. Pasalo a imagen (en Mac:
sips -s format png "dibujo.svg" --out /tmp/dibujo.png) y abrila. Buscá texto que se sale de su caja y flechas que cruzan una caja. - La nota que lo muestra lo embebe:
![[Roadmap general.svg]].
Los dibujos
| Dibujo | Script | Dónde va en la bóveda | Cuándo se genera |
| Roadmap general | roadmap-general.js | En la raíz | En /modulos, y cada vez que se escribe o se cierra una spec |
| Modelo de datos | modelo-datos.js | Backend/Estructura/ | En /modulos, y cuando una spec cambia tablas |
| Mapa de pantallas | mapa-pantallas.js | Frontend/Pantallas/ (y Mobile/Pantallas/, el de mobile) | En /modulos (el de mobile, en /iniciar-mobile), y cuando se agrega una pantalla |
| Arquitectura | arquitectura.js | Proyecto/ | En /iniciar-proyecto; casi nunca cambia |
| Roadmap mobile | roadmap-general.js | En la raíz | En /iniciar-mobile, y cada vez que se escribe o se cierra una spec de mobile |
No hay más dibujos que estos. Cada dibujo de más es algo que hay que mantener al día.
Los colores
- En el roadmap, el color dice el estado: azul lo hecho, y rojo suave lo que falta (lo que sigue, lo que está por hacer y lo frenado). El módulo de cada fila queda en el archivo de datos, pero no se pinta.
- En el modelo de datos y el mapa de pantallas, el color dice el módulo. Los dos archivos llevan la misma lista
"modulos"que el roadmap, en el mismo orden: por eso cada módulo tiene el mismo color en los dos. - Siempre colores pastel, con bordes suaves: un borde oscuro sobre muchas cajas cansa la vista.
- En la arquitectura, el color dice el tipo de parte.
Los datos de cada dibujo
La carpeta ejemplos/ tiene un archivo completo de cada uno, con una app de recibos de sueldo. Copiá su forma.
Roadmap general
{
"titulo": "Recibos · Roadmap general",
"modulos": ["Base", "Acceso", "Mails"],
"version1Hasta": "Recuperar contraseña",
"filas": [
{ "nombre": "Login", "modulo": "Acceso", "tamano": "mediano",
"deja": "Se puede registrar un usuario y entrar con su contraseña.",
"backend": { "spec": 2, "hecha": true }, "pantalla": {} }
]
}- Las filas van en el orden en que se construyen. Este archivo es el único lugar donde vive ese orden.
- Cada fila lleva
backend,pantallao las dos. Una fila que es de todo el proyecto (la base del sistema) llevaunico. - Dentro de cada cartel:
spec(su número, desde que/specla escribe),hecha: true(cuando/cerrar-specla cierra),necesita(nombres de otras filas) yfrenada(el motivo, si espera al cliente). necesitase cumple cuando esa otra fila tiene hecho su backend, o su cartel único.tamano:chico,medianoogrande.deja: lo que una persona va a poder hacer cuando la fila esté hecha. No se dibuja; lo lee/estado.version1Hasta: el nombre de la última fila de la versión 1. Dibuja la línea de corte.base: solo en el roadmap mobile. Nombra el archivo del roadmap general ("base": "Roadmap general.json"). Con eso,necesitanombra filas del roadmap general, y cada pantalla sabe si su backend ya está hecho.- El estado no se escribe. El script calcula qué está hecho, qué espera y cuál es el único "sigue".
Modelo de datos
{
"titulo": "Recibos · Modelo de datos",
"modulos": ["Base", "Acceso", "Mails"],
"tablas": [
{ "nombre": "usuario", "modulo": "Acceso", "columnas": [
{ "nombre": "id", "tipo": "uuid", "pk": true },
{ "nombre": "empresa_id", "tipo": "uuid", "fk": "empresa" },
{ "nombre": "apodo", "tipo": "text?" } ] }
],
"notas": ["Un solo usuario por mail (índice único)."]
}fkes el nombre de la tabla a la que apunta.?al final del tipo quiere decir que puede quedar vacío.notas: las reglas que no se ven en las tablas (índices únicos, valores permitidos).sinFlecha: tablas a las que apuntan casi todas, como la empresa ("sinFlecha": ["empresa"]). Sus claves llevan la pastilla FK pero no la flecha, y el dibujo lo aclara solo. El archivo declara igual todas las claves.- Sale de las entidades y migraciones reales cuando ya hay código. Una flecha entre dos colores es una dependencia entre módulos.
Mapa de pantallas
{
"titulo": "Recibos · Mapa de pantallas",
"modulos": ["Base", "Acceso", "Mails"],
"secciones": [
{ "nombre": "Web · la usa la empresa", "pantallas": [
{ "nombre": "Login", "modulo": "Acceso", "hace": "entra con mail y contraseña", "va": ["Inicio"] },
{ "nombre": "Inicio", "modulo": "Base", "hace": "resumen del mes" } ] }
]
}- Una sección por cada entrada distinta a la app (por ejemplo, la empresa y el empleado). La primera pantalla de cada sección es por donde se entra.
va: las pantallas que se abren desde esta. No pongas las flechas de "volver": el script no las dibuja.
Arquitectura
{
"titulo": "Recibos · Arquitectura",
"capas": [
{ "nombre": "El sistema", "tipo": "sistema", "partes": [
{ "nombre": "API", "detalle": "NestJS", "candado": "separa los datos de cada empresa" } ] }
]
}- Las capas van de arriba abajo: lo que usa la persona, el sistema, y donde se guarda.
- Tipos:
persona,sistema,datosyafuera(servicios de otros). Una parte puede tener un tipo distinto al de su capa. candado: una decisión cara de cambiar que cae en esa parte.
Límites conocidos
- El ancho de los textos se estima por cantidad de letras. Un nombre muy largo puede salirse: acortalo.
- En el modelo de datos, con muchas tablas una flecha larga puede cruzar otra tabla. Probá primero con
sinFlecha; si sigue, cambiá el orden de las tablas en el archivo.
El estado en texto
El script del roadmap también dice el estado del proyecto en texto, con la misma cuenta que usa para dibujar. Lo usa /estado:
node "<carpeta de esta skill>/roadmap-general.js" --estado "Roadmap general.json"Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

