---
base_agent: coder
base_agent_version: 3.8.0
mode: extend
---

> **How to use this example**
>
> Copy this file to `.baldart/overlays/agents/coder.md` (drop the `.example`)
> and adapt it to your project. The framework will regenerate
> `.claude/agents/coder.md` from base + overlay on every `npx baldart update`.
>
> Section markers:
> - `## [OVERRIDE] <heading>` — replace the entire matching H2 from the base.
> - `## [APPEND] <heading>`  — add content after the base section.
> - `## [PREPEND] <heading>` — add content before the base section.
> - `## <heading>` with no marker — appended at the end as a new custom section.
>
> The base's frontmatter (`name`, `description`, `tools`, `model`) is preserved
> automatically — do NOT redeclare it in the overlay.

## [APPEND] Quality bar

Project-specific addition that lives in your repo only:

- Before closing any task, run `npm run test:e2e -- --grep <feature>`.
- Attach the Playwright screenshot to the commit body.
- Never push to `develop` without the QA label on the PR.

## [OVERRIDE] When to escalate

In this project, escalate to the human owner BEFORE making any change that
touches `prisma/schema.prisma`, `next.config.ts`, or anything under
`src/lib/billing/`. These paths are policy-protected.

## Project-only conventions

Custom rules with no equivalent in the base — appended as a new H2:

- All API calls go through `src/lib/api-client.ts`. Never call `fetch()` directly.
- Logging always via `src/lib/observability/logger.ts` (no `console.log` in
  production code paths).
- Feature flags live in `src/lib/flags/` and are read via `useFlag(name)`.
