# Agent instructions for this project (`resident-kirby`)

Scope these rules to all future code reviews, edits, and checks in this repository.

## Primary code to review/edit
- `src/` (real source for CSS/JS)
- `www/site/` (templates, snippets, blueprints, config)

## Always exclude from review unless explicitly requested
- `www/kirby/` (Kirby CMS core)
- `www/content/` (content files)
- `www/media/` (generated media/cache)
- `www/assets/` (compiled output from CodeKit; do not edit manually)
- `www/vendor/` (Composer dependencies)
- `www/site/plugins/` (third-party/local plugins; treat as external unless user asks)
- `node_modules`

## Build/tooling notes
- CSS/JS source of truth is in `src/`.
- CodeKit compiles:
  - `src/css/` → `www/assets/css/`
  - `src/js/` → `www/assets/js/`
- Do not manually edit compiled files in `www/assets/`.

## Kirby-aware review behavior
- Prefer checking custom app logic in:
  - `www/site/templates/`
  - `www/site/snippets/`
  - `www/site/blueprints/`
  - `www/site/config/`
- Ignore runtime/generated/sensitive folders by default (e.g. `www/site/cache`, `www/site/sessions`, `www/site/accounts`, `www/site/logs`) unless explicitly requested.
- If uncertain whether a path is framework/core/dependency/generated, default to omitting it and ask only when needed.
