Merge pull request #176 from 2-Coatl/claude/help-request-011CV67DxwEbbL5p62wckEmo

Merge changes from analyze-scripts-output: Complete documentation reorganization and SDLC agents

Author: 2-Coatl

.agent/agents/README.md

@@ -6,10 +6,7 @@ Este directorio contiene la definición de agentes especializados para automatiz
 
 ### Meta-agente CODEX (documentación normativa)
 
-- **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)
+- **Documento base**: [`docs/analisis/META_AGENTE_CODEX_PARTE_1.md`](../../docs/analisis/META_AGENTE_CODEX_PARTE_1.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.
 

.agent/agents/api_agent.md

@@ -7,10 +7,7 @@ Guiar cualquier automatización relacionada con el backend (`api/`) asegurando q
 ## Integraciones Clave
 
 - **ExecPlans**: `docs/plans/EXECPLAN_agents_domain_alignment.md` (relación dominio ↔ agentes) y `docs/plans/EXECPLAN_codex_mcp_multi_llm.md` (estrategia multi-LLM).
-- **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.
+- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` describe los supuestos que deben respetar las especificaciones generadas para el 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.

.agent/agents/chatgpt_agent.md

@@ -14,10 +14,7 @@ Centralizar el uso de modelos ChatGPT/OpenAI dentro de los flujos de automatizac
 - **Builder MCP**: `scripts/coding/ai/orchestrators/codex_mcp_workflow.py` emite briefs con banderas MCP y modelos recomendados (por ejemplo `gpt-5`) para OpenAI.
 - **Guía operativa**: `docs/ai/SDLC_AGENTS_GUIDE.md` detalla cuándo alternar entre modos heurísticos y LLM.
 - **Playbook MCP**: `docs/ai_capabilities/orchestration/CODEX_MCP_MULTI_AGENT_GUIDE.md` explica la ejecución multi-agente para todos los proveedores, incluido OpenAI.
-- **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.
+- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` define los supuestos que deben respetar las entregas basadas en modelos GPT.
 
 ## Procedimiento Recomendado
 

.agent/agents/claude_agent.md

@@ -14,10 +14,7 @@ Orquestar las integraciones con modelos Claude (Anthropic) dentro del flujo SDLC
 - **Builder MCP**: `scripts/coding/ai/orchestrators/codex_mcp_workflow.py` genera briefs single/multi-agent asegurando banderas MCP correctas cuando el proveedor es Anthropic.
 - **Guía operativa**: `docs/ai/SDLC_AGENTS_GUIDE.md` contiene los lineamientos de uso y compara el modo LLM vs heurístico.
 - **Playbook MCP**: `docs/ai_capabilities/orchestration/CODEX_MCP_MULTI_AGENT_GUIDE.md` documenta prerequisitos y trazas para todos los proveedores.
-- **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.
+- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` fija los supuestos y restricciones que deben respetar los artefactos generados con Claude.
 
 ## Procedimiento Recomendado
 

.agent/agents/docs_agent.md

@@ -11,10 +11,7 @@ Garantizar que los cambios en `docs/` sigan la gobernanza del ETA-AGENTE CODEX y
 - **Pruebas**: `docs/testing/test_documentation_alignment.py` asegura consistencia de enlaces y ubicación.
 - **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`.
 - **Sesiones de contexto**: `scripts/coding/ai/shared/context_sessions.py` para mantener resúmenes consistentes en revisiones prolongadas.
-- **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.
+- **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.
 
 ## Procedimiento Recomendado
 

.agent/agents/huggingface_agent.md

@@ -16,10 +16,7 @@ Guiar el uso de modelos Hugging Face (locales o alojados) dentro de los pipeline
     - `docs/ai/SDLC_AGENTS_GUIDE.md` explica cuándo preferir modos locales vs nube.
     - `docs/ai_capabilities/prompting/PHI3_PROMPT_ENGINEERING_PLAYBOOK.md` y `docs/ai_capabilities/prompting/CODE_GENERATION_GUIDE.md` muestran patrones de prompting reutilizables.
     - `docs/ai_capabilities/orchestration/CODEX_MCP_MULTI_AGENT_GUIDE.md` unifica el procedimiento multi-agente.
-- **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.
+- **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.
 
 ## Procedimiento Recomendado
 

.agent/agents/infrastructure_agent.md

@@ -7,10 +7,7 @@ Coordinar automatizaciones relacionadas con `infrastructure/`, incluyendo IaC, p
 ## Integraciones Clave
 
 - **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`).
-- **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.
+- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` garantiza que las descripciones de infraestructura respeten los supuestos y validaciones del meta-agente.
 - **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/`.

.agent/agents/scripts_agent.md

@@ -7,10 +7,7 @@ Orquestar cambios en `scripts/` garantizando que las automatizaciones, generador
 ## Integraciones Clave
 
 - **ExecPlans**: `docs/plans/EXECPLAN_agents_domain_alignment.md`, `docs/plans/EXECPLAN_codex_mcp_multi_llm.md`.
-- **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.
+- **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.
 - **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/`.

.agent/agents/ui_agent.md

@@ -7,10 +7,7 @@ Alinear el trabajo automatizado sobre el frontend (`ui/`) con las prácticas de
 ## Integraciones Clave
 
 - **ExecPlans**: `docs/plans/EXECPLAN_agents_domain_alignment.md` y `docs/plans/EXECPLAN_codex_mcp_multi_llm.md`.
-- **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.
+- **Normativa CODEX**: `docs/analisis/META_AGENTE_CODEX_PARTE_1.md` guía las entregas formales que involucren documentación o especificaciones del frontend.
 - **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).

.devcontainer/Dockerfile

@@ -153,9 +153,9 @@ RUN git config --system --add safe.directory '*'
 # CREATE DIRECTORIES FOR LOGS AND STATE
 # =============================================================================
 
-RUN mkdir -p /workspaces/infraestructura/devcontainer/logs \
-    && mkdir -p /workspaces/infraestructura/state \
-    && chown -R ${USERNAME}:${USERNAME} /workspaces/infraestructura
+RUN mkdir -p /workspaces/infrastructure/devcontainer/logs \
+    && mkdir -p /workspaces/infrastructure/state \
+    && chown -R ${USERNAME}:${USERNAME} /workspaces/infrastructure
 
 # =============================================================================
 # HEALTHCHECK