La biblia del proyecto. Todo change se valida contra estos principios. Si un change contradice este doc, el doc gana (o se actualiza explícitamente con aprobación del director).
Output de Fase 0 (Definir) del propio StackBrain — dogfooding: el producto se especifica a sí mismo con su propio método.
Dominio: stackbrain.dev · npm:
stackbrain· repo:github.com/curetcore/stackbrain· ecosistema VibeKit.
StackBrain es un framework para Claude Code que instala el cerebro de un founder senior dentro de tu proyecto.
No es un boilerplate ni un volcado de dotfiles. Es un framework de verdad — a la altura de los serios (Next.js, Rails): un CLI con runtime que genera, ensambla y orquesta la config; el markdown (.claude/) es el sustrato que Claude Code consume, no el producto.
- Objetivo primario (2026-05-29): uso personal del founder — un framework framework-grade que él usa a diario. La calidad es la vara, no la venta.
- Núcleo genérico, tu contexto encima: el framework es genérico y limpio (como Next.js no hornea tu lógica); tu contexto personal (CLAUDE.md global, memorias, stack default, proyectos) vive en TU capa, no en el core.
- Monetización = posible futuro, no el motor: si más adelante se vende, el modelo está esbozado (§7 — producto único de pago, lifetime). Pero NO dirige las decisiones de diseño. Anti-piratería: irrelevante para uso personal; para venta, el moat es updates + comunidad (modelo ShipFast), nunca DRM.
- Promesa: "Un comando, y tu Claude Code piensa como un equipo de Silicon Valley — sin que tú sepas cómo."
El vibe coding es rápido pero caótico: se codea sin mapa (Frankenstein de arquitectura) y sin contrato (Frankenstein de ejecución). Deuda técnica desde el día 1, proyectos inmantenibles a la semana 3.
StackBrain no le pide al vibe coder que sea disciplinado. Hornea la disciplina en su Claude Code — método, reglas, agentes y memoria — y deja que un cerebro embebido lo guíe. Un boilerplate te da código y te deja solo; StackBrain te da proceso vivo + un equipo senior embebido que se activa solo.
| Componente | Qué es | Vive en | |
|---|---|---|---|
| 1 | 🧠 Método | Las 8 fases enterprise — el ORDEN | docs/audits/pipeline.md |
| 2 | 📐 OpenSpec | Spec antes de código — el MÉTODO | openspec/ |
| 3 | ⚙️ Boilerplate | Simplify enterprise (auth + pagos + DB + Sentry + R2) como base; starter-lite (Next.js mínimo) si aún no activaste |
el proyecto generado |
| 4 | 🔄 Continuidad | /cerrar + SessionStart — memoria entre sesiones |
.claude/ (hook + loop) |
| 5 | 📋 Presets CLAUDE.md | Las reglas que hacen a Claude trabajar nivel senior, por tipo de proyecto | .claude/CLAUDE.md |
| 6 | 🤖 Agentes | El equipo de subagentes (architect, appsec, reviewer, db, ui, testing, devops...) | .claude/agents/ |
5 y 6 son el diferenciador. El CLAUDE.md + los agentes son el software del cerebro — lo que convierte "Claude Code normal" en "Claude Code nivel founder". Nadie más empaqueta esto.
El mapeo Método→OpenSpec: cada fase genera changes/. Fase 0 → project.md + blueprint. Fase 3 → changes/add-security-*. StackBrain decide QUÉ change y CUÁNDO; OpenSpec ejecuta cada uno con spec.
El loop de continuidad: SessionStart lee estado → trabajo guiado → /cerrar guarda estado → mañana retoma. Sin /cerrar, todo lo demás se desinfla en la 2da sesión.
| Persona | Quién | Qué necesita |
|---|---|---|
| Vibe coder | Construye con Claude/Cursor sin proceso. Ships rápido, se ahoga en deuda. | Que su Claude Code lo guíe solo, nivel enterprise, sin estudiar metodología |
| Comprador PRO | Indie hacker / dev que quiere ship serio ya. Ha visto ShipFast y entiende el valor de un kit. | El arsenal completo (agentes + modos + presets) + comunidad + soporte. Pagar una vez y tener el setup de un founder |
| Founder (el director) | Empaqueta su método como producto VibeKit | Distribuir su forma de trabajar, monetizar el arsenal, sin regalar su contexto personal |
stackbrain activate <key> # una vez por máquina
→ registra la licencia en ~/.stackbrain/license.json
stackbrain mi-app # nace con TODO
→ Simplify enterprise (auth+pagos+DB+Sentry+R2) + cerebro + 11 /modo* +
19 agentes + presets enterprise, desplegados de una vez
cd mi-app && claude
→ "Estás en Fase 0. Vamos a definir tu producto. ¿Quién es tu usuario?"
→ te guía fase por fase, con el equipo senior entero · /cerrar guarda al cerrar
Sin licencia activada, stackbrain mi-app nace sobre starter-lite (Next.js mínimo) + el cerebro, con un CTA a activate. El usuario nunca invoca nada manual — el cerebro lo lleva.
El markdown (.claude/) es el sustrato que Claude Code consume (commands/agents/skills/CLAUDE.md son md por diseño). Lo que lo eleva de "volcado de dotfiles" a framework es la capa de tooling alrededor. Cuatro piezas (decisión 2026-05-29: las cuatro en v1):
- CLI real (no un copiador de una vez), estilo
rails/next:new(scaffold) ·status(computa fase/progreso del estado real) ·add <agente|skill>(extensibilidad) ·update(trae versión nueva + reconcilia) ·doctor(verifica el setup) ·audit <modo>. - Orquestación programática (Claude Agent SDK) — el diferenciador: los pipelines pesados (auditorías, sweeps, migraciones) shippean como código real, no como markdown que reza.
stackbrain audit <modo>corre un pipeline multi-agente determinista (el mismo patrón fan-out + verify de los workflows ya probados). Esto es lo que lo pone a la altura de un framework serio y es lo más difícil de copiar (foto-muerta vs capacidad-viva). - Assembler — el
.claude/se genera a la medida de tu stack desde módulos (founder: server propio + Postgres + R2; vibecoder: Vercel + Supabase), no se copia el dump completo. - Manifest + versionado — versión del framework + manifiesto de componentes;
updatereconcilia. Como un package manager para tu setup de Claude.
- Config substrate (
.claude/):settings.json(hooks SessionStart/SessionEnd +.mcp.jsoncon context7 precargado),CLAUDE.md(preset ensamblado por stack),commands/,agents/,state/. - MCPs: el brain precarga los zero-config (context7 — bonus: ataca la frescura); los que piden auth (github, etc.) se guían en el primer inicio. Nunca se shippean credenciales.
- Stack: agnóstico, default vibecoder = Vercel + Supabase + Next.js; el founder configura su propio server. El cerebro pregunta/detecta y adapta.
Producto único de pago (decisión #27, 2026-05-31). Un solo StackBrain, completo, lifetime — estilo ShipFast. No hay free tier ni catálogo à la carte: pagas una vez, lo tienes entero, proyectos ilimitados. El gate parte acceso (tienes la llave o no entras), no features.
- Precio: lifetime ilimitado (rango ShipFast, $199–349; se fija al lanzar). Pago único, sin suscripción ni cobro por uso (#28).
- BYO-API-key: el usuario corre el motor con su propio plan/API key de Claude. StackBrain nunca toca la factura de IA de nadie — cero costo variable, cero margen-sobre-tokens (#25, #28).
- Argumento de venta clave: arsenal siempre actualizado (dogfooded) — el founder lo usa en todos sus proyectos → updates vivos batidos en producción real. No es un kit muerto.
- Anti-piratería = cero DRM (#29): el producto es markdown+JS, copiable por diseño. El moat son los updates vivos + comunidad (modelo ShipFast), no candados. El torniquete (key + activate + R2 gateado) detiene al casual y registra al comprador, nada más.
- Multi-IDE honesto (#30, #31): Claude Code full; Cursor/Codex con el cerebro + agentes + método (orquestación por terminal); Antigravity experimental. Un solo precio para todos; la compatibilidad por herramienta se comunica sin letra chica.
- Comparables: ShipFast (Marc Lou, ~$199–299, $1M+ lifetime), TrustMRR, ByeDispute.
- Plataforma de licencias: el motor propio (004) — Stripe + Cloudflare Worker + D1 + R2. license key →
stackbrain activate <key>.
Nota: el modelo previo (freemium + catálogo à la carte + bundle + star-gate, decisiones #3/#13/#14/#15) fue jubilado por #27. El "free era una ilusión" — el diferenciador estaba 100% tras el muro, y el free-capado solo complicaba la lógica sin entregar la promesa.
- Manual completo para todo comprador — qué hace StackBrain, cómo manejar e invocar los agentes, cómo usar los comandos, consejos y tips. Refuerza la marca @ronaldships. NO un curso sobre los proyectos del founder — StackBrain brilla solo.
- Fuente: auditar el manual de VibeKit y reformular el contenido genérico/metodológico hacia StackBrain.
StackBrain es un solo organismo completo. Al activar la licencia, el proyecto nace con todo:
| Componente | Incluido |
|---|---|
Cerebro /stackbrain (detecta fase, guía, continuidad) |
✅ |
| Método (8 fases) + OpenSpec + Continuidad | ✅ |
| Boilerplate Simplify enterprise (Catalyst + auth + pagos + DB + Sentry + R2) | ✅ |
| Presets CLAUDE.md enterprise (SaaS / ecommerce / mobile / API) | ✅ |
| 19 agentes (architect, appsec, reviewer, db, ui, testing, devops…) | ✅ |
11 /modo* (auditorías enterprise como pipelines multi-agente reales) |
✅ |
| Manual completo | ✅ |
| Comunidad de fundadores + soporte + updates constantes | ✅ |
Sin licencia activada, stackbrain mi-app nace sobre starter-lite (Next.js mínimo) + el cerebro, con un CTA a activate — una puerta honesta, no un demo capado.
El arsenal está en core/arsenal/ (2026-05-29, reorganizado 2026-05-31): preset enterprise maestro + 19 agentes + 11 /modo* + 11 skills enterprise. StackBrain no depende de ningún kit externo. Se entrega gateado por el motor de licencias (004) vía R2. Detalle en changes/add-kit-pro.
Out of scope: contexto personal del founder (memorias, CLAUDE.md global, MCPs con credenciales — intransferible) · telemetría · múltiples starters al inicio.
Foco 2026-05-29: calidad framework-grade para uso personal. La venta es posible futuro, no driver. El orden cura el core antes de añadir tooling.
Core (el cerebro + el arsenal):
- ✅ El cerebro — comando dinámico + preset + primer inicio. →
add-brain-core(000) - ✅ El CLI seed —
npx stackbraininstala el cerebro. →setup-cli-mvp(001) - ✅ Brownfield no-destructivo —
stackbrain initañade a proyectos ya empezados sin romper nada (del dogfooding Karrito). →add-brownfield-init - ✅ Auditar + curar el arsenal — 33 auditados, 29 curados (decouple + freshness + bugs), 4 cortados a
_backlog/. →add-kit-pro
Lo que lo hace framework (no dotfiles) — las 4 piezas en v1:
- ⬜ CLI real —
status/add/update/doctor(más allá denew). →add-framework-cli - ⏸️ Orquestación Agent SDK —
stackbrain audit <modo>como pipeline de código. Bajado a apuesta opcional de pre-venta (#33) — redundante con los/modo*markdown para uso personal. Construido y dormido; no se invierte más hasta que la venta lo pague. →add-orchestration-sdk - ⬜ Assembler por stack + manifest versionado — config a la medida +
updateque reconcilia. → (parte deadd-framework-cli) - ⬜ Docs de framework — lo que separa un framework serio de un kit.
Posible futuro (monetización — NO driver): producto único de pago (#27) → arsenal add-kit-pro (entrega) · licencias add-license-engine (motor 004) · landing add-landing-stackbrain-dev · manual. (El star-gate se canceló con el pivote — #32.)
- El vibe coder no aprende metodología — la metodología lo guía. Cero fricción.
- Lo gratis demuestra; lo pago entrega. El free es marketing, el PRO es el arsenal.
- Dar el arsenal, no el contexto. El PRO incluye modos + agentes + presets. La ventaja del founder es su contexto + ejecución + marca — intransferible.
- Dogfooding. StackBrain se construye con StackBrain.
- Anti-Frankenstein doble. Orden macro (fases) + spec micro (OpenSpec).
- Enterprise sin deudas. En orden, limpio, al más alto nivel. Sin prisa, sin atajos.
- Marc Lou. Vende antes de construir. La mejor feature es la que no existe.
- Voz dominicana, tuteo. Cero voseo, cero anglicismos cazables.
⚠️ Pivote 2026-05-31 — producto único de pago. Las decisiones #3, #9, #11 (manual bloqueado), #13, #14, #15 quedaron jubiladas por el pivote del modelo freemium a un solo producto de pago (ver #27-#32 abajo). Las secciones §3/§5/§7/§8 ya fueron reescritas al modelo nuevo (changecollapse-free-pro, Fase F). El manual es completo para todo comprador (sin secciones bloqueadas).
| # | Decisión |
|---|---|
| 1 | StackBrain pivota de visualizador a "cerebro de Claude Code" (viejo en stackbrain-viewer-legacy) |
| 2 | Producto = 6 componentes: método + OpenSpec + boilerplate + continuidad + presets CLAUDE.md + agentes |
| 3 | Modelo: freemium / open-core. Gratis = anzuelo; PRO = arsenal |
| 4 | Precio PRO $199 founder/preventa → $349 regular, lifetime ilimitado (ShipFast-aligned; ancla $999 descartada por asustar al indie) |
| 5 | Distribución: npx stackbrain (gratis) + stackbrain.dev (PRO) |
| 6 | Dominio stackbrain.dev adquirido |
| 7 | Construcción dogfooding con OpenSpec — en orden, sin deudas, enterprise |
| 8 | 3 frentes en orden: landing → kit PRO → licencias |
| 9 | Star-gate: el free se "paga" con una estrella en GitHub. Mecanismo device-flow consensual semi-hard (2026-05-29): OAuth device flow → verifica/ofrece poner la estrella con 1 tecla → cachea. Si rechaza autorizar, procede pero sigue pidiendo. Infra: OAuth App + 1 Cloudflare Worker para el token exchange |
| 10 | PRO siempre actualizado — el founder lo usa en todos sus proyectos → updates vivos. Argumento de venta clave |
| 11 | Manual gratis (lead-magnet, refuerza @ronaldships) + PRO profundo, con secciones PRO bloqueadas en el free (teaser/FOMO). Enfocado en StackBrain + agentes, NO en proyectos del founder |
| 12 | StackBrain brilla solo — no sobre-mencionar otros proyectos del founder en docs/landing/manual públicos |
| 13 | Cerebro free con manos vacías (2026-05-29): /stackbrain es free y guía las 8 fases, pero los /modo* + 21 agentes son PRO → el free camina al usuario hasta el upsell en Fase 3 Gates |
| 14 | Reframe a plataforma/catálogo (2026-05-29): no es "un CLI con cerebro", es un catálogo de componentes de founder senior. Cada pieza vale sola |
| 15 | Modelo híbrido catálogo (2026-05-29): free (anzuelo, star-gate) + à la carte (CLAUDE.md / pack agentes / skills sueltos) + bundle "arsenal completo" $199/$349. Regla: bundle < suma de partes. Empezar chico |
| 16 | Vender pieza por pieza impone auditar el arsenal (2026-05-29): los 21 agentes + 11 skills + 11 modos deben aguantar venta individual (al día, sin deudas) ANTES de la landing |
| 17 | Orden corregido (2026-05-29): primero producto de valor + curar deudas + visión; la venta/landing va DESPUÉS |
| 18 | Uso personal primero (2026-05-29): StackBrain es un framework framework-grade para uso del founder. La calidad es la vara. Monetización = posible futuro, NO el driver de diseño |
| 19 | Núcleo genérico + capa personal: el framework es genérico/limpio; el contexto del founder (CLAUDE.md global, memorias, stack, proyectos) vive en SU capa, no horneado en el core |
| 20 | Licencia (si se vende): lifetime ilimitado, aceptar copiable, moat = updates vivos + comunidad (ShipFast). Cero DRM / cero lock-por-proyecto (imposible en markdown, hostil al comprador) |
| 21 | Stack agnóstico, default Vercel + Supabase para vibecoders; founder usa server propio + Postgres + R2. El cerebro pregunta/detecta y adapta |
| 22 | MCPs: precargar zero-config (context7 — ataca frescura); auth-MCPs (github) guiados en onboarding; nunca shippear credenciales |
| 23 | Framework, no dotfiles (2026-05-29): las 4 piezas de tooling en v1 — CLI real (new/status/add/update/doctor/audit) + orquestación Agent SDK (audits/sweeps como código) + assembler por stack + manifest versionado. El markdown es sustrato, no producto |
| 24 | Brownfield no-destructivo (2026-05-29, del dogfooding Karrito): stackbrain init añade a proyectos ya empezados sin tocar lo existente (CLAUDE.md/openspec/state/docs respetados, settings.json merge con backup, sidecar para CLAUDE.md). Usa el cerebro global sin duplicar (cero drift) o --embed. El retrofit fino (consolidar Frankensteins, doblar reportes a fase) lo hace el cerebro en S2, no el CLI |
| 26 | Simplify enterprise es PRO, no free (2026-05-31): el boilerplate completo (Catalyst + NextAuth v5 + Prisma 7 + Stripe + R2 + Sentry + Resend) equivale a un ShipFast ($199+) y el repo es privado → gatearlo es viable y justo. El free arranca sobre Next.js mínimo (create-next-app) + el cerebro; Simplify se desbloquea con la licencia y se entrega vía el R2 gateado de 004 (mismo motor de licencias, cero fricción nueva). El "wow" del free es el cerebro que guía, no el scaffold; el boilerplate enterprise es el upsell tangible (touchpoint en Fase 2). No fragmentar Simplify en lite/full (anti Marc Lou) — full a PRO, mínimo al free |
| 25 | Auth del motor = cada quien autogasta su propia cuenta (2026-05-29): el orquestador (stackbrain audit) es auth-agnóstico — el Agent SDK usa la sesión de Claude Code del usuario (su plan; desde 15-jun-2026 un crédito mensual de Agent SDK separado; cero pago-por-token) o su ANTHROPIC_API_KEY si la exporta. StackBrain vende el arsenal, no el compute — nunca toca la factura de Claude de nadie (cero costo variable, cero margen-sobre-tokens, ShipFast-aligned). La restricción de los Commercial Terms aplica a ofrecer login claude.ai en el producto, no a que el usuario use su propia auth; al vender, el camino sin dudas es la API key del comprador (o su propio Claude Code bajo sus términos) |
| 27 | Producto único de pago — se colapsa free/pro (2026-05-31): StackBrain deja de ser freemium. Un solo organismo completo, lifetime, estilo ShipFast. El gate parte acceso (tienes la llave o no entras), no features. Se eliminan: el tier free, los 11 teasers, el split del conocimiento (orchestrator/skills ↔ kit-pro/skills), la narrativa de upsell y los touchpoints de Fase 3. Jubila #3, #13, #14, #15; reescribe §3/§5/§7/§8. El refactor vive en el change collapse-free-pro. Razón: el free era una ilusión — el diferenciador (agentes + modos reales + motor) está 100% tras el muro; el free-capado solo entorpecía la lógica sin entregar la promesa |
| 28 | Lifetime ilimitado + BYO-API-key (2026-05-31, reafirma #4/#25): pago único, uso ilimitado, sin suscripción ni cobro por-uso. StackBrain nunca toca la factura de IA de nadie — el usuario corre el motor con su propio plan/key. Cero costo variable → cero razón para limitar uso |
| 29 | Cero DRM (2026-05-31, reafirma #20): no se puede ni se debe evitar la copia de markdown+JS. El torniquete educado (key + activate + R2 gateado de 004) detiene al casual y registra al comprador; el moat real son updates vivos (dogfooded) + comunidad. No invertir más en anti-piratería |
| 30 | Multi-IDE: core/ neutro + assembler (2026-05-31): el contenido (reglas, agentes, método, skills) vive en un core/ neutro, NO atado a .claude/; un assembler lo transpila por target. Claude Code = tier-1 full nativo. El motor (stackbrain audit) corre como CLI universal en cualquier terminal (desacoplado del IDE) y orquesta con Claude (Agent SDK). Los adaptadores de config (Cursor/Codex/AGENTS.md) se añaden on-demand, no especulativo (Marc Lou). AGENTS.md como formato franco emergente |
| 31 | Tiers de soporte honestos (2026-05-31): la compatibilidad por herramienta es contrato técnico y copy de landing, sin letra chica. 🟢 Claude Code full · 🟡 Cursor/Codex (capacidad sí, integración no — orquestación por terminal) · 🔵 Antigravity experimental. Un solo precio para todos — el comprador decide con los ojos abiertos. La honestidad como feature de marca |
| 32 | Star-gate (006) matado + starter/ degradado (2026-05-31): el star-gate era el mecanismo del free (estrella de GitHub a cambio del acceso gratis); sin free no tiene sentido → se cancela el change add-star-gate. Jubila #9. El free scaffold starter/ (hecho 2026-05-31) pierde su rol central → opción "lite" o archivo; Simplify es la base por defecto del scaffold |
| 33 | Motor SDK bajado de "diferenciador v1" a apuesta opcional de pre-venta (2026-06-01): los /modo* ya son slash commands markdown que Claude Code ejecuta nativamente (cero fricción, cero terminal nativa, cero API key) → para uso personal el motor stackbrain audit (Agent SDK) es redundante. Solo aportaría a la venta (reporte reproducible para comprador no-técnico / CI sin sesión), y ni eso es must (ShipFast vende $1M+ sin motor SDK; el moat son arsenal curado + updates vivos + cerebro). Lo que separa a StackBrain de "dotfiles" ya lo cubre el CLI real (001c: status/add/update/doctor + assembler + manifest), no el SDK. Decisión del director: ni un minuto más invertido en 001d hasta que un comprador real lo pague. Queda construido y dormido (verificado sin tokens); si nunca se vende, no se publica. Cuidado sunk cost: estar "casi hecho" NO es razón para terminarlo. Matiza #23 (la pata "orquestación Agent SDK" deja de ser obligatoria en v1) |