> ## Documentation Index
> Fetch the complete documentation index at: https://ai-first.falcux.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Blueprint AI-First

> La metodología para equipos que construyen con AI coding agents

<div style={{ textAlign: 'center', marginBottom: '48px' }}>
  **Diseña sistemas. Dirige ejecución. Cura contexto. Valida resultados.**
</div>

<CardGroup cols={3}>
  <Card title="Empezar a leer" icon="book-open" color="#57DBC4" href="/parte-1/costo-de-no-documentar">
    Capítulo 1 — El costo de no documentar
  </Card>

  <Card title="Descargar templates" icon="download" color="#57DBC4" href="/apendices/templates">
    7 templates listos para tu proyecto
  </Card>

  <Card title="Consulta interactiva" icon="comments" color="#57DBC4" href="https://notebooklm.google.com/notebook/9d5a4df3-4614-4eb6-beca-d936b632648b?authuser=1">
    Pregúntale a la documentación con NotebookLM
  </Card>
</CardGroup>

## El contexto

<Columns cols={2}>
  <Column>
    <Card title="Sin documentación" icon="triangle-exclamation" color="#F87171">
      Un MVP tuvo que reiniciarse **5 veces** buscando cómo mantener contexto entre sesiones de AI.
    </Card>
  </Column>

  <Column>
    <Card title="Con documentación" icon="circle-check" color="#57DBC4">
      Un equipo implementó en **2 horas** lo que hubiera tomado **1 sprint completo**.
    </Card>
  </Column>
</Columns>

<Card title="El dato que nadie cuenta" icon="clock" color="#FBBF24">
  Un tech lead tardó **11 horas** construyendo un prompt para un proyecto sin documentación.
</Card>

<Tip>
  La diferencia nunca fue la herramienta ni el modelo de AI. Fue la **calidad del contexto**.
</Tip>

## Qué vas a encontrar

<Steps titleSize="h3">
  <Step title="Parte I — Por qué documentar" icon="circle-question">
    El caso de negocio con datos reales. ROI medible de documentar antes de codear.

    <Card title="Leer Parte I" icon="arrow-right" href="/parte-1/costo-de-no-documentar" horizontal />
  </Step>

  <Step title="Parte II — Los fundamentos" icon="layer-group">
    La cadena de artefactos, AGENTS.md, guía de diseño evolutiva, skills y contexto.

    <Card title="Leer Parte II" icon="arrow-right" href="/parte-2/cadena-de-artefactos" horizontal />
  </Step>

  <Step title="Parte III — Protocolos operativos" icon="list-check">
    4 protocolos: UX, gestión de cambios, cierre de sesión y desarrollo de features.

    <Card title="Leer Parte III" icon="arrow-right" href="/parte-3/protocolo-ux" horizontal />
  </Step>

  <Step title="Parte IV — Escalar al equipo" icon="users">
    De individual a equipo. Onboarding, métricas, costos y herramientas.

    <Card title="Leer Parte IV" icon="arrow-right" href="/parte-4/escalar-y-costos" horizontal />
  </Step>
</Steps>

## Por dónde empiezo

<Tabs>
  <Tab title="Nuevo en AI coding" icon="seedling">
    Empieza por la **Parte I** y sigue en orden. Al terminar vas a tener tu primer proyecto configurado con todos los artefactos necesarios.

    <Card title="Empezar desde cero" icon="arrow-right" color="#57DBC4" href="/parte-1/costo-de-no-documentar">
      Capítulo 1 — Entiende por qué la documentación importa
    </Card>
  </Tab>

  <Tab title="Ya vibecodeé" icon="arrows-to-circle">
    Salta directo a los **protocolos** (Parte III) y descarga los **templates**. Formaliza tu flujo existente sin empezar de cero.

    <Card title="Ir a los protocolos" icon="arrow-right" color="#57DBC4" href="/parte-3/protocolo-ux">
      Protocolo UX — El primero que deberías implementar
    </Card>
  </Tab>

  <Tab title="Quiero adopción en equipo" icon="people-group">
    Lee el **caso de negocio** (Capítulo 1) para presentar con datos, y el **onboarding** (Capítulo 11) para planificar la adopción.

    <Card title="Ver caso de negocio" icon="arrow-right" color="#57DBC4" href="/parte-1/costo-de-no-documentar">
      Datos y ROI para convencer a tu equipo
    </Card>
  </Tab>
</Tabs>

## Templates listos para usar

7 archivos markdown que copias a la raíz de cualquier proyecto.

<AccordionGroup>
  <Accordion title="AGENTS.md" icon="brain" defaultOpen>
    El cerebro del proyecto. Reglas, comandos, restricciones, tech stack. La AI lo lee antes de cada tarea. Máximo \~150 líneas.
  </Accordion>

  <Accordion title="CLAUDE.md" icon="link">
    Una línea: `@AGENTS.md`. Conecta Claude Code con tu fuente de verdad sin duplicar contenido.
  </Accordion>

  <Accordion title="Protocolo UX" icon="compass">
    Navegación por capas, interacciones, estados, y checklist de verificación para que la AI no rompa la experiencia.
  </Accordion>

  <Accordion title="Protocolo de cambios" icon="code-compare">
    Gestión de requerimientos post-implementación. Cada cambio documentado antes de tocar código.
  </Accordion>

  <Accordion title="Protocolo de cierre" icon="flag-checkered">
    3 fases: AI documenta, humano verifica, humano cierra. La próxima sesión arranca con contexto completo.
  </Accordion>

  <Accordion title="Protocolo de features" icon="rocket">
    6 pasos antes de escribir código + secuencia de implementación validada.
  </Accordion>

  <Accordion title="Guía de diseño" icon="palette">
    Template evolutivo de 16 secciones: tokens, tipografía, componentes, responsive, accesibilidad. Crece conforme implementas.
  </Accordion>
</AccordionGroup>

<Card title="Descargar todos los templates" icon="download" color="#57DBC4" href="/apendices/templates">
  Ir a la página de descargas
</Card>

<Note>
  **Blueprint AI-First** es agnóstico de herramienta. Funciona con Claude Code, Cursor, Antigravity, Aider, Windsurf, o lo que venga después. Los principios no dependen de ningún proveedor.
</Note>