chore: integrate AI development platform into HLL Vietnam project

This commit is contained in:
devRaGonSa
2026-03-19 10:57:24 +01:00
parent 8a35ed02f9
commit a82a90a1b4
28 changed files with 874 additions and 17 deletions

58
ai/architecture-index.md Normal file
View File

@@ -0,0 +1,58 @@
# Architecture Index
This file gives AI agents a fast overview of HLL Vietnam before they inspect the repository in detail.
## Application Type
Community website repository with a static landing in the current phase and a planned Python backend in later phases.
## Top-Level Structure
### Documentation
- `README.md`
- `AGENTS.md`
- `docs/`
### Frontend
- `frontend/index.html`
- `frontend/assets/css/`
- `frontend/assets/js/`
- `frontend/assets/img/`
### Backend
- `backend/`
- `backend/app/`
### AI Platform
- `ai/`
- `ai/orchestrator/`
- `ai/prompts/`
- `ai/tasks/`
### Automation And Support
- `scripts/`
- `.github/workflows/`
## Current Technical Baseline
- Frontend runtime is plain browser-loaded HTML, CSS and JavaScript.
- There is no active backend runtime yet.
- Python is the expected backend language for future development.
- GitHub Actions and local PowerShell scripts may support the AI task workflow.
## Editing Priorities
- Product-facing changes usually start in `frontend/`.
- Process and coordination changes usually start in `ai/`, `AGENTS.md` and `scripts/`.
- Backend changes must remain preparatory unless a task explicitly changes that scope.
## Validation Expectations
- Frontend changes should remain compatible with local browser opening where applicable.
- AI platform changes should keep task paths and documentation aligned.
- Script changes should fail safely when optional tools or tests are not configured.