🗂️ AI4Kanban

Una skill de Claude Code

Gestión de proyectos con IA
que crece contigo.

Dale una idea vaga. El agente la descompone, resuelve por su cuenta lo que puede y te pregunta el resto, y sigue trabajándola en segundo plano hasta que cada detalle está claro para construir. El tablero es Markdown plano en docs/kanban/: en git, sin base de datos, sin MCP.

El tablero, dibujado en tu terminal: los mismos archivos que viven en git.

Descompone el trabajo

El agente lee una idea y la parte en subtareas. Si viene enredada con una petición ajena, la separa en una tarea propia.

Aclara en bucle

El agente empieza cuestionando la idea. Lo que puede resolver con memoria y sentido común lo resuelve solo; el resto te llega a ti. Y sigue dando vueltas hasta quedarse sin preguntas.

Trabaja 24/7

La descomposición y las aclaraciones siguen corriendo en segundo plano hasta que la idea se convierte en una especificación clara.

Cada decisión es rastreable

Siempre puedes ver cómo se fue formando una especificación, paso a paso.

Propone tareas por su cuenta

El agente plantea funciones sacadas de la memoria de cada módulo. Vetas una y queda registrado: no volverá a proponer nada de ese estilo.

Se va afinando solo

Cada vez que intervienes, esa decisión queda registrada y guía lo que el agente decide después. La memoria está organizada por módulo del proyecto.

Ordena el trabajo

No solo parte tareas: detecta dependencias y pesa el retorno frente al esfuerzo, para que el trabajo avance en el orden correcto.

Se ocupa de todo el ciclo

Su trabajo no acaba cuando la especificación está clara. Lleva la vida entera de una tarea, desde que se propone hasta que se aclara, se construye y se archiva, así que el tablero siempre refleja dónde está el proyecto de verdad.

AI4Kanban está hecho para equipos pequeños. Los agentes de código de hoy ya convierten una especificación clara en código que funciona, pero dales una idea vaga y construirán lo que no era sobre suposiciones equivocadas. AI4Kanban recuerda tus decisiones anteriores y se apoya en ellas para convertir esa misma idea vaga en una especificación lo bastante concreta como para construirla.

01 · Puesta en marcha

Instálalo con un solo prompt

Desde la raíz de tu proyecto, dile a Claude Code (o a cualquier agente que pueda ejecutar comandos de shell):

Set up ai4kanban for this project. Read
https://ai4kanban.dev/INSTALL_PROMPT.txt
and follow it.

El agente copia la skill en .claude/skills/kanban/, lee tu código para rellenar la configuración, monta el tablero y te propone tus tres primeras tareas.

02 · Uso

Usar AI4Kanban dentro de Claude Code

Una vez instalado, lo manejas hablando normal:

you › claude
"/kanban ¿qué toca ahora?"
lee el tablero y tus fuentes, y propone 3 tareas nuevas
"/kanban añade una tarea: …"
revisa la idea, escribe una tarjeta y la añade al índice
"/kanban refine #4"
revisa la tarjeta #4 y la empuja una etapa hacia lo concreto
"/kanban revisa el tablero"
comprueba claridad, duplicados y tarjetas ya terminadas
"/kanban #4 está hecha"
la comprime en el archivo y elimina la tarjeta
"/kanban #4 era mala idea"
anota el motivo en rejected.md para no volver a proponerla
03 · Tablero web

Un tablero local que abres en el navegador

¿Prefieres mirar en vez de preguntar? Un comando abre un tablero sobre esos mismos archivos Markdown: lees una tarea entera sin buscar su archivo en el árbol del IDE, y actúas con un clic en lugar de reescribir el mismo prompt en el chat.

Es opcional: la instalación no trae nada extra. Cuando lo quieras, solo pídeselo a Claude:

/kanban run the local board UI

Claude arranca el servidor ya compilado por ti: solo en localhost, nada que compilar.

Los botones de cada tarjeta le pasan un movimiento al agente, sin escribir nada:

  • Implementar pásale la tarjeta a Claude para que la construya
  • Editar retoca la tarjeta, no la ejecutes
  • Refinar empuja un paso una tarjeta atascada
  • Resolver responde las preguntas abiertas de la tarjeta
  • Archivar guarda una tarjeta terminada
  • Rechazar descarta una tarjeta y anota por qué
04 · Presets

El preset indie-hacker

Construir todo el día mientras nadie mira es la trampa clásica del fundador en solitario. Este preset reparte tu tiempo en tres partes: buscar usuarios, comprobar demanda y construir. Claude mantiene el trabajo nuevo repartido entre las tres en lugar de amontonarlo en una.

growth

50%

Ponte delante de los usuarios: publicaciones, contacto directo, lanzamientos. Claude sugiere métodos que vale la pena probar y te los redacta.

validation

30%

Comprueba que el mercado lo quiere antes de construir a fondo. Lanza una pregunta honesta, comparte una prueba, guarda el veredicto.

building

20%

Quédate en el MVP. Construye cuando escale tu trabajo, refuerce el producto o los usuarios lo pidan claramente.

El preset indie-hacker añade además dos filtros de revisión, una prueba de foso y una prueba de confianza, y un método de validación de mercado para publicar en Reddit o X antes de construir. En la instalación puedes cambiar las vías y los pesos por los tuyos.

05 · Funciones

Gestión de proyectos en Markdown, no una lista plana

Una lista de tareas plana no es más que eso: una lista. Esta hace cuatro cosas que una lista no puede: trabajo recurrente, subtareas para lo grande, memoria de lo hecho y una cuenta de rendimiento.

Tareas recurrentes

Hay trabajo que nunca se hace una sola vez. Guarda cada uno como tarjeta en docs/kanban/todo/recurring/ (un trabajo que no se archiva nunca) y deja que el /loop de Claude Code lo ejecute con la cadencia que elijas, por ejemplo cada mañana.

Seguimiento de competencia

Mira qué lanzaron o cambiaron los rivales y marca lo que merezca respuesta.

Escucha social

Trae publicaciones recientes de Reddit o Slack y saca a flote las que importan.

Revisión del tablero

Barre el backlog buscando tarjetas caducadas, duplicadas o ya hechas.

No todo trabajo necesita el mismo nivel de automatización. Una tarjeta puede quedarse en cualquier peldaño: desde uno que llevas a mano, a uno que Claude hace por ti, a un script que corre solo:

[ask]lo haces tú a mano
[agent]Claude lo hace por ti
[script]lo ejecuta un comando, sin humanos

Sube cada trabajo tan arriba como se gane: algunos se quedan en manual, otros acaban corriendo solos.

Tareas de grupo

Una tarea demasiado grande para empezar suele quedarse ahí parada. Cuando no cabe en una tarjeta, se convierte en una tarea de grupo: su propia carpeta con un root.md de seguimiento y una tarjeta por pieza. Cada pieza tiene su propio id y se conecta con enlaces Blocked by y Related, así siempre sabes qué toca coger después.

todo/42-payments/
  root.md                  # the tracking task
  feature/43-checkout.md   # a subtask, its own card + id
  feature/44-refunds.md
  bug/45-webhook-retry.md

Memoria del proyecto

Trabajar el tablero es un bucle. En cada vuelta Claude propone trabajo nuevo tirando de tres fuentes, tú decides, y él pliega el resultado en un centro de memoria, de forma que la vuelta siguiente parte de la anterior en vez de repetirla.

docs/kanban/lee y escribepaso 1Proponepaso 2Decides túpaso 3Aprende
  1. 1

    Propone. Tira de tres fuentes buscando trabajo que no esté ya entregado ni aparcado:

    • Tu proyecto Código, tablero, documentación, chat del equipo: conecta lo que ya hay en trabajo que merece la pena.
    • El exterior Reddit, Slack, tu CRM. Los trabajos recurrentes traen señal fresca y dejan los hallazgos en el tablero.
    • Tu propio criterio y tus comentarios, guardados en el tablero para que una buena decisión no se pierda ni se pregunte dos veces.
  2. 2

    Decides tú. Adelante, sáltalo o corrige el plan. Con unas palabras a Claude basta.

  3. 3

    Aprende. Pliega el resultado y tu opinión en el centro, así la vuelta siguiente arranca más afinada.

docs/kanban/: el centro que guarda tus decisiones
memory.md

Las notas de cada barrido pasan al siguiente, con una marca de agua por fuente, así que solo relee lo que ha cambiado.

archive.md

El trabajo entregado se encoge a una línea. Lee esto antes de proponer, así no vuelve a sugerir lo que ya está hecho.

rejected.md

Las ideas que descartaste se guardan con su motivo, así no vuelve a plantearlas nunca.

redesign.md

Un error de diseño que corregiste se convierte en una nota, así la siguiente tarjeta no repite el plan equivocado.

Métricas de tareas

Cada tarjeta archivada es una unidad entregada, así que tu velocidad es un número más en git, junto al trabajo: sin panel de control y sin otra herramienta aparte.

0246807-0207-0807-13TotalCompletadasCreadasRechazadas
Una fila por día en metrics.csv: completadas, creadas, rechazadas y su total. El script lo mantiene al día; tú no lo tocas nunca.