Mensaje de presentación de PaellaDoc

:weary_face: La IA programa rápido. Hasta que toca entregar, o iterar un producto complejo.

Entonces nadie sabe qué hizo la IA, qué hiciste tú, ni cómo ni por qué se tomaron ciertas decisiones.

Una metodología de desarrollo de producto fiable no sobrevive el código tirado a velocidad de inferencia.

Hace más de un año subí a GitHub una idea pequeña sobre Cursor: en vez de improvisar prompts, partir de una especificación como PRDs,historias de usuario, criterios de aceptación, y que eso fuese la base para el código. Spec-driven.

El repo llegó a 340 estrellas y se quedó ahí.

No lo abandoné porque dejara de creer en la idea. Lo dejé porque la idea era solo el principio. Desde entonces he seguido trabajando en la sombra, muchas noches, muchos fines de semana, tiempo quitado a mi hijo y a mi mujer.

Hoy “spec-driven” está de moda. Cuando empecé era una intuición. Eso, al menos, me dice que el camino tenía sentido.

He publicado PaellaDoc: la forma en la que llevo años desarrollando software, ahora convertida en una app y llevada hasta donde tenía que ir.

La tesis es sencilla: trabajar con IA no tiene por qué ser una caja negra, ni hacer a los desarrolladores product managers, ni a los PM, desarrolladores. Todos tienen su sitio en este dominio común que es el desarroll agéntico.

Si aúnas la disciplina de producto con la de desarrollo, puedes orquestar a Claude Code, Codex y Gemini sobre el mismo repositorio con el mismo rigor que sin IA.

El flujo se adapta a cómo trabajas, no al revés:

  • Si ya tienes un proyecto vivo, PaellaDoc hace reverse intake: extrae las User Stories, los Acceptance Criteria, las épicas y los
    PRDs que ya están implícitos en tu código y en tu historia.
  • Si tienes tus propios PRDs, los importas y se trabaja sobre ellos para generar código alineado.
  • Si vienes con tu metodología (Jobs to be Done, Shape Up, la tuya), la enchufas como plugin del SDK abierto.
  • Si arrancas en frío, defines lo que quieres y PaellaDoc te ayuda a estructurarlo con disciplina de producto.

A partir de ahí:

  • PaellaDoc reparte el trabajo entre Claude Code, Codex y Gemini con el contexto especializado de cada rol. También IA local como Qwen
    y otros, pero sinceramente eso lo he puesto y todavía no lo he probado.
  • Playwright Golden Gate verifica que la aplicación funciona de verdad antes de cerrar la tarea (en alfa).
  • Tú revisas algo terminado, con sus ACs cumpliéndose, no una conversación de 80 mensajes.

Algunos detalles importantes:

  • Por ahora solo Mac Apple Silicon. El resto vendrá si tiene sentido.
  • 100% local en tu máquina. Tú pones tus API keys o conectas tu cuenta de Claude Max o ChatGPT; nada pasa por mis servidores, por esto se pule los tokens que no veas, no lo intentes sin cuenta MAX o Codex caro.
  • Sin registros, sin cuenta, sin ataduras.
  • Telemetría sí, pero solo eventos anónimos de uso y errores para mejorar el producto , nunca tu código, prompts, archivos ni rutas.
    Activada por defecto, se apaga con un toggle en Ajustes (y al primer arranque la app te ofrece desactivarla con un click antes de enviar nada). Está documentada al milímetro en mi web.
  • Gratis para uso personal, y va a seguir siéndolo. Para uso comercial en empresa hay una licencia, es lo que me permitirá seguir
    trabajando en esto sin que la versión personal cambie. No he encontrado modelo más justo.

:warning: Importante: no me juzguéis como vendedor, porque no lo soy. Voy solo. Es gratis, es usable, y está lejos de ser perfecto. Habrá bugs, edge cases que no vi, decisiones de diseño discutibles y, sobre todo, cosas que TODAVÍA NO VAN.

Es lo que hay y prefiero enseñarlo así, en ALFA, que esperar a que parezca pulido en una demo.

Lo que más necesito ahora son críticas. Sobre todo las duras.

Lo que no entiendas, lo que te chirría, lo que sobra, lo que falta, lo que crees que está mal pensado. Usa este foro para hablarlo en serio , cada crítica concreta acaba siendo un issue que priorizo en abierto.

Mi disponibilidad para esto es el fin de semana, salvo algún rato. Te pido paciencia.

Y al final esto es lo que me importa de verdad:

Entre los puristas que dicen “la IA no debe escribir mi código” y los vibecoders que dejan que la IA lo escriba todo sin mirar, creo que hay un terreno medio. Un paradigma nuevo donde abrazas la herramienta, pero con la disciplina de siempre.

Quiero poner mi granito de arena ahí. Y aunque al final solo lo usemos yo y cuatro amigos, ya me vale. A mí me sirve cada día desde que hace un año decidí trabajar spec-driven, y luego introduje el sistema en Rankia.Por eso lo comparto.

Si te ayuda, repostea para que llegue a más gente. Si no te ayuda, escríbeme por qué ,en serio, eso me sirve más que un like.

PD: si pruebas la herramienta y te encuentras algo roto, dímelo aquí. Sin filtros. No me ofendo, me sirve.

1 me gusta