PaellaDoc is an agentic development orchestrator: it coordinates AI coding engines (Claude, Codex, Gemini), captures decisions as artifacts, and verifies output against real user-facing behaviour.
🇬🇧 English
The honest pitch: PaellaDoc is a local orchestrator that coordinates AI coding engines and refuses to mark any work as done without verifiable evidence.
What it is not
- It is not a code generator. PaellaDoc does not write code itself.
- It is not a chat in your IDE. It is not a Copilot alternative for autocomplete.
- It is not a cloud SaaS. Your code never leaves your machine.
What it actually does
- Connects to one or more engines you already have installed: Claude Code (via CLI, subscription-based), Codex, or Gemini. PaellaDoc orchestrates them — you bring the engine.
- Structures the work as artifacts: PRD, epic, user_story, acceptance_criteria, decision_record. These are canonical types (not customizable jargon) so any method pack speaks the same language underneath.
- Runs the engine in isolated git worktrees: each agent session lives in its own worktree, no cross-contamination, cleanup guaranteed.
- Verifies every claim through the Golden Gate: a user story only passes when the engine produces a screenshot, a passing Playwright test, a non-empty diff, and an intact WAL hash. No “trust me bro” completion.
- Streams everything live: SSE-based logs of what the engine is doing, right now, on your screen. No speculative execution that turns out to be wrong later.
Why this exists
Because every other AI coding tool optimizes for the demo. PaellaDoc optimizes for the moment three months later when a junior engineer reads the code and asks “why was this decided this way?” The decision_record is there. The evidence is there. The acceptance criterion is there in Gherkin. The screenshot is there.
Boring? Yes. Boring is the feature.
🇪🇸 Español
El pitch honesto: PaellaDoc es un orquestador local que coordina motores de programación con IA y se niega a marcar como hecho ningún trabajo sin evidencia verificable.
Lo que no es
- No es un generador de código. PaellaDoc no escribe código por sí mismo.
- No es un chat en tu IDE. No es una alternativa a Copilot para autocompletar.
- No es un SaaS en la nube. Tu código nunca sale de tu máquina.
Lo que sí hace
- Conecta con uno o más motores que ya tengas instalados: Claude Code (vía CLI, con suscripción), Codex o Gemini. PaellaDoc los orquesta — tú aportas el motor.
- Estructura el trabajo como artefactos: PRD, epic, user_story, acceptance_criteria, decision_record. Son tipos canónicos (no jerga personalizable) para que cualquier method pack hable el mismo idioma por debajo.
- Ejecuta el motor en worktrees git aislados: cada sesión de agente vive en su propio worktree, sin contaminación cruzada, limpieza garantizada.
- Verifica toda afirmación a través del Golden Gate: una user story solo pasa cuando el motor produce un screenshot, un test de Playwright verde, un diff no vacío y un hash WAL íntegro. Nada de “créeme, está hecho”.
- Transmite todo en vivo: logs basados en SSE de lo que el motor está haciendo, ahora mismo, en tu pantalla. Sin ejecución especulativa que después resulta ser errónea.
Por qué existe esto
Porque todas las otras herramientas de IA para programar optimizan para la demo. PaellaDoc optimiza para el momento tres meses después cuando un ingeniero junior lee el código y pregunta “¿por qué se decidió esto así?”. El decision_record está ahí. La evidencia está ahí. El criterio de aceptación está ahí en Gherkin. El screenshot está ahí.
¿Aburrido? Sí. Lo aburrido es la feature.