# AGENTS.md

Shared guidance for any AI agent working in this repository. Architecture, conventions, and YAML authoring rules are in [CLAUDE.md](CLAUDE.md) — read that first.

## This is a content-only directory

There is no build step, no `package.json`, and no code here. The Astro project at `../subfolio-astro` reads this directory at build time. Changes here take effect when that project is rebuilt or its dev server reloads.

## Making changes

- **Adding or renaming files** — follow the naming conventions in CLAUDE.md exactly; the loader interprets names, not content type alone.
- **Editing YAML enhancers** — use UTF-8, respect indentation, and use the legacy `description:>` folded-scalar form (no space before `>`). One malformed enhancer file will not break the build (the loader falls back to `{}`), but the enhancer will be silently ignored.
- **Verifying changes** — run `./dev-content.sh` from `../subfolio-astro` with `SUBFOLIO_CONTENT_DIR` pointing here, then load the affected page in a browser. A successful build does not prove a page renders correctly.