chore: update AI platform integration
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.
This commit is contained in:
devRaGonSa
12
ai/README.md
12
ai/README.md
@@ -6,17 +6,29 @@ Its purpose is operational, not product-facing. It exists to help the project pl
|
||||
|
||||
## 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.
|
||||
|
||||
@@ -12,6 +12,7 @@ Community website repository with a static landing in the current phase and a pl
|
||||
|
||||
- `README.md`
|
||||
- `AGENTS.md`
|
||||
- `ai-platform.json`
|
||||
- `docs/current-hll-servers-source-plan.md`
|
||||
- `docs/`
|
||||
|
||||
@@ -32,6 +33,7 @@ Community website repository with a static landing in the current phase and a pl
|
||||
- `ai/`
|
||||
- `ai/orchestrator/`
|
||||
- `ai/prompts/`
|
||||
- `ai/reports/`
|
||||
- `ai/tasks/`
|
||||
|
||||
### Automation And Support
|
||||
@@ -50,6 +52,7 @@ Community website repository with a static landing in the current phase and a pl
|
||||
|
||||
- Product-facing changes usually start in `frontend/`.
|
||||
- Process and coordination changes usually start in `ai/`, `AGENTS.md` and `scripts/`.
|
||||
- Local AI worker configuration starts in `ai-platform.json`.
|
||||
- Backend changes must remain preparatory unless a task explicitly changes that scope.
|
||||
|
||||
## Validation Expectations
|
||||
|
||||
@@ -56,9 +56,11 @@ This area is a reserved foundation for the future Python backend. Do not add fun
|
||||
### AI Platform
|
||||
|
||||
- `ai/task-template.md`
|
||||
- `ai-platform.json`
|
||||
- `ai/repo-context.md`
|
||||
- `ai/architecture-index.md`
|
||||
- `ai/system-metrics.md`
|
||||
- `ai/reports/`
|
||||
- `ai/prompts/`
|
||||
- `ai/orchestrator/`
|
||||
- `ai/tasks/`
|
||||
@@ -81,4 +83,7 @@ Tasks move through:
|
||||
|
||||
- `ai/tasks/pending`
|
||||
- `ai/tasks/in-progress`
|
||||
- `ai/tasks/review`
|
||||
- `ai/tasks/blocked`
|
||||
- `ai/tasks/obsolete`
|
||||
- `ai/tasks/done`
|
||||
|
||||
1
ai/reports/.gitkeep
Normal file
1
ai/reports/.gitkeep
Normal file
@@ -0,0 +1 @@
|
||||
|
||||
@@ -15,3 +15,4 @@ This file tracks lightweight execution history for the HLL Vietnam AI developmen
|
||||
Date | Task | Duration | Result | Notes
|
||||
2026-03-19 | TASK-001-platform-readiness-check | n/a | success | README y roadmap alineados con la integración actual de AI Platform; scripts clave presentes; no hay tests de integración configurados para este alcance.
|
||||
2026-03-19T13:59:33 | worker-cycle | 641.24 sec | success | codex-runner
|
||||
2026-05-19T08:39:12 | worker-cycle | 663.71 sec | success | codex-runner
|
||||
|
||||
@@ -1,4 +1,15 @@
|
||||
# TASK-XXX
|
||||
---
|
||||
id: TASK-XXX
|
||||
title: Short task title
|
||||
status: pending
|
||||
type: platform | frontend | backend | documentation | research
|
||||
team: PM | Analista | Backend Senior | Frontend Senior | Arquitecto de Base de Datos | Arquitecto Python | Disenador grafico | Experto en interfaz
|
||||
supporting_teams: []
|
||||
roadmap_item: foundation
|
||||
priority: medium
|
||||
---
|
||||
|
||||
# TASK-XXX - Short task title
|
||||
|
||||
## Goal
|
||||
|
||||
@@ -8,6 +19,8 @@ Describe the smallest useful objective for this task.
|
||||
|
||||
Explain where the change happens in HLL Vietnam and why it is needed now.
|
||||
|
||||
Preserve the current product identity: Spanish-speaking HLL Vietnam community, military/Vietnam/tactical/sober visual direction and controlled repository evolution.
|
||||
|
||||
## Steps
|
||||
|
||||
1. Inspect the listed files first.
|
||||
@@ -49,6 +62,8 @@ Rules:
|
||||
- Preserve HLL Vietnam project identity.
|
||||
- Do not introduce unnecessary frameworks or dependencies.
|
||||
- Do not implement backend functionality unless the task explicitly requires it.
|
||||
- Do not expand Elo/MMR, historical workers or RCON server #03 handling unless the task explicitly requires it.
|
||||
- Do not overwrite repository-specific context with generic platform template text.
|
||||
|
||||
## Validation
|
||||
|
||||
@@ -57,6 +72,12 @@ Before completing the task ensure:
|
||||
- scoped checks pass
|
||||
- no unrelated files were modified
|
||||
- documentation remains consistent with the repository state
|
||||
- `git diff --name-only` matches the expected scope
|
||||
- integration tests are run when relevant and configured
|
||||
|
||||
## Outcome
|
||||
|
||||
Document the validation performed, notable decisions, and any follow-up task that should be created instead of expanding this task.
|
||||
|
||||
## Change Budget
|
||||
|
||||
|
||||
1
ai/tasks/blocked/.gitkeep
Normal file
1
ai/tasks/blocked/.gitkeep
Normal file
@@ -0,0 +1 @@
|
||||
|
||||
180
ai/tasks/done/TASK-107-update-ai-platform-integration.md
Normal file
180
ai/tasks/done/TASK-107-update-ai-platform-integration.md
Normal file
@@ -0,0 +1,180 @@
|
||||
# TASK-107 - Update AI Platform Integration
|
||||
|
||||
## Goal
|
||||
|
||||
Update the HLL Vietnam AI Platform infrastructure to align with the newer `ai-dev-platform-template` conventions while preserving this repository's product context, workflow discipline and HLL Vietnam-specific documentation.
|
||||
|
||||
This is platform infrastructure work only. It must not change product behavior, backend logic, frontend behavior, Docker deployment behavior, Elo/MMR logic or RCON server #03 handling.
|
||||
|
||||
## Context
|
||||
|
||||
HLL Vietnam currently has a lightweight AI Platform layer under `ai/`, root `AGENTS.md`, task lifecycle folders and local Codex worker support. The next platform update should move the repository toward a controlled development-team workflow where ChatGPT acts as orchestrator between the human client/product owner and the development team, and Codex CLI workers execute only explicit tasks.
|
||||
|
||||
Important current direction:
|
||||
|
||||
- The Elo/MMR system is paused for now because it is too complex for the current phase.
|
||||
- Comunidad Hispana / RCON server #03 is obsolete for future planning unless explicitly reintroduced.
|
||||
- Historical workers and complex ranking/materialization pipelines must not be expanded by this task.
|
||||
- The priority is to update AI Platform conventions safely and incrementally.
|
||||
|
||||
Generic template text must be adapted to HLL Vietnam. Do not overwrite repository-specific context with generic `ai-dev-platform-template` content.
|
||||
|
||||
## Steps
|
||||
|
||||
1. Inspect the current platform files listed in `Files to Read First`.
|
||||
2. Compare the current repository conventions conceptually with the newer `ai-dev-platform-template` conventions:
|
||||
- root `ai-platform.json`
|
||||
- task lifecycle folders:
|
||||
- `ai/tasks/pending`
|
||||
- `ai/tasks/in-progress`
|
||||
- `ai/tasks/review`
|
||||
- `ai/tasks/blocked`
|
||||
- `ai/tasks/obsolete`
|
||||
- `ai/tasks/done`
|
||||
- metadata-based task template with front matter:
|
||||
- `id`
|
||||
- `title`
|
||||
- `status`
|
||||
- `type`
|
||||
- `team`
|
||||
- `supporting_teams`
|
||||
- `roadmap_item`
|
||||
- `priority`
|
||||
- config-aware `scripts/codex-runner.ps1`
|
||||
- `scripts/run-integration-tests.ps1`
|
||||
- optional `.github/workflows/codex-worker.yml`
|
||||
- `ai/reports/.gitkeep`
|
||||
- generated report ignore rules
|
||||
3. Add `ai-platform.json` adapted to HLL Vietnam. Include repository-specific task paths, project identity and workflow configuration needed by local platform scripts.
|
||||
4. Add missing task lifecycle directories with `.gitkeep` files where needed.
|
||||
5. Add `ai/reports/.gitkeep` if the reports directory is introduced or missing.
|
||||
6. Update `ai/task-template.md` to the newer metadata-based format while keeping HLL Vietnam-specific instructions, constraints and validation expectations.
|
||||
7. Update `scripts/codex-runner.ps1` so it reads platform configuration from `ai-platform.json` instead of relying only on hard-coded repository assumptions.
|
||||
8. Add or update `scripts/run-integration-tests.ps1` with repository-appropriate lightweight validation. The script should fail safely when optional checks are not configured.
|
||||
9. Add `.github/workflows/codex-worker.yml` only if it is consistent with the current repository automation policy and does not create unintended deployment or product behavior.
|
||||
10. Update `.gitignore` to ignore local runtime and generated platform artifacts, including:
|
||||
- `backend/runtime/`
|
||||
- generated `ai/reports/*.md` files
|
||||
- keep `ai/reports/.gitkeep` trackable
|
||||
11. Update `AGENTS.md`, `ai/README.md`, `ai/repo-context.md` and/or `ai/architecture-index.md` only where necessary to reflect the new platform workflow.
|
||||
12. Document any relevant architectural or process decisions in the task outcome.
|
||||
|
||||
## Files to Read First
|
||||
|
||||
- `AGENTS.md`
|
||||
- `README.md`
|
||||
- `.gitignore`
|
||||
- `ai/README.md`
|
||||
- `ai/repo-context.md`
|
||||
- `ai/architecture-index.md`
|
||||
- `ai/task-template.md`
|
||||
- `scripts/codex-runner.ps1`
|
||||
- `docker-compose.yml`
|
||||
- `.github/workflows/*` if present
|
||||
|
||||
Rules:
|
||||
|
||||
- Read these files before implementation.
|
||||
- Keep product behavior unchanged.
|
||||
- Use the existing HLL Vietnam context as the source of truth.
|
||||
- Treat template conventions as a reference, not content to copy blindly.
|
||||
|
||||
## Expected Files to Modify
|
||||
|
||||
Likely files:
|
||||
|
||||
- `ai-platform.json`
|
||||
- `.gitignore`
|
||||
- `AGENTS.md`
|
||||
- `ai/README.md`
|
||||
- `ai/repo-context.md`
|
||||
- `ai/architecture-index.md`
|
||||
- `ai/task-template.md`
|
||||
- `scripts/codex-runner.ps1`
|
||||
- `scripts/run-integration-tests.ps1`
|
||||
- `ai/tasks/review/.gitkeep`
|
||||
- `ai/tasks/blocked/.gitkeep`
|
||||
- `ai/tasks/obsolete/.gitkeep`
|
||||
- `ai/reports/.gitkeep`
|
||||
|
||||
Possible file, only if consistent with the repository automation policy:
|
||||
|
||||
- `.github/workflows/codex-worker.yml`
|
||||
|
||||
Rules:
|
||||
|
||||
- Do not modify product files unless there is a platform-only reason and it is documented.
|
||||
- Do not modify unrelated files.
|
||||
- If additional files become necessary, explain why in the task outcome.
|
||||
|
||||
## Expected Files Not To Modify
|
||||
|
||||
- `backend/**` product logic
|
||||
- `frontend/**`
|
||||
- `docker-compose.yml`
|
||||
- Elo/MMR implementation files
|
||||
- RCON server #03 implementation or configuration
|
||||
|
||||
## Constraints
|
||||
|
||||
- This task is platform infrastructure work, not product work.
|
||||
- Do not change frontend behavior.
|
||||
- Do not change backend behavior.
|
||||
- Do not change Docker deployment behavior.
|
||||
- Do not change Elo/MMR code or expand Elo/MMR pipelines.
|
||||
- Do not remove, rename or alter RCON server #03 in this task.
|
||||
- Do not expand historical workers or complex ranking/materialization pipelines.
|
||||
- Preserve HLL Vietnam-specific project context, Spanish-speaking community identity and current repository direction.
|
||||
- Adapt template conventions to this repository instead of blindly copying generic template text.
|
||||
- Keep the change narrow, reviewable and implementation-ready.
|
||||
|
||||
## Validation
|
||||
|
||||
Before completing the task ensure:
|
||||
|
||||
- `git status` has been reviewed.
|
||||
- `git diff --name-only` shows only expected platform files.
|
||||
- `ai-platform.json` exists and is valid JSON.
|
||||
- The task lifecycle folders exist:
|
||||
- `ai/tasks/pending`
|
||||
- `ai/tasks/in-progress`
|
||||
- `ai/tasks/review`
|
||||
- `ai/tasks/blocked`
|
||||
- `ai/tasks/obsolete`
|
||||
- `ai/tasks/done`
|
||||
- Required empty platform directories contain `.gitkeep` files where needed.
|
||||
- Generated reports such as `ai/reports/*.md` are ignored by Git.
|
||||
- `ai/reports/.gitkeep` remains trackable.
|
||||
- `backend/runtime/` is ignored by Git.
|
||||
- No local runtime data is committed.
|
||||
- A lightweight repository validation command has been run if available.
|
||||
- If `scripts/run-integration-tests.ps1` exists after the change, run it.
|
||||
- If no integration tests are configured for the affected scope, document that explicitly in the task outcome.
|
||||
- Frontend, backend and Docker behavior remain unchanged.
|
||||
|
||||
## Change Budget
|
||||
|
||||
- Prefer fewer than 10 modified files for this platform update.
|
||||
- Prefer small documentation and script changes over broad rewrites.
|
||||
- Split follow-up work into separate tasks if the scope grows beyond platform integration.
|
||||
|
||||
## Outcome
|
||||
|
||||
- Added repository-specific `ai-platform.json` for task paths, worker settings and HLL Vietnam constraints.
|
||||
- Added missing lifecycle folders: `review`, `blocked` and `obsolete`.
|
||||
- Added `ai/reports/.gitkeep` and ignored generated `ai/reports/*.md` files while keeping `.gitkeep` trackable.
|
||||
- Updated the task template to include metadata front matter and HLL Vietnam-specific constraints.
|
||||
- Updated `scripts/codex-runner.ps1` to read local worker paths and prompts from `ai-platform.json`.
|
||||
- Updated `scripts/run-integration-tests.ps1` to perform lightweight platform validation only.
|
||||
- Updated platform documentation in `AGENTS.md`, `ai/README.md`, `ai/repo-context.md` and `ai/architecture-index.md`.
|
||||
- No frontend, backend product logic, Docker behavior, Elo/MMR logic or RCON server #03 handling was changed.
|
||||
|
||||
Validation performed:
|
||||
|
||||
- Parsed `ai-platform.json` with `ConvertFrom-Json`.
|
||||
- Ran `powershell -ExecutionPolicy Bypass -File scripts/run-integration-tests.ps1`.
|
||||
- Parsed both PowerShell scripts with the PowerShell language parser.
|
||||
- Confirmed `ai/reports/example.md` is ignored and `ai/reports/.gitkeep` is trackable.
|
||||
- Reviewed `git diff --name-only` and `git status --short`.
|
||||
|
||||
No product integration tests are configured for this platform-only scope.
|
||||
1
ai/tasks/obsolete/.gitkeep
Normal file
1
ai/tasks/obsolete/.gitkeep
Normal file
@@ -0,0 +1 @@
|
||||
|
||||
1
ai/tasks/review/.gitkeep
Normal file
1
ai/tasks/review/.gitkeep
Normal file
@@ -0,0 +1 @@
|
||||
|
||||
Reference in New Issue
Block a user