Skip to content

AGENTS.es.md

Latest commit

 

History

History
27 lines (22 loc) · 3.04 KB

AGENTS.es.md

File metadata and controls

27 lines (22 loc) · 3.04 KB

Navegación Bilingüe: English · Español (este documento)

Proyecto

Evolith Tracker - Motor de seguimiento de extremo a extremo para el flujo SDLC de Evolith. Este es un repositorio satélite (hijo) que hereda sus estándares de la base arquitectónica Evolith Upstream.

Rol del Agente

  • Eres un asistente de IA asignado a trabajar en este producto satélite.
  • Tu objetivo principal es ayudar a construir y mantener el tracker SDLC respetando la línea base arquitectónica impuesta por el upstream.
  • Siempre que propongas una nueva tecnología o patrón, debes verificar si existe un ADR en el upstream aplicable, y registrar cualquier divergencia explícitamente en el archivo DECISIONS.md.

Reglas y Convenciones Locales

  • Herencia de Decisiones: No debes asumir autonomía arquitectónica total. Las decisiones base de Evolith (ej. motor de base de datos, gateway, convenciones de nomenclatura) se aplican por defecto a menos que estén explícitamente sobreescritas en DECISIONS.md.
  • Navegación: Utiliza MASTER_INDEX.md para orientarte sobre la estructura del repositorio y README.md para el contexto general del producto.
  • Dominio del Negocio: Familiarízate con reference/knowledge/domain/glossary.md y úsalo de manera consistente en tu código y documentación.
  • Flujo de Trabajo SDLC: Dado que este es el motor de tracking del SDLC, todas las funciones que construyas deben alinearse con la gobernanza y las fases del SDLC de Evolith.
  • Gobernanza del Registro de Brechas: Las brechas, oportunidades y hallazgos de coherencia deben mantenerse únicamente en docs/audit/tracker-gaps-opportunities-tracking.md. Mantén una sola tabla maestra, ordena primero los pendientes, categoriza cada fila y enlaza cada ID a su sección de detalle dentro del mismo archivo. No crees archivos separados docs/audit/gaps/*.md, docs/audit/opportunities/*.md ni tablas separadas de pendientes/resueltos.

Tareas Relacionadas con Arquitectura

  • Si la tarea requiere tomar una decisión arquitectónica significativa, debes seguir el proceso de ADR:
    1. Revisar si hay un patrón upstream.
    2. Redactar el ADR local (Adoptar, Extender, Sobreescribir, N/A).
    3. Registrarlo en la tabla de DECISIONS.md.

Reglas de Implementación y DDD Táctico

  • Shells Transversales: Bajo ninguna circunstancia implementes lógica de infraestructura (configuración, máquinas de estado, parseo masivo) dentro de los Bounded Contexts. Debes inyectar y usar los Shared Kernels: @evolith/workflow-engine, @evolith/tenant-config y @evolith/integration-fabric.
  • Patrón Small Aggregates: Al diseñar relaciones 1:N masivas (ej. Backlog -> Historias), nunca anides objetos completos. Usa referencias de UUIDs (List<UUID> storyIds) para prevenir bloqueos de concurrencia.
  • Flujos Dinámicos (Workflows): Las transiciones de estado deben protegerse evaluando el RequirementChecklist interno del Agregado, el cual es inyectado por el WorkflowEngine al momento de su creación.