Axel Engineering
Cómo construimos Axel: un producto AI-native, con la mayor parte del código generado por agentes bajo review humano. Esta base documenta nuestras prácticas de ingeniería, el sistema de tracking y el flujo de trabajo con agentes.
Empezar aquí
Setup localLevantar el repo en tu máquina: versiones pineadas, un host local y el gate de CI antes de pushear.Arquitectura (visión general)Laravel + Inertia + React, un solo repo con vertical slicing por dominio y las convenciones de código.
Arquitectura
Cómo está diseñada la plataforma, pieza por pieza. Es diseño aprobado y en construcción: el detalle vive en cada página.
Multi-tenancy y aislamientoShared schema + tenant_id + Postgres RLS. Cómo se blinda el aislamiento entre empresas y el gotcha del RLS.Motor del Código de TrabajoEl corazón determinista: calcula finiquitos y valida contratos con citas legales. Nunca toca un LLM.Firma (UANATACA)Firma certificada con valor probatorio: SigningService agnóstico, flujo async y registro MTPS.Capa LLM (AxelCopilot)Intención = LLM, verdad = motor determinista. Guardrails, query plan con whitelist y citas del corpus.Infraestructura y deployLa topología por capas (Cloudflare, Laravel Cloud, el Optimizer) y la estrategia de costos y salida.Testing y verificaciónLos gates por fase: Pest, Playwright, Larastan y el agente auditor sobre el diff antes de mergear.
Proceso
Cómo ejecutamos: el flujo de trabajo con agentes, el tracking y las automatizaciones.
AI-native workflowCómo trabajamos con agentes de código: los 4 gates human-in-the-loop y por qué el review es el cuello de botella.Project trackingEl sistema de 3 niveles sobre GitHub Projects: portfolio → sub-proyecto → sprint.PR review con Claude CodePre-review AI en los PRs a costo ~0 con la Action de Claude Code.Automatización & agentes AFKLos workflows que corren el tracking solo (responder @claude, labeler) y el runbook AFK.