# Repository Context

## Project Overview

HLL Vietnam is a community website repository for a Spanish-speaking Discord community centered on the future game HLL Vietnam.

The current implementation is intentionally small:

- a static landing page in `frontend/`
- a reserved Python backend space in `backend/`
- documentation in `docs/`
- an AI task orchestration layer in `ai/`

This repository is in foundation stage. The objective is to grow in a controlled way without losing clarity or overwriting project identity with generic template content.

## Current Product State

- Frontend: static HTML, CSS and vanilla JavaScript
- Backend: not implemented yet, but planned in Python
- AI Platform: integrated to coordinate planning and task execution
- Product goal in current phase: maintain a clean landing and repository structure
- Default deployment: `backend` + `frontend`; historical workers are advanced/manual only.
- Live and historical defaults are RCON-first, with public-scoreboard kept only as historical fallback.
- Comunidad Hispana #03 is not part of default RCON targets. Historical/Elo code and persisted data are preserved, while Elo/MMR remains paused and decoupled from backend startup.
- RCON historical data flow is session capture plus AdminLog ingestion, parsed event storage, materialized matches/player stats and optional player profile snapshot enrichment.
- Public scoreboard may enrich links or fill unsupported historical gaps, but it is not the primary historical source when RCON coverage exists.

## Repository Areas

### Root documentation

- `README.md`
- `AGENTS.md`

These files define the repository purpose and operating rules.

### Docs

- `docs/project-overview.md`
- `docs/roadmap.md`
- `docs/decisions.md`

These files describe scope, phased evolution and technical decisions.

### Frontend

- `frontend/index.html`
- `frontend/assets/css/styles.css`
- `frontend/assets/js/main.js`

This is the live product surface in the current phase. Keep changes conservative unless a task explicitly targets the landing.

### Backend

- `backend/README.md`
- `backend/requirements.txt`
- `backend/app/__init__.py`

This area is a reserved foundation for the future Python backend. Do not add functional services unless explicitly requested by task.

### 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/`

This area supports planning, orchestration and execution discipline.

## Working Rules For Agents

- Always work from tasks, except for repository inspection or explicitly requested platform integration.
- Prefer small, focused, reviewable changes.
- Preserve the military and Vietnam-inspired visual tone.
- Avoid introducing new technologies without clear reason.
- Treat Python as the planned backend baseline.

## AI Workflow

`Request -> Orchestrator review -> Scoped task -> Execution -> Validation -> Documentation -> Commit`

Tasks move through:

- `ai/tasks/pending`
- `ai/tasks/in-progress`
- `ai/tasks/review`
- `ai/tasks/blocked`
- `ai/tasks/obsolete`
- `ai/tasks/done`