Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .agent/agents/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ Este directorio contiene la definición de agentes especializados para automatiz
- **Documentos base**:
- [`docs/analisis/META_AGENTE_CODEX_PARTE_1.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_1.md)
- [`docs/analisis/META_AGENTE_CODEX_PARTE_2.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_2.md)
- [`docs/analisis/META_AGENTE_CODEX_PARTE_3.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_3.md)
- **ExecPlan asociado**: [`docs/plans/EXECPLAN_meta_agente_codex.md`](../../docs/plans/EXECPLAN_meta_agente_codex.md)
- **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.

Expand Down
1 change: 1 addition & 0 deletions .agent/agents/api_agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ Guiar cualquier automatización relacionada con el backend (`api/`) asegurando q
- **Normativa CODEX**:
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` describe los supuestos que deben respetar las especificaciones generadas para el backend.
- `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.
- `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.
- **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.
- **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.
- **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.
Expand Down
1 change: 1 addition & 0 deletions .agent/agents/chatgpt_agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ Centralizar el uso de modelos ChatGPT/OpenAI dentro de los flujos de automatizac
- **Normativa CODEX**:
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` define los supuestos que deben respetar las entregas basadas en modelos GPT.
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` describe el pipeline detallado, la entrada YAML y la estructura esperada que deben seguir estas entregas.
- `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.

## Procedimiento Recomendado

Expand Down
1 change: 1 addition & 0 deletions .agent/agents/claude_agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ Orquestar las integraciones con modelos Claude (Anthropic) dentro del flujo SDLC
- **Normativa CODEX**:
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` fija los supuestos y restricciones que deben respetar los artefactos generados con Claude.
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` define el pipeline detallado y la estructura obligatoria del artefacto CODEX que Claude debe seguir.
- `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.

## Procedimiento Recomendado

Expand Down
1 change: 1 addition & 0 deletions .agent/agents/docs_agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ Garantizar que los cambios en `docs/` sigan la gobernanza del ETA-AGENTE CODEX y
- **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.
- `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.
- `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.

## Procedimiento Recomendado

Expand Down
1 change: 1 addition & 0 deletions .agent/agents/huggingface_agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ Guiar el uso de modelos Hugging Face (locales o alojados) dentro de los pipeline
- **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.
- `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.
- `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.

## Procedimiento Recomendado

Expand Down
1 change: 1 addition & 0 deletions .agent/agents/infrastructure_agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ Coordinar automatizaciones relacionadas con `infrastructure/`, incluyendo IaC, p
- **Normativa CODEX**:
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` garantiza que las descripciones de infraestructura respeten los supuestos y validaciones del meta-agente.
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` establece el pipeline detallado y la estructura obligatoria que debe reflejarse en artefactos de infraestructura.
- `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.
- **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.
- **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.
- **Gobernanza**: `docs/gobernanza/metodologias/agentes_automatizacion.md` y runbooks en `docs/operaciones/`.
Expand Down
1 change: 1 addition & 0 deletions .agent/agents/scripts_agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ Orquestar cambios en `scripts/` garantizando que las automatizaciones, generador
- **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.
- `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.
- `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.
- **Catálogo de prompts**: `docs/ai_capabilities/prompting/PROMPT_TECHNIQUES_CATALOG.md` para seleccionar estrategias multi-LLM antes de automatizar generadores o validadores.
- **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.
- **Código**: `scripts/coding/ai/` (generators, orchestrators, shared utilities) y `scripts/tests/`.
Expand Down
1 change: 1 addition & 0 deletions .agent/agents/ui_agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ Alinear el trabajo automatizado sobre el frontend (`ui/`) con las prácticas de
- **Normativa CODEX**:
- `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` guía las entregas formales que involucren documentación o especificaciones del frontend.
- `docs/analisis/META_AGENTE_CODEX_PARTE_2.md` detalla el pipeline y la estructura que debe seguir cualquier artefacto CODEX aplicado a la UI.
- `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.
- **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).
- **Sesiones de contexto**: `scripts/coding/ai/shared/context_sessions.py` para trimming/summarization cuando los flujos UX requieren iteraciones largas.
- **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).
Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -188,6 +188,7 @@ pytest -c docs/pytest.ini docs/testing
- **META-AGENTE CODEX**
- [Parte 1](docs/analisis/META_AGENTE_CODEX_PARTE_1.md): Supuestos, restricciones y fundamentos para generar artefactos CODEX multi-LLM.
- [Parte 2](docs/analisis/META_AGENTE_CODEX_PARTE_2.md): Pipeline detallado (Etapas 4-6), formato de entrada y estructura del artefacto.
- [Parte 3](docs/analisis/META_AGENTE_CODEX_PARTE_3.md): Instrucciones de uso, formatos de salida, limitaciones y visión de futuro.

## Arquitectura y Stack

Expand Down
2 changes: 1 addition & 1 deletion docs/analisis/META_AGENTE_CODEX_PARTE_1.md
Original file line number Diff line number Diff line change
Expand Up @@ -386,7 +386,7 @@ Artefacto CODEX + reporte de validación
## Próximos pasos

- **Parte 2:** Cubrirá la construcción de la estructura (Etapa 4) y la aplicación detallada de Auto-CoT y Self-Consistency (Etapa 5).
- **Parte 3:** Documentará la validación multi-capa, métricas de convergencia y la integración con los agentes operativos.
- **Parte 3:** Documenta instrucciones de uso, formatos de salida, limitaciones conocidas y la visión de evolución del meta-agente.

Mientras las otras partes se redactan, los agentes de documentación (`docs_agent.md`) y de scripts (`scripts_agent.md`) deben seguir utilizando este documento como referencia para alinear sus ExecPlans y automatizaciones.

Expand Down
2 changes: 1 addition & 1 deletion docs/analisis/META_AGENTE_CODEX_PARTE_2.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

---

> **Serie documental**: Esta es la Parte 2 de 3 del manual del META-AGENTE CODEX. Consulte la Parte 1 en `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` y el ExecPlan rector en [`docs/plans/EXECPLAN_meta_agente_codex.md`](../plans/EXECPLAN_meta_agente_codex.md). El ETA-AGENTE CODEX exige que cada entrega permanezca autocontenida en `docs/analisis/` y enlazada desde los catálogos oficiales.
> **Serie documental**: Esta es la Parte 2 de 3 del manual del META-AGENTE CODEX. Consulte la Parte 1 en `docs/analisis/META_AGENTE_CODEX_PARTE_1.md`, la Parte 3 en `docs/analisis/META_AGENTE_CODEX_PARTE_3.md` y el ExecPlan rector en [`docs/plans/EXECPLAN_meta_agente_codex.md`](../plans/EXECPLAN_meta_agente_codex.md). El ETA-AGENTE CODEX exige que cada entrega permanezca autocontenida en `docs/analisis/` y enlazada desde los catálogos oficiales.

## 3. Pipeline de Generación del Artefacto (Continuación)

Expand Down
Loading
Loading