Dónde estás y qué sigue
Las etapas como una línea de avance, las decisiones de ejecución que tomaste una sola vez y el único próximo paso con su comando listo para copiar.
Keelokit la página técnica
Los comandos, las reglas de la casa, el guard y lo que corre solo en cada commit. El mismo método de la página simple, en detalle.
← Keelokit, en palabras simples ¿Orquestando releases? Cómo funciona Harbor →
Este es el fondo: lo de arriba es lo que se ve, esto es cómo se sostiene.
−20 m
/keelokit:project-new te lleva por cinco etapas y muestra cada una en un tablero. Por etapas, se frena donde importa tu decisión; en modo automático, solo donde hace falta una persona. Va dejando todo por escrito.
Una entrevista que primero lee lo que ya tenés y después pregunta solo lo que falta. Lo que nadie sabe todavía queda escrito como pregunta abierta, con un responsable.
Un PRD corto: el problema, para quién es, qué entra y, explícitamente, qué queda afuera.
El stack de la casa. Lo que se desvía queda registrado como decisión, no improvisado.
Un monorepo generado con CI, hooks de git y tests, en verde antes de escribir una feature.
Épicas e historias con escenarios de aceptación y las reglas que tienen que respetar, agrupadas en olas de desarrollo que nunca tocan los mismos archivos.
Elegís qué apps necesita cada producto.
pnpm verify --all▶ Up to date with origin/main (GIT-1)▶ Secret scan (gitleaks)▶ Prisma client▶ Format▶ Lint▶ Typecheck▶ Harness doctor ✔ harness healthy▶ Unit tests▶ Throwaway PostgreSQL (migrated, seeded)▶ Integration tests (real PostgreSQL)▶ Build▶ End-to-end journeys▶ End-to-end on the real stack (./apps/web)▶ Dependency audit✔ verify passed El stack que genera
| Qué tenés | Empezá con | Qué obtenés |
|---|---|---|
| Una idea, nada más | /keelokit:project-new | Un monorepo que funciona, con CI, contexto y un primer backlog |
| Un repo que ya existe | /keelokit:project-adopt | Las reglas mapeadas a sus checks, y el resto como deuda con fecha |
| Una historia para construir | /keelokit:build-story | Tests escritos primero, código que los pasa y un resultado verificado |
| Bugs que se siguen escapando | /keelokit:check-bugbash | Arreglos en la causa raíz, y un check que cubre toda la clase de cada bug que se escapó |
| Un proyecto para seguir | /keelokit:project-dashboardNuevo | Una página liviana y en vivo: el próximo paso para copiar, lo que te espera, cada ola con sus historias |
| Alguien a quien mostrárselo | /keelokit:project-reportNuevo | El estado completo, de solo lectura, como página para compartir o archivo para exportar |
| Una app para probar en tu teléfono | /keelokit:run-localNuevo | Tu app y su API corriendo en un teléfono, un emulador o el simulador, con un comando |
| Un producto listo para usuarios | /keelokit:ship-setup | Staging y producción configurados y verificados, y después /keelokit:ship-release para cada versión |
−22 m
Doce comandos y la entrada, agrupados según lo que estés haciendo. Abrí cualquiera para ver qué hace, paso a paso.
Empezar uno, sumar uno existente, seguirlo
/keelokit Dónde está el proyecto, qué sigue y qué espera tu decisión.
Cómo funcionaQué hace
Cuándo
Cada vez que abrís una sesión y no sabés por dónde seguir.
/keelokit:project-new De una idea a un esqueleto que funciona: intake, PRD, stack, monorepo generado con CI y primer backlog.
Cómo funcionaQué hace
Cuándo
Tenés una idea y una carpeta vacía.
/keelokit:project-adopt Suma solo el harness a un repo que ya tenés. Lo que todavía no cumple queda como excepción con fecha.
Cómo funcionaQué hace
Cuándo
Ya tenés código y querés las reglas y los controles sin reescribir nada.
/keelokit:project-dashboardNuevo La página desde la que trabajás: liviana, en vivo y armada desde el repo.
Cómo funcionaQué hace
Cuándo
Para ver dónde está todo, aprobar una etapa o retomar después de una pausa.
/keelokit:project-reportNuevo El estado completo del proyecto, de solo lectura, para compartir o exportar.
Cómo funcionaQué hace
Cuándo
Para mostrarle el proyecto a un socio, un cliente o un inversor, o guardar registro de cómo estaba.
Saber qué construir
/keelokit:plan-intake Lee briefs, notas o un repo, y pregunta solo lo que falta. Nunca completa un hueco adivinando.
Cómo funcionaQué hace
Cuándo
Un producto nuevo, o una funcionalidad nueva que necesita contexto.
/keelokit:plan-backlog Épicas e historias con escenarios de aceptación y los invariantes que respetan, en olas de desarrollo para que el trabajo en paralelo no choque.
Cómo funcionaQué hace
Cuándo
Después del PRD, después de sumar una funcionalidad, o para replanificar.
Convertir historias en producto que funciona
/keelokit:build-story Una historia por vez, o una ola entera en paralelo: primero los tests, después el código, y después quienes no lo escribieron intentan romperlo.
Cómo funcionaQué hace
Cuándo
Una historia está lista. De a una, o varias de la misma ola a la vez.
Encontrar lo que se escapó, y que no vuelva
/keelokit:check-bugbashNuevo Una cacería de bugs en datos, API, integridad, UX, i18n, accesibilidad y seguridad. Cada bug que se escapó suma un check para toda su clase.
Cómo funcionaQué hace
Cuándo
Después de cada ola, y antes de un release.
/keelokit:check-security Seguridad y privacidad a fondo: datos personales, la ley de cada mercado, abusos de los recorridos críticos, escaneos.
Cómo funcionaQué hace
Cuándo
Antes del primer lanzamiento a producción, y cuando un release toca datos personales, autenticación o pagos.
/keelokit:check-health ¿Cada regla sigue respaldada por un check que funciona? Suma reglas y registra excepciones.
Cómo funcionaQué hace
Cuándo
Cuando el CI o el tablero muestran errores del harness, o para sumar una regla.
De tu teléfono a tus usuarios: local, staging y producción, versiones
/keelokit:run-localNuevo Tu app y su API en tu teléfono, un emulador de Android o el simulador de iOS, con un comando. Lo que le falte a tu Mac, lo instala después de un solo sí.
Cómo funcionaQué hace
Cuándo
Querés ver y tocar lo que estás construyendo. En macOS, para proyectos con app móvil.
/keelokit:ship-setup Staging y producción para quien nunca desplegó nada: una guía, la automatización y la prueba de cada paso.
Cómo funcionaQué hace
Cuándo
Después del esqueleto, antes del primer release, o cuando un entorno no está listo.
/keelokit:ship-release Una versión de tu producto que se puede nombrar, leer y a la que se puede volver.
Cómo funcionaQué hace
Cuándo
Terminó una ola y el último bug bash está limpio.
Mantener el harness al día
/keelokit:harness-upgrade Mantenimiento del harness, no de tu app: trae a tu proyecto las reglas y controles nuevos de Keelokit.
Cómo funcionaQué hace
Cuándo
Después de actualizar el plugin, o cuando el tablero dice que el harness quedó atrás.
−24 m
Nuevo en 0.8
/keelokit:project-dashboard arma una página corta desde tu repo, en tu idioma: dónde está el proyecto, el próximo paso, lo que te espera. Se mantiene en vivo y es liviana: se publica una vez y cada actualización cambia la página abierta sin volver a pasarla por el chat, así que seguir un proyecto gasta muy pocos tokens. Para otra persona, /keelokit:project-report genera el estado completo, de solo lectura, para compartir o exportar.
Las etapas como una línea de avance, las decisiones de ejecución que tomaste una sola vez y el único próximo paso con su comando listo para copiar.
Aprobaciones, las decisiones que dejó un bug bash o una revisión de seguridad con la opción que recomienda, entornos a medio configurar, actualizaciones del harness. Cada una con el link a su origen y su pedido listo.
Las historias bajo su ola de desarrollo, cada una con el link a su archivo en el repo: hecha, lista para construir (copiás su comando) o esperando a otra. Las olas terminadas se pliegan.
El doctor, el último bug bash y la última revisión de seguridad con lo que corrigieron, staging y producción paso a paso, y los documentos del proyecto a un clic.
Cada botón copia su pedido y llena esta caja: lo completás y lo enviás a la sesión de Claude que mira el tablero, o lo pegás en cualquier chat.
/keelokit:project-report muestra cada etapa con sus documentos, cada hallazgo, las decisiones y el historial. De solo lectura, como página para compartir o archivo HTML que se abre en cualquier lado.
−26 m
Nuevo en 0.9
/keelokit:run-local levanta la base de datos y la API y abre tu app en un teléfono Android, un emulador o el simulador de iOS. Es el primer paso de los entornos: local, después staging y producción con /keelokit:ship-setup, y las versiones con /keelokit:ship-release.
Revisa qué falta, lo muestra todo junto y lo instala después de un solo sí. Nada se instala a tus espaldas.
Si la app ya está instalada y no cambió nada nativo, no recompila: la abre y listo.
Pregunta si cargar los datos de ejemplo y muestra los usuarios de prueba para entrar.
Cada paso deja su log y el último error; Claude lo lee, lo repara y vuelve a correrlo. Nunca frena un proceso, un contenedor o un emulador sin preguntar.
pnpm run:local android▶ Diagnosis ✓ Node v22.12.0 ✓ pnpm 10.33.0 ✓ Docker running ! JDK 17▶ I am going to install/configure: JDK 17 (brew install --cask zulu@17) [y/N] y▶ Database and API ✓ database on port 5432 ✓ API on port 3000 (log: .local-dev/logs/api.log)▶ Android: Galaxy S20 (USB) ✓ already installed, nothing native changed: no rebuild ✓ Metro running, app opened Por ahora en macOS. Probado en un Galaxy S20 por USB y en el simulador de iOS.
−28 m
En mi experiencia, los agentes tienden a cerrar historias y dejan un tendal de bugs en el camino, que no documentan ni explicitan. De ahí salieron estas cuatro ideas.
Cada regla apunta a algo que la verifica: un test, una regla de lint, un hook de git, un job de CI. El doctor avisa cuando una regla se quedó sin su check.
Lo que nadie sabe todavía se escribe con un responsable y la pregunta exacta. No se inventan valores que suenan bien.
Un verificador escribe los tests de aceptación antes del código, un revisor lee el diff en frío, un breaker ataca la rama, y solo el verificador puede dar una historia por terminada.
Lo que siempre tiene que cumplirse (los totales cierran, un aviso sale una sola vez, un límite aguanta dos requests a la vez) se escribe como invariante y se prueba con tests de propiedades, de concurrencia y de repetición. El código crítico pasa por mutation testing, para que sus tests puedan fallar de verdad.
pnpm doctorKeelokit doctor Gates: intake ✓ → product ✓ → stack ✓ → skeleton ✓ → backlog ✓ Rules: 34 · Context gaps: 2 (0 blocking) Invariants: 6 · Critical areas: 1 · Escapes logged: 2 Backlog: 4/11 done · next: AUTH-005, PAY-001 warn exception for UI-1 until 2026-12-01: map SDK needs a literal colour ERROR rule QA-1: CI job 'unit' has continue-on-error SEC-1Sin secretos en el repoescaneo en CI · guard · pre-commitCFG-1Cada variable de config documentadaun test que compara schema, archivos .env y READMEAUTHZ-1Cada ruta con su decisión de accesoun test que lee el router realI18N-1Texto solo a través de traduccionesregla de lint · test de paridad de idiomasQA-4Ningún test silenciadoguard · pre-commitTRACE-1Cada escenario con su testdoctor, en CIINV-1Cada invariante probado por un testdoctor, en CIMUT-1Tests del código crítico que pueden fallarmutation score en CI−30 m
Un guard frena secretos (claves de AWS, GitHub, Stripe, Anthropic, npm, GitLab, JWT y más, aunque vengan partidas en dos ediciones), cambios a archivos .env y a migraciones ya aplicadas, hooks salteados, tests silenciados y deploys a producción.
Un estado corto: dónde está el proyecto y qué historias están listas.
El mismo guard como hook de git, y después el chequeo local completo antes de que algo llegue al remoto.
Escaneo de secretos, lint y tipos, tests unitarios y de integración contra un PostgreSQL real, recorridos de punta a punta con análisis de accesibilidad y contra la API real, mutation testing del código crítico, análisis estático y deploy a staging.
git commit -m "wip" --no-verifyBlocked by Keelokit — QA-2: never bypass git hooks echo "API_KEY=…" > apps/api/.envBlocked by Keelokit — SEC-2: don't write .env files from the shell;edit .env.example, real values go in the secret store −32 m
Keelokit no tiene servidor propio ni junta datos. Todo queda en tu computadora y en tus cuentas.
Tu computadora
Ahí corre Claude Code con Keelokit. Ahí se escribe el código y se prueba la app mientras se construye.
GitHub
Fly.io
El servidor en internet para la parte de atrás de la app, la que procesa pedidos, y su base de datos.
−34 m
Ideas de las que aprendí. El desarrollo guiado por especificaciones (OpenSpec, Spec Kit), Superpowers por separar quién construye de quién revisa, Copier por los templates que se pueden actualizar, y mucha prueba y error en mis propios proyectos.