comunidadhll/ai

AI Platform Workspace

This directory contains the AI Development Platform support layer integrated into HLL Vietnam.

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

• ../ai-platform.json: repository-specific platform configuration for local workers and validation
• 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
• reports/: generated local platform reports; Markdown reports are ignored except .gitkeep
• prompts/: reusable planning prompts
• orchestrator/: role guidance and orchestration documents
• tasks/: task queue split by status

Task lifecycle

• tasks/pending/: scoped tasks ready for a worker
• tasks/in-progress/: tasks currently being executed
• tasks/review/: completed work waiting for human or orchestrator review
• tasks/blocked/: tasks that cannot continue without a decision or missing input
• tasks/obsolete/: tasks intentionally retired without execution
• tasks/done/: validated and completed tasks

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.
• Codex workers must process explicit tasks only and use ai-platform.json for local platform paths where scripts support it.