## Project docs index

Last updated: **2025-12-31**

### Documents

- **`project-docs/overview.md`** (updated 2025-12-31)  
  High-level goals, scope, and primary users for this Ansible infrastructure repo.

- **`project-docs/architecture.md`** (updated 2025-12-31)  
  Architecture map: inventories, playbooks, roles, and the Proxmox app-project flow.

- **`project-docs/standards.md`** (updated 2025-12-31)  
  Conventions for Ansible YAML, role structure, naming, vault usage, and linting.

- **`project-docs/workflow.md`** (updated 2025-12-31)  
  How to run common tasks via `Makefile`, how to lint/test, and how to apply safely.

- **`project-docs/decisions.md`** (updated 2025-12-31)  
  Short ADR-style notes for important architectural decisions.

### Related docs (existing)

- **Playbooks/tags map**: `docs/reference/playbooks-and-tags.md`
- **Applications inventory**: `docs/reference/applications.md`
- **Makefile reference**: `docs/reference/makefile.md`
- **Proxmox app project guides**:
  - `docs/guides/app_stack_proxmox.md`
  - `docs/guides/app_stack_execution_flow.md`

Legacy pointers:
- `docs/reference/architecture.md` → `project-docs/architecture.md`