Skip to content

Commit b23e4ef

Browse files
authored
Merge pull request #156 from 2-Coatl/feature/check-if-changes-are-implemented-08-19-36
Add META-AGENTE CODEX part 3 and extend governance coverage
2 parents 9116fcd + 7fe70aa commit b23e4ef

16 files changed

Lines changed: 1062 additions & 11 deletions

.agent/agents/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ Este directorio contiene la definición de agentes especializados para automatiz
99
- **Documentos base**:
1010
- [`docs/analisis/META_AGENTE_CODEX_PARTE_1.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_1.md)
1111
- [`docs/analisis/META_AGENTE_CODEX_PARTE_2.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_2.md)
12+
- [`docs/analisis/META_AGENTE_CODEX_PARTE_3.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_3.md)
1213
- **ExecPlan asociado**: [`docs/plans/EXECPLAN_meta_agente_codex.md`](../../docs/plans/EXECPLAN_meta_agente_codex.md)
1314
- **Uso**: describe la gobernanza autónoma para generar artefactos CODEX multi-LLM. Todo agente por proveedor o dominio debe validar sus entregables contra este meta-agente antes de generar documentación oficial.
1415

.agent/agents/api_agent.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ Guiar cualquier automatización relacionada con el backend (`api/`) asegurando q
1010
- **Normativa CODEX**:
1111
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` describe los supuestos que deben respetar las especificaciones generadas para el backend.
1212
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` fija el pipeline de generación y la estructura mínima del artefacto CODEX que deben seguir las APIs.
13+
- `docs/analisis/META_AGENTE_CODEX_PARTE_3.md` detalla cómo operar con los artefactos generados, qué validar en los formatos de salida y qué limitaciones deben comunicarse al equipo backend.
1314
- **Catálogo de prompts**: `docs/ai_capabilities/prompting/PROMPT_TECHNIQUES_CATALOG.md` indica qué técnicas aplicar con Claude, ChatGPT u Hugging Face antes de generar especificaciones para la API.
1415
- **Gestión de contexto**: `docs/ai_capabilities/orchestration/CONTEXT_MANAGEMENT_PLAYBOOK.md` y `scripts/coding/ai/shared/context_sessions.py` coordinan trimming/summarization para flujos prolongados de soporte o incidentes.
1516
- **Guías SDLC**: `docs/ai/SDLC_AGENTS_GUIDE.md` y `docs/ai_capabilities/orchestration/CODEX_MCP_MULTI_AGENT_GUIDE.md` para coordinación multi-agente.

.agent/agents/chatgpt_agent.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ Centralizar el uso de modelos ChatGPT/OpenAI dentro de los flujos de automatizac
1717
- **Normativa CODEX**:
1818
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` define los supuestos que deben respetar las entregas basadas en modelos GPT.
1919
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` describe el pipeline detallado, la entrada YAML y la estructura esperada que deben seguir estas entregas.
20+
- `docs/analisis/META_AGENTE_CODEX_PARTE_3.md` establece las pautas de uso, formatos de salida y limitaciones que deben comunicarse cuando los entregables se generan con modelos GPT.
2021

2122
## Procedimiento Recomendado
2223

.agent/agents/claude_agent.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ Orquestar las integraciones con modelos Claude (Anthropic) dentro del flujo SDLC
1717
- **Normativa CODEX**:
1818
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` fija los supuestos y restricciones que deben respetar los artefactos generados con Claude.
1919
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` define el pipeline detallado y la estructura obligatoria del artefacto CODEX que Claude debe seguir.
20+
- `docs/analisis/META_AGENTE_CODEX_PARTE_3.md` describe cómo consumir los artefactos generados, los formatos de salida esperados, las limitaciones conocidas y la visión de evolución del meta-agente.
2021

2122
## Procedimiento Recomendado
2223

.agent/agents/docs_agent.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ Garantizar que los cambios en `docs/` sigan la gobernanza del ETA-AGENTE CODEX y
1414
- **Referencia normativa**:
1515
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` (Parte 1 de 3) establece los supuestos y restricciones del meta-agente que gobierna todas las redacciones CODEX.
1616
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` (Parte 2 de 3) describe el pipeline detallado, los formatos de entrada y la estructura obligatoria del artefacto CODEX.
17+
- `docs/analisis/META_AGENTE_CODEX_PARTE_3.md` (Parte 3 de 3) documenta instrucciones de uso, formatos de salida, limitaciones y visión de futuro que deben comunicarse en cada entrega.
1718

1819
## Procedimiento Recomendado
1920

.agent/agents/huggingface_agent.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ Guiar el uso de modelos Hugging Face (locales o alojados) dentro de los pipeline
1919
- **Normativa CODEX**:
2020
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` obliga a documentar evidencia formal y empírica al emitir artefactos basados en modelos Hugging Face.
2121
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` prescribe el pipeline detallado, el template YAML y la estructura del artefacto que deben respetar estas entregas.
22+
- `docs/analisis/META_AGENTE_CODEX_PARTE_3.md` detalla cómo consumir los artefactos resultantes, qué formatos publicar y qué limitaciones deben informarse al trabajar con modelos Hugging Face.
2223

2324
## Procedimiento Recomendado
2425

.agent/agents/infrastructure_agent.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ Coordinar automatizaciones relacionadas con `infrastructure/`, incluyendo IaC, p
1010
- **Normativa CODEX**:
1111
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` garantiza que las descripciones de infraestructura respeten los supuestos y validaciones del meta-agente.
1212
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` establece el pipeline detallado y la estructura obligatoria que debe reflejarse en artefactos de infraestructura.
13+
- `docs/analisis/META_AGENTE_CODEX_PARTE_3.md` indica cómo usar los artefactos resultantes, qué formatos documentar para operaciones y qué limitaciones deben divulgarse al equipo de infraestructura.
1314
- **Catálogo de prompts**: `docs/ai_capabilities/prompting/PROMPT_TECHNIQUES_CATALOG.md` sirve como guía para seleccionar técnicas multi-LLM cuando la automatización afecta pipelines o servicios usados por los modelos.
1415
- **Gestión de contexto**: `docs/ai_capabilities/orchestration/CONTEXT_MANAGEMENT_PLAYBOOK.md` y `scripts/coding/ai/shared/context_sessions.py` documentan la memoria compartida entre incidentes prolongados y runbooks de infraestructura.
1516
- **Gobernanza**: `docs/gobernanza/metodologias/agentes_automatizacion.md` y runbooks en `docs/operaciones/`.

.agent/agents/scripts_agent.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ Orquestar cambios en `scripts/` garantizando que las automatizaciones, generador
1010
- **Normativa CODEX**:
1111
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` detalla los requisitos de razonamiento y evidencia que deben cumplir los scripts generadores de artefactos.
1212
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` documenta el pipeline de producción, la entrada requerida y la estructura de salida que deben implementar los scripts automatizados.
13+
- `docs/analisis/META_AGENTE_CODEX_PARTE_3.md` explica cómo distribuir los artefactos generados, qué validaciones comunicar y cuáles limitaciones deben propagarse al mantener scripts.
1314
- **Catálogo de prompts**: `docs/ai_capabilities/prompting/PROMPT_TECHNIQUES_CATALOG.md` para seleccionar estrategias multi-LLM antes de automatizar generadores o validadores.
1415
- **Memoria de contexto**: `docs/ai_capabilities/orchestration/CONTEXT_MANAGEMENT_PLAYBOOK.md` y `scripts/coding/ai/shared/context_sessions.py` habilitan sesiones compartidas en herramientas que atienden hilos extensos.
1516
- **Código**: `scripts/coding/ai/` (generators, orchestrators, shared utilities) y `scripts/tests/`.

.agent/agents/ui_agent.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ Alinear el trabajo automatizado sobre el frontend (`ui/`) con las prácticas de
1010
- **Normativa CODEX**:
1111
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` guía las entregas formales que involucren documentación o especificaciones del frontend.
1212
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` detalla el pipeline y la estructura que debe seguir cualquier artefacto CODEX aplicado a la UI.
13+
- `docs/analisis/META_AGENTE_CODEX_PARTE_3.md` explica cómo consumir los artefactos generados, los formatos y métricas que deben entregarse al equipo de UI y las limitaciones que deben socializarse.
1314
- **Playbooks**: `docs/ai_capabilities/prompting/PROMPT_TECHNIQUES_CATALOG.md`, `docs/ai_capabilities/prompting/CODE_GENERATION_GUIDE.md`, `docs/ai_capabilities/prompting/PHI3_PROMPT_ENGINEERING_PLAYBOOK.md` y `docs/ai_capabilities/orchestration/CONTEXT_MANAGEMENT_PLAYBOOK.md` (memoria de contexto compartida con backend/infrastructure).
1415
- **Sesiones de contexto**: `scripts/coding/ai/shared/context_sessions.py` para trimming/summarization cuando los flujos UX requieren iteraciones largas.
1516
- **Orquestación**: `scripts/coding/ai/orchestrators/codex_mcp_workflow.py` (multi-agente) y `scripts/coding/ai/generators/llm_generator.py` (generación guiada por TDD).

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -188,6 +188,7 @@ pytest -c docs/pytest.ini docs/testing
188188
- **META-AGENTE CODEX**
189189
- [Parte 1](docs/analisis/META_AGENTE_CODEX_PARTE_1.md): Supuestos, restricciones y fundamentos para generar artefactos CODEX multi-LLM.
190190
- [Parte 2](docs/analisis/META_AGENTE_CODEX_PARTE_2.md): Pipeline detallado (Etapas 4-6), formato de entrada y estructura del artefacto.
191+
- [Parte 3](docs/analisis/META_AGENTE_CODEX_PARTE_3.md): Instrucciones de uso, formatos de salida, limitaciones y visión de futuro.
191192

192193
## Arquitectura y Stack
193194

0 commit comments

Comments
 (0)