50d11f0c34
Update HLL Vietnam AI Platform integration with ai-platform.json, extended task lifecycle folders, config-aware runner, lightweight validation, report ignore rules, and platform documentation updates.
35 lines
1.8 KiB
Markdown
35 lines
1.8 KiB
Markdown
# 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.
|