# AGENTS.md

Project guidance for AI coding agents working in this repository.

Before changing code, **read the relevant docs below** and follow them. Do not invent parallel conventions.

## Documentation index

| Doc | When to use |
| --- | --- |
| [docs/RULES.MD](docs/RULES.MD) | Always. Mandatory naming, standards, and project rules. |
| [docs/BACKEND-DESIGN-GUIDLINES.MD](docs/BACKEND-DESIGN-GUIDLINES.MD) | Backend / Laravel work: controllers, services, DTOs, requests, models. |
| [docs/FRONTEND_GUIDELINES.md](docs/FRONTEND_GUIDELINES.md) | Frontend UI work: visual system, tokens, typography, components, motion. |
| [docs/FRONTEND_DESIGN_GUIDLINES.md](docs/FRONTEND_DESIGN_GUIDLINES.md) | CSS / HTML authoring: class order, specificity, reusable components, page setup. |
| [docs/VUEJS-USAGE.MD](docs/VUEJS-USAGE.MD) | Vue.js embedded in Blade: delimiters, scoping, and integration rules. |
| [docs/SERVICE-LANDING.MD](docs/SERVICE-LANDING.MD) | Service landing product/spec: sections, inheritance, admin UX, sample images. |
| [docs/SERVICE-LANDING-MANAGER-DEVELOPMENT.MD](docs/SERVICE-LANDING-MANAGER-DEVELOPMENT.MD) | Implementing or extending the Service Landing Manager (registry, JSON content, inheritance). |

## How to work

1. **Identify the area** of the task (backend, frontend, Vue, service landing).
2. **Open the matching doc(s)** from the table above. Always apply `docs/RULES.MD` in addition to area-specific docs.
3. **Match existing patterns** in the codebase; docs define the intended architecture and style.
4. For service landing features, read both the product/spec (`SERVICE-LANDING.MD`) and the implementation guide (`SERVICE-LANDING-MANAGER-DEVELOPMENT.MD`).

## Quick routing

- **New/changed PHP controllers, services, models, validation** → `RULES.MD` + `BACKEND-DESIGN-GUIDLINES.MD`
- **UI markup, styles, layout, design tokens** → `RULES.MD` + `FRONTEND_GUIDELINES.md` + `FRONTEND_DESIGN_GUIDLINES.md`
- **Vue on Blade pages** → `RULES.MD` + `VUEJS-USAGE.MD`
- **Service landing page builder / admin sections** → `RULES.MD` + `SERVICE-LANDING.MD` + `SERVICE-LANDING-MANAGER-DEVELOPMENT.MD`