# TASK-001-platform-readiness-check

## Goal
Validar que la integración de AI Development Platform en el repositorio HLL Vietnam está completa, coherente y lista para ejecutar tasks de forma segura con Codex.

## Context
El repositorio ya tiene una estructura base de producto y se ha integrado la capa operativa inspirada en ai-dev-platform-template. Antes de generar tasks funcionales del producto, hay que verificar que el flujo por tasks, documentación, scripts y estructura están realmente alineados y no contienen inconsistencias.

## Steps
1. Revisar la estructura de carpetas del repositorio.
2. Verificar que existen y son coherentes:
   - AGENTS.md
   - ai/task-template.md
   - ai/repo-context.md
   - ai/architecture-index.md
   - ai/system-metrics.md
   - ai/prompts/plan-feature.md
   - ai/orchestrator/*
   - ai/tasks/pending
   - ai/tasks/in-progress
   - ai/tasks/done
   - scripts/codex-runner.ps1
   - scripts/run-integration-tests.ps1
3. Confirmar que AGENTS.md refleja el flujo correcto:
   - el orquestador analiza código y redacta tasks
   - Codex no actúa fuera de tasks salvo mantenimiento o inspección explícita
   - backend previsto en Python
   - frontend actual en HTML/CSS/JS
4. Revisar que la documentación de contexto no contradice el proyecto HLL Vietnam.
5. Revisar que la task actual y la plantilla de task usan una estructura coherente con el template.
6. Si detectas incoherencias pequeñas, corrígelas.
7. Dejar un breve resumen en ai/system-metrics.md o en la documentación correspondiente si el flujo del repo ya lo contempla.

## Files to Read First
- AGENTS.md
- README.md
- docs/project-overview.md
- docs/decisions.md
- ai/task-template.md
- ai/repo-context.md
- ai/architecture-index.md
- ai/orchestrator/README.md
- scripts/codex-runner.ps1
- scripts/run-integration-tests.ps1

## Expected Files to Modify
- Solo los estrictamente necesarios si se detectan inconsistencias menores.
- No modificar archivos de producto salvo documentación mínima si es imprescindible.

## Constraints
- No implementar features del producto.
- No tocar la landing salvo que haya una inconsistencia documental o estructural.
- No añadir dependencias nuevas.
- No hacer cambios destructivos.
- Mantener el cambio pequeño y verificable.

## Validation
- La estructura AI Platform existe y es navegable.
- AGENTS.md refleja correctamente el flujo de trabajo del proyecto.
- No hay referencias obsoletas a .NET como arquitectura del producto.
- Los scripts clave existen.
- La plantilla de task es usable para futuras tasks.
- El repo queda listo para que el siguiente paso sea crear una task funcional real.

## Change Budget
- Preferir menos de 8 archivos modificados.
- Preferir menos de 250 líneas cambiadas.

## Outcome
- Verificada la existencia y coherencia de `AGENTS.md`, `ai/task-template.md`, `ai/repo-context.md`, `ai/architecture-index.md`, `ai/system-metrics.md`, `ai/prompts/plan-feature.md`, `ai/orchestrator/*`, `ai/tasks/*`, `scripts/codex-runner.ps1` y `scripts/run-integration-tests.ps1`.
- Confirmado que `AGENTS.md` refleja correctamente el flujo por tasks, el alcance de Codex y la dirección técnica actual: frontend en HTML/CSS/JS y backend futuro en Python.
- Corregidas dos incoherencias documentales menores:
  - `README.md` ya no presenta la plataforma AI como integración futura.
  - `docs/roadmap.md` ahora trata la orquestación como capacidad existente que debe evolucionar, no incorporarse desde cero.
- Validación manual completada. El script `scripts/run-integration-tests.ps1` existe, pero actualmente solo documenta que no hay tests de integración configurados para este alcance.