Sistema de Agentes Claude

NappAI Fluency usa Claude Code como agente de desarrollo asistido en cada app del monorepo. Cada app tiene su propio CLAUDE.md con contexto específico.

Estructura de agentes

graph TD
  Root["Agente raíz\n/CLAUDE.md"] --> API["Agente Backend\napps/api/CLAUDE.md"]
  Root --> Web["Agente Frontend\napps/web/CLAUDE.md"]
  Root --> E2E["Agente E2E\napps/e2e/CLAUDE.md"]
  Root --> Docs["Agente Docs\napps/docs/CLAUDE.md"]
  API -->|delega AI| AIB["AI Backend\napps/ai-backend/.env.example"]

Agente Raíz (/CLAUDE.md)

Define las reglas absolutas del monorepo y el contexto de dominio:

• NUNCA exponer contenido de nivel superior al nivel del usuario
• NUNCA llamar LLMs directamente desde Fluency
• NUNCA queries raw sin PrismaService
• Los schemas Zod son la fuente de verdad de validación

Agente Backend (apps/api/CLAUDE.md)

Especializado en NestJS, Prisma y los patrones del API:

• Guard pattern con @RequireAccessLevel()
• Patrón de servicio Prisma
• Webhooks NappAI
• Multi-tenancy con OrgTenantMiddleware
• Colas BullMQ
• Stripe webhooks con raw body

Agente Docs (este agente — apps/docs/CLAUDE.md)

Responsable de mantener la documentación actualizada.

Comandos disponibles:

/update-docs

Actualización completa de docs tras una implementación. Analiza git diff y actualiza las páginas MDX afectadas.

Agente: Docs Agent

/document-module

Documenta un módulo NestJS o del AI Backend. Lee el código fuente y genera el MDX correspondiente.

Agente: Docs Agent

/document-feature

Documenta una feature del frontend React.

Agente: Docs Agent

/document-schema

Documenta cambios en el schema Prisma y migraciones.

Agente: Docs Agent

/document-e2e

Documenta una suite de tests E2E Playwright.

Agente: Docs Agent

/add-changelog

Añade una entrada al changelog del sprint.

Agente: Docs Agent

Skills del monorepo

Skills disponibles vía Skill tool en todos los agentes:

/create-module

Crea un nuevo módulo NestJS completo (controller, service, module, DTOs, spec).

Agente: API Agent

/create-migration

Crea una migración Prisma para cambios de schema.

Agente: API Agent

/create-e2e-suite

Crea una suite de tests E2E Playwright para un nuevo feature.

Agente: E2E Agent

/create-webhook

Crea un handler de webhook para integración con NappAI Core.

Agente: API Agent

/create-ai-usecase

Scaffoldea un nuevo caso de uso en apps/ai-backend (module, controller, service, prompts/, test).

Agente: AI Backend Agent

/create-journal-entry

Scaffoldea la próxima entrada del build journal (.claude/journal/NNN-*.md) con el formato correcto.

Agente: Root Agent

/security-audit

Auditoría de seguridad del módulo o feature especificado.

Agente: Root Agent

/sprint-status

Genera el reporte de estado del sprint actual.

Agente: Root Agent

Build Journal

El project journal (.claude/journal/) registra las decisiones y sprints del proyecto:

Entrada	Sprint	Fecha	Cobertura
001	Sprint 0	2026-03-26	Bootstrap monorepo, Prisma schema, CI/CD
002	Sprint 1	2026-04-06	Auth JWT/OAuth, AccessLevelGuard, LinkedIn
003	Sprint 2	2026-04-09	Catálogo, multi-tenancy, Organizations
004	Sprint 3	2026-04-08	Dashboard, lesson player, Stripe, certificados
005	Sprint 4	2026-04-09	AI Backend, 7 usecases, Creator Program
006	Sprint 5	2026-04-10	Portal navigation, AI monitoring, quiz hybrid
007	Sprint 6	2026-04-11	Creator Studio, Guide Quality Module

Usa /create-journal-entry para scaffoldear la siguiente entrada.