Skip to content

Commit 9116fcd

Browse files
authored
Merge pull request #155 from 2-Coatl/feature/check-if-changes-are-implemented-08-05-11
Add META-AGENTE CODEX part 2 and update agent references
2 parents 97bb496 + 9be0dc0 commit 9116fcd

14 files changed

Lines changed: 928 additions & 18 deletions

.agent/agents/README.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,9 @@ Este directorio contiene la definición de agentes especializados para automatiz
66

77
### Meta-agente CODEX (documentación normativa)
88

9-
- **Documento base**: [`docs/analisis/META_AGENTE_CODEX_PARTE_1.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_1.md)
9+
- **Documentos base**:
10+
- [`docs/analisis/META_AGENTE_CODEX_PARTE_1.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_1.md)
11+
- [`docs/analisis/META_AGENTE_CODEX_PARTE_2.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_2.md)
1012
- **ExecPlan asociado**: [`docs/plans/EXECPLAN_meta_agente_codex.md`](../../docs/plans/EXECPLAN_meta_agente_codex.md)
1113
- **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.
1214

.agent/agents/api_agent.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,9 @@ Guiar cualquier automatización relacionada con el backend (`api/`) asegurando q
77
## Integraciones Clave
88

99
- **ExecPlans**: `docs/plans/EXECPLAN_agents_domain_alignment.md` (relación dominio ↔ agentes) y `docs/plans/EXECPLAN_codex_mcp_multi_llm.md` (estrategia multi-LLM).
10-
- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` describe los supuestos que deben respetar las especificaciones generadas para el backend.
10+
- **Normativa CODEX**:
11+
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` describe los supuestos que deben respetar las especificaciones generadas para el backend.
12+
- `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.
1113
- **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.
1214
- **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.
1315
- **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: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,9 @@ Centralizar el uso de modelos ChatGPT/OpenAI dentro de los flujos de automatizac
1414
- **Builder MCP**: `scripts/coding/ai/orchestrators/codex_mcp_workflow.py` emite briefs con banderas MCP y modelos recomendados (por ejemplo `gpt-5`) para OpenAI.
1515
- **Guía operativa**: `docs/ai/SDLC_AGENTS_GUIDE.md` detalla cuándo alternar entre modos heurísticos y LLM.
1616
- **Playbook MCP**: `docs/ai_capabilities/orchestration/CODEX_MCP_MULTI_AGENT_GUIDE.md` explica la ejecución multi-agente para todos los proveedores, incluido OpenAI.
17-
- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` define los supuestos que deben respetar las entregas basadas en modelos GPT.
17+
- **Normativa CODEX**:
18+
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` define los supuestos que deben respetar las entregas basadas en modelos GPT.
19+
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` describe el pipeline detallado, la entrada YAML y la estructura esperada que deben seguir estas entregas.
1820

1921
## Procedimiento Recomendado
2022

.agent/agents/claude_agent.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,9 @@ Orquestar las integraciones con modelos Claude (Anthropic) dentro del flujo SDLC
1414
- **Builder MCP**: `scripts/coding/ai/orchestrators/codex_mcp_workflow.py` genera briefs single/multi-agent asegurando banderas MCP correctas cuando el proveedor es Anthropic.
1515
- **Guía operativa**: `docs/ai/SDLC_AGENTS_GUIDE.md` contiene los lineamientos de uso y compara el modo LLM vs heurístico.
1616
- **Playbook MCP**: `docs/ai_capabilities/orchestration/CODEX_MCP_MULTI_AGENT_GUIDE.md` documenta prerequisitos y trazas para todos los proveedores.
17-
- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` fija los supuestos y restricciones que deben respetar los artefactos generados con Claude.
17+
- **Normativa CODEX**:
18+
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` fija los supuestos y restricciones que deben respetar los artefactos generados con Claude.
19+
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` define el pipeline detallado y la estructura obligatoria del artefacto CODEX que Claude debe seguir.
1820

1921
## Procedimiento Recomendado
2022

.agent/agents/docs_agent.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,9 @@ Garantizar que los cambios en `docs/` sigan la gobernanza del ETA-AGENTE CODEX y
1111
- **Pruebas**: `docs/testing/test_documentation_alignment.py` asegura consistencia de enlaces y ubicación.
1212
- **Playbooks**: `docs/ai_capabilities/prompting/PROMPT_TECHNIQUES_CATALOG.md`, `docs/ai_capabilities/orchestration/CODEX_MCP_MULTI_AGENT_GUIDE.md`, `docs/ai_capabilities/orchestration/CONTEXT_MANAGEMENT_PLAYBOOK.md`, `docs/ai_capabilities/prompting/CODE_GENERATION_GUIDE.md`.
1313
- **Sesiones de contexto**: `scripts/coding/ai/shared/context_sessions.py` para mantener resúmenes consistentes en revisiones prolongadas.
14-
- **Referencia normativa**: `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.
14+
- **Referencia normativa**:
15+
- `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.
16+
- `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.
1517

1618
## Procedimiento Recomendado
1719

.agent/agents/huggingface_agent.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,9 @@ Guiar el uso de modelos Hugging Face (locales o alojados) dentro de los pipeline
1616
- `docs/ai/SDLC_AGENTS_GUIDE.md` explica cuándo preferir modos locales vs nube.
1717
- `docs/ai_capabilities/prompting/PHI3_PROMPT_ENGINEERING_PLAYBOOK.md` y `docs/ai_capabilities/prompting/CODE_GENERATION_GUIDE.md` muestran patrones de prompting reutilizables.
1818
- `docs/ai_capabilities/orchestration/CODEX_MCP_MULTI_AGENT_GUIDE.md` unifica el procedimiento multi-agente.
19-
- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` obliga a documentar evidencia formal y empírica al emitir artefactos basados en modelos Hugging Face.
19+
- **Normativa CODEX**:
20+
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` obliga a documentar evidencia formal y empírica al emitir artefactos basados en modelos Hugging Face.
21+
- `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.
2022

2123
## Procedimiento Recomendado
2224

.agent/agents/infrastructure_agent.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,9 @@ Coordinar automatizaciones relacionadas con `infrastructure/`, incluyendo IaC, p
77
## Integraciones Clave
88

99
- **ExecPlans**: `docs/plans/EXECPLAN_agents_domain_alignment.md`, `docs/plans/EXECPLAN_codex_mcp_multi_llm.md` y los planes específicos de infraestructura (`docs/plans/SPEC_INFRA_*.md`).
10-
- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` garantiza que las descripciones de infraestructura respeten los supuestos y validaciones del meta-agente.
10+
- **Normativa CODEX**:
11+
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` garantiza que las descripciones de infraestructura respeten los supuestos y validaciones del meta-agente.
12+
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` establece el pipeline detallado y la estructura obligatoria que debe reflejarse en artefactos de infraestructura.
1113
- **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.
1214
- **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.
1315
- **Gobernanza**: `docs/gobernanza/metodologias/agentes_automatizacion.md` y runbooks en `docs/operaciones/`.

.agent/agents/scripts_agent.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,9 @@ Orquestar cambios en `scripts/` garantizando que las automatizaciones, generador
77
## Integraciones Clave
88

99
- **ExecPlans**: `docs/plans/EXECPLAN_agents_domain_alignment.md`, `docs/plans/EXECPLAN_codex_mcp_multi_llm.md`.
10-
- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` detalla los requisitos de razonamiento y evidencia que deben cumplir los scripts generadores de artefactos.
10+
- **Normativa CODEX**:
11+
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` detalla los requisitos de razonamiento y evidencia que deben cumplir los scripts generadores de artefactos.
12+
- `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.
1113
- **Catálogo de prompts**: `docs/ai_capabilities/prompting/PROMPT_TECHNIQUES_CATALOG.md` para seleccionar estrategias multi-LLM antes de automatizar generadores o validadores.
1214
- **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.
1315
- **Código**: `scripts/coding/ai/` (generators, orchestrators, shared utilities) y `scripts/tests/`.

.agent/agents/ui_agent.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,9 @@ Alinear el trabajo automatizado sobre el frontend (`ui/`) con las prácticas de
77
## Integraciones Clave
88

99
- **ExecPlans**: `docs/plans/EXECPLAN_agents_domain_alignment.md` y `docs/plans/EXECPLAN_codex_mcp_multi_llm.md`.
10-
- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` guía las entregas formales que involucren documentación o especificaciones del frontend.
10+
- **Normativa CODEX**:
11+
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` guía las entregas formales que involucren documentación o especificaciones del frontend.
12+
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` detalla el pipeline y la estructura que debe seguir cualquier artefacto CODEX aplicado a la UI.
1113
- **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).
1214
- **Sesiones de contexto**: `scripts/coding/ai/shared/context_sessions.py` para trimming/summarization cuando los flujos UX requieren iteraciones largas.
1315
- **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: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -185,7 +185,9 @@ pytest -c docs/pytest.ini docs/testing
185185
- **[Guía Completa de Desarrollo de Features](docs/gobernanza/procesos/procedimientos/guia_completa_desarrollo_features.md)** - Proceso end-to-end
186186
- **[Estrategia de QA](docs/gobernanza/procesos/qa/ESTRATEGIA_QA.md)** - Testing strategy
187187
- **[Codex MCP Multi-Agent Guide](docs/ai_capabilities/orchestration/CODEX_MCP_MULTI_AGENT_GUIDE.md)** - Configura el `CodexMCPWorkflowBuilder` para flujos single/multi-agent en Claude, ChatGPT y Hugging Face.
188-
- **[META-AGENTE CODEX](docs/analisis/META_AGENTE_CODEX_PARTE_1.md)** - Supuestos, restricciones y pipeline formal para generar artefactos CODEX multi-LLM (Parte 1 de 3).
188+
- **META-AGENTE CODEX**
189+
- [Parte 1](docs/analisis/META_AGENTE_CODEX_PARTE_1.md): Supuestos, restricciones y fundamentos para generar artefactos CODEX multi-LLM.
190+
- [Parte 2](docs/analisis/META_AGENTE_CODEX_PARTE_2.md): Pipeline detallado (Etapas 4-6), formato de entrada y estructura del artefacto.
189191

190192
## Arquitectura y Stack
191193

0 commit comments

Comments
 (0)