chore: integrate AI development platform into HLL Vietnam project

ai/README.md

@@ -1,5 +1,22 @@
-# AI Workspace
+# AI Platform Workspace
 
-Esta carpeta queda preparada para incorporar más adelante el sistema de tareas, la orquestación y los flujos de trabajo asistidos por agentes.
+This directory contains the AI Development Platform support layer integrated into HLL Vietnam.
 
-La estructura actual separa el espacio de tareas por estado y reserva un área específica para el orquestador.
+Its purpose is operational, not product-facing. It exists to help the project plan work through tasks, preserve repository context, coordinate specialist roles and keep changes small, reviewable and documented.
+
+## Included areas
+
+- `task-template.md`: standard structure for every task
+- `repo-context.md`: repository and product context for planners and workers
+- `architecture-index.md`: quick map of the repository structure
+- `system-metrics.md`: lightweight log for platform execution metrics
+- `prompts/`: reusable planning prompts
+- `orchestrator/`: role guidance and orchestration documents
+- `tasks/`: task queue split by status
+
+## HLL Vietnam usage rules
+
+- The platform must reflect the real state of HLL Vietnam, not generic sample content.
+- Tasks should be created only when there is a justified change to perform.
+- This integration does not add product features by itself.
+- The current product stack remains HTML, CSS and JavaScript on the frontend, with Python reserved for the future backend.