# AGENTS.md

This file is the entry point for AI coding agents (Cursor, Claude Code, Aider, etc.).

The authoritative instructions live in **[.github/copilot-instructions.md](.github/copilot-instructions.md)** so that GitHub Copilot picks them up automatically. Other tools should read that file too — its content applies to all AI assistants working in this repo.

Quick summary:

- **Stack:** CodeIgniter 4 (PHP 8.2+) API + Vue 3 SPA (Vite, TS, Pinia, vue-query, PrimeVue, Tailwind).
- **Layout:** `app/` (CI4) · `vue/` (SPA source) · `public/` (web root, built artefacts).
- **Workflow:** branch from `development`, squash-merge via PR. Conventional Commits in PR titles.
- **Don't:** add SSR/Nuxt, use CI4 auto-routing, run `npm run build` unprompted, or commit `.env` / `vendor/` / `node_modules/`.

See [.github/copilot-instructions.md](.github/copilot-instructions.md) for the full ruleset and [CONTRIBUTING.md](CONTRIBUTING.md) for the human workflow.