Documentación técnica

BossDream

Framework de control de calidad para Claude Code. Las reglas se aplican mediante hooks que ejecuta el propio Claude Code, no mediante instrucciones en el prompt, y el agente solo puede dar una tarea por terminada cuando el pipeline pasa y existe evidencia de ello.

Guía de instalación Flujos de trabajo

Principios de diseño del motor

Las reglas son código

Una regla implementada como script determinista no depende de que el modelo la recuerde, y no consume tokens.

Auditoría independiente

Quien implementa no valida su propio trabajo. Los auditores corren en un contexto separado y devuelven un veredicto estructurado.

Completitud y sobriedad

La escalera anti-sobreingeniería y la autorevisión del plan: cada paso con su fuente y su porqué.

Sin afirmaciones sin sustento

Toda afirmación debe anclarse en el código o en lo que dijo el usuario. Ante una ambigüedad, el agente pregunta en una sola tanda.

Falla rápida

Las etapas baratas (build, formato) corren antes que las caras (E2E, mutation testing). Si una falla, no se ejecutan las siguientes.

Consumo de tokens acotado

Scripts en lugar de instrucciones, subagentes de contexto desechable, exploración en cascada y una sola línea de salida cuando todo pasa.

Separación entre plan e implementación

/bossdream-plan no puede escribir código. Solo el usuario cruza la frontera con /bossdream-implement.

El motor no sabe de tu stack

Lee pipeline.json. Los comandos concretos los aporta un pack de lenguaje.

Arquitectura de plugins

Primeros pasos

Instalación

Desde el marketplace hasta el primer plan, en cinco pasos.

Requisitos

Requisito	Detalle
Claude Code	Versión con soporte de plugins, hooks y skills (`/plugin`).
PowerShell 7 (`pwsh`)	Obligatorio en Windows, Linux y macOS. Windows: `winget install Microsoft.PowerShell`.
Node.js y uv	Los MCP usan `npx`; solo Serena usa `uvx`.
git	Para instalar desde el marketplace.
Runtime del stack	.NET SDK con `bossdream-dotnet`, Node con `bossdream-nodejs`.

Probado en Windows (PowerShell 5.1 y 7) y Ubuntu con CI en cada push. macOS no se ha probado.

Añade el marketplace e instala el motor

/plugin marketplace add MiguelALRendon/BossDream
/plugin install "bossdream-core"@bossdream

3
Instala el pack de tu lenguaje (solo uno)
```
/plugin install "bossdream-dotnet"@bossdream
/plugin install "bossdream-nodejs"@bossdream
/reload-plugins
```
Elige una de las dos primeras líneas. Instalar ambos solo tiene sentido en un monorepo real.

Responde la configuración

Opción	Qué es	Default
`db_dsn`	DSN de una base SQL que `dbhub` consulta solo en lectura. Se guarda en el keychain.	vacío
`enable_read_budget_hook`	Reencamina lecturas y búsquedas amplias para ahorrar tokens.	`true`

5
Inicializa tu proyecto
```
/bossdream-init
```
Es idempotente y no pisa lo que ya tengas. Copia los hooks a .claude/bossdream-hooks/, fusiona settings.json y te dice qué rellenar: docs/constitution.md y tus notas en docs/_inbox/.
```
/docs-rewrite
/plan-new mi-feature
/bossdream-plan quiero exportar facturas a Excel
```

Actualizar

/plugin marketplace update bossdream
/reload-plugins
/bossdream-sync

Desinstalar

/plugin uninstall "bossdream-core"@bossdream

Ciclo de trabajo completo

Solicitud de la funcionalidad. El agente detecta que no es trivial y activa /brainstorming para acordar el diseño.
Plan por increments. Cada increment pasa su revisión de diseño antes de escribirse a plan.md.
Inicio de la implementación. /bossdream-implement ejecuta un increment y se detiene a pedir permiso.
Verificación con el hook Stop. Si el pipeline falla, el agente continúa trabajando y no puede dar la tarea por terminada.
Cierre. Verificación final y regreso a modo plan. El agente nunca hace commit; esa decisión es del usuario.

Referencia

Pipeline de calidad

Once etapas ordenadas por costo de ejecución. El motor es agnóstico: los comandos los aporta el pack de lenguaje.

Tier local: lo corre el Stop hook, en segundos. Tier ci: lo corre el CI completo. Las etapas apagadas exigen infraestructura que ningún template puede asumir. Mutation testing es de bloqueo duro con testing.enabled=true.

Completion Criteria

Referencia

Configuración

Archivos de proyecto, hooks y mecanismos de excepción.

Archivo	Dónde	Para qué
`bossdream.json`	raíz	plan-lock, extensiones de código, pruebas, estilos, `qa.mode` y ruteo de modelos
`pipeline.json`	raíz	Etapas del pipeline y toggles
`completion.json`	raíz	Gates del Completion Criteria y `maxBlocks`
`.claude/settings.json`	proyecto, versionado	Plugins, permisos, marketplace y hooks
`.claude/settings.local.json`	proyecto, ignorado	Overrides personales
`.claude/rules/comentarios.md`	proyecto	Regla de comentarios

Hooks

Hook	Evento	Qué hace
`readiness`	UserPromptSubmit	Fija `.work-mode` según el comando y recuerda crear `plans/`
`active-project-context`	UserPromptSubmit	Inyecta el contexto del proyecto activo
`plan-lock`	PreToolUse · Edit, Write	Niega editar código en modo no editable o sin spec en rutas de dominio
`comment-check`	PreToolUse · Edit, Write	Niega bloques multilínea, separadores decorativos y breadcrumbs de IA
`command-lock`	PreToolUse · Bash	Niega `rm -rf /`, `git reset --hard`, `git push --force`
`read-budget`	PreToolUse · Read, Grep, Glob	Reencamina lecturas amplias (opcional)
`mark-dirty`	PostToolUse	Marca que el turno editó código
`sync-agent-models`	PostToolUse	Sincroniza el modelo de cada agente con `bossdream.json`
`stop-completion`	Stop	Evalúa el Completion Criteria y bloquea el cierre si falla
`validation-lock` · `plan-context-inject`	UserPromptSubmit	Gobernanza: bloquean o alimentan `/bossdream-plan` según el Document Validation
`mark-project-dirty` · `project-sync`	PostToolUse · Stop	Gobernanza: reabren documentos editados y regeneran la trazabilidad

Mecanismos de excepción

Saltar el gate una vez

/pipeline skip --reason "…" queda registrado, no es silencioso.

Apagar el hook de tokens

enable_read_budget_hook: false al configurar el plugin.

Desbloquear la gobernanza

/bossdream-override destraba una invocación bloqueada por validation-lock.

Modo nuclear

"disableAllHooks": true en settings.json. Desaconsejado y visible en la config.