# AGENTS.md

## Project context

- Use the README for the product overview and setup instructions.
- When setup or validation matters, inspect the current manifest, lockfile,
  relevant configuration, and any CI workflow before choosing commands.
- Keep the package manager already used by this repository.

## Making changes

- Follow the patterns in the files you are changing and nearby examples.
- Keep edits within the requested task. Explain any necessary wider change.
- Reuse existing helpers before introducing another implementation.
- When changing a documented command or directory, update its instructions
  in the same change.

## Validation

- Run the relevant checks that actually exist and fit the change.
- If a check needs unavailable dependencies, credentials, or services,
  report the missing prerequisite.
- If no relevant automated check exists, say so and describe the manual
  inspection performed. Do not invent a script or claim an unrun check passed.
- Use setup, migration, seed, and deployment commands only when that work
  is part of the requested task.

## Handoff

- Summarize the change and name the affected files.
- List checks actually run and their outcomes.
- List checks not run, with the reason and any remaining uncertainty.