CLAUDE.md — Contexto para Claude Code

Qué es ABE

ABE (Autonomous Bug Explorer) es una plataforma enterprise self-hosted de descubrimiento autónomo de bugs en aplicaciones web.

Estado actual

Fases 1-11 originales implementadas. Ahora refactorizando hacia arquitectura modular hexagonal enterprise. Ver .ralph/PROMPT.md para detalles completos.

Arquitectura

Modular monolith hexagonal con bounded contexts.

Regla #1: Domain NUNCA importa infrastructure. Regla #2: Cross-module communication SOLO via EventBus. Regla #3: Controllers son thin — delegan a use cases. Regla #4: Use cases retornan Result<T, E>, nunca throw.

Comandos principales

npm run build                        # build backend
cd frontend && npm run build         # build frontend
npm run test                         # vitest tests
npm run lint                         # eslint
npm run db:migrate                   # kysely migrations
docker compose up -d --build         # todo con Docker

Verificación obligatoria después de cambios

npm run build && cd frontend && npm run build && cd .. && npm run test

Commit después de cada tarea

git add -A && git commit -m "fase(X.Y): descripción"

Stack

Backend: Node 20, TypeScript strict, Express, socket.io, Kysely, better-sqlite3, Pino, Zod, Better Auth, CASL, Playwright
Frontend: React 18, Vite, shadcn/ui, Tailwind, Tremor, Recharts, TanStack Query/Table, Zustand

Estructura

src/shared/          → building blocks compartidos
src/modules/         → bounded contexts
src/api/             → Express server + middleware global
src/realtime/        → socket.io gateway
src/jobs/            → job queue SQLite-backed
src/cli/             → CLI
src/main.ts          → composition root
frontend/            → React app

Para desarrollo con Ralph

cat .ralph/fix_plan.md | grep -E "^\- \[" | head -30
ralph --monitor

1.9 KiB Raw Permalink Blame History