SOP — Cómo Arrancamos y Operamos Proyectos en GNB Labs

Regla de oro

No existe milestone sin PRD aprobado. No se escribe código sin que exista un PRD revisado y confirmado.

Esto aplica para proyectos de clientes, proyectos internos, y cualquier feature que tome más de un día de trabajo.

SOP 1 — Proyecto Nuevo

Un proyecto nuevo es cualquier cosa que implique crear un repo, un cliente nuevo, o una herramienta interna que no existía.

Paso 1 — Discovery

Skill: /preguntas-discovery

Antes de proponer cualquier solución, entender el problema. Este skill guía la conversación para extraer: qué dolor tiene el cliente, quiénes son los usuarios, qué espera que haga el sistema, y qué tiene hoy.

Output: Entendimiento del problema documentado.

Paso 2 — PRD

Skill: /prd-gnb

Convierte el discovery en un PRD estructurado mediante una entrevista en fases. Define el QUÉ — no el cómo. El agente que construya el proyecto solo necesita leer este archivo para saber exactamente qué tiene que hacer.

Output:

_build_plan/prd.md — qué construimos, para quién, milestones
_build_plan/milestones/N-slug/prompt.md — prompt listo para el agente constructor
AGENTS.md — instrucciones para cualquier agente que trabaje en el proyecto
llms.txt — contexto estructurado para LLMs

Regla: No avanzar al paso 3 sin PRD aprobado por Gabriel o el PM.

Paso 3 — Arquitectura (si hay que cotizar)

Skill: /arquitectura-proyecto

Genera el plano técnico completo: schema de base de datos, estimados de horas por fase, costos de infraestructura, checklist de launch. Se usa para presentar al cliente y para que el equipo tenga claro el scope de trabajo.

Output: CLAUDE.md con arquitectura, schema, estimados y costos.

Cuándo usarlo: Siempre que el proyecto va a un cliente. Opcional para proyectos internos simples.

Paso 4 — Propuesta al cliente

Skill: /propuesta-contrato

Genera la propuesta profesional lista para enviar, más el contrato. Usa como input el PRD y la arquitectura del proyecto.

Paso 5 — Onboarding del cliente (cuando paga)

Este es el momento en que se crea Linear. No antes.

Qué hacer:

Crear proyecto en Linear: {Cliente} — {Nombre Proyecto}
Crear un Cycle por cada milestone del PRD
Crear labels: feature, bug, feedback, question, cliente
Invitar al cliente como Guest en Linear
Enviar al cliente la URL del proyecto con la explicación: "Aquí puedes ver el avance, reportar bugs y dejar feedback"

Acceso del cliente en Linear:

✅ Puede ver el roadmap y el estado de cada issue
✅ Puede crear issues nuevos (bugs, preguntas, feedback)
❌ No puede asignar issues ni cambiar prioridades
❌ No puede crear ni modificar Cycles

Regla de comunicación: Todo feedback entra como Issue en Linear. Si el cliente manda algo por WhatsApp o email, el PM lo convierte en Issue antes de hacer cualquier cosa con esa información.

Paso 6 — Build, milestone por milestone

Por cada milestone:

Abrir _build_plan/milestones/N-slug/prompt.md
El agente entra en plan mode y propone la implementación
Confirmar el plan antes de construir
El agente construye
El agente escribe milestone-log.md en esa carpeta
QA: /qa
Deploy: /deploy
Marcar el Cycle como Done en Linear
Avisar al cliente dentro del issue de Linear

Árbol de archivos al arrancar el build

proyecto/
├── CLAUDE.md                    ← arquitectura técnica
├── AGENTS.md                    ← instrucciones para agentes
├── llms.txt                     ← contexto para LLMs
└── _build_plan/
    ├── prd.md                   ← qué construimos
    └── milestones/
        ├── 1-fundacion/
        │   └── prompt.md
        ├── 2-features-core/
        │   └── prompt.md
        └── 3-polish/
            └── prompt.md

SOP 2 — Feature Grande en Proyecto Existente

Un feature grande es cualquier cosa que tome más de un día o que agregue una capacidad nueva significativa. No aplica para bugs, ajustes visuales o cambios de copy.

¿Necesita PRD?

| Situación | ¿PRD? | |-----------|-------| | Bug fix o ajuste visual | No | | Cambio de copy o contenido | No | | Feature nuevo (nueva pantalla, flujo, integración) | Sí | | Refactor que cambia comportamiento del usuario | Sí | | Integración con servicio externo | Sí siempre |

Pasos

1. PRD del feature — /prd-gnb

El skill detecta automáticamente que es un feature dentro de un proyecto existente (no un proyecto nuevo) y genera:

_build_plan/features/{feature-slug}/prd.md
Milestone prompts del feature

2. Crear issues en Linear

Crear el Issue principal del feature en el proyecto del cliente en Linear. Crear sub-issues por milestone. Asignar al dev correspondiente.

3. Build

Mismo proceso que el paso 6 del SOP 1. Leer prompt.md, construir, escribir log, QA, deploy, avisar al cliente en el issue.

Linear — Convenciones del equipo

| Elemento | Convención | |----------|-----------| | Nombre del proyecto | {Cliente} — {Nombre} o solo {Nombre} si es interno | | Milestone | Cycle en Linear | | Estado del cycle | Planned → In Progress → Done | | Issues del cliente | Label cliente | | Bug del cliente | Labels bug + cliente | | Feedback/idea del cliente | Labels feedback + cliente | | Pregunta del cliente | Labels question + cliente | | Acceso del cliente | Guest | | Canal de comunicación | Solo dentro de Linear |

Skills del ecosistema

| Skill | Cuándo usarlo | |-------|--------------| | /preguntas-discovery | Antes de proponer cualquier solución | | /prd-gnb | Antes de cualquier milestone — siempre | | /arquitectura-proyecto | Para cotizar o cuando necesitas el schema técnico | | /propuesta-contrato | Para enviar propuesta y contrato al cliente | | /calculadora-precio | Para calcular el precio correcto basado en valor | | /naira | Para gestionar Linear, Harvest y Slack desde Claude | | /qa | Después de cada milestone | | /deploy | Para hacer deploy | | /triage | Revisión diaria del estado de Linear |

Roles

| Paso | Responsable | |------|------------| | Discovery | Gabriel o PM | | PRD | Gabriel o PM (con /prd-gnb) | | Arquitectura | Gabriel o dev senior | | Propuesta/Contrato | Gabriel | | Onboarding Linear | PM | | Build | Dev (agente o humano) | | QA | Dev o PM | | Deploy | Dev | | Comunicación en Linear | PM o Gabriel |