AGENTS.md Template

# Repository Instructions

## Scope
These instructions apply to the entire repository unless a deeper AGENTS.md overrides them.

## Repository Map
- `src/`: application source
- `tests/`: automated tests
- `docs/`: maintained documentation
- `[generated path]`: generated output; do not edit manually

## Commands
- Install dependencies: `[exact command]`
- Start development: `[exact command]`
- Run focused tests: `[exact command with path/filter]`
- Run full tests: `[exact command]`
- Lint: `[exact command]`
- Type-check: `[exact command]`
- Build: `[exact command]`

## Code and Architecture
- Follow the nearest existing implementation for naming and file placement.
- Keep public interfaces backward compatible unless the task explicitly changes them.
- Prefer the existing standard library and dependencies before adding a package.
- Update documentation when behavior or public configuration changes.

## Safety Boundaries
- Never commit credentials, tokens, private keys, or local environment files.
- Do not run deployments, migrations, destructive commands, or external writes without explicit authorization.
- Preserve unrelated working-tree changes.
- Treat authentication, billing, permissions, and data deletion as high-risk areas requiring focused verification.

## Testing
- Add or update tests for changed behavior, including a failure case when relevant.
- Run the narrowest useful check during iteration, then the required full checks before handoff.
- Do not claim a check passed unless its command completed successfully.

## Definition of Done
- Requested behavior is implemented.
- Relevant tests, lint, type checks, and build pass.
- The final diff is scoped and reviewed.
- Documentation and examples match the implementation.
- Handoff lists changed files, commands run, results, and unresolved risks.

# Repository Instructions

## Commands
- Install: `[exact command]`
- Develop: `[exact command]`
- Test: `[exact command]`
- Lint: `[exact command]`
- Build: `[exact command]`

## Project Map
- `[path]`: [what belongs here]
- `[path]`: [what belongs here]

## Working Rules
- Keep changes within the requested scope.
- Follow existing patterns before introducing a new abstraction.
- Do not edit generated files or secrets.

## Definition of Done
- Relevant tests pass.
- Lint and type checks pass.
- The diff contains no unrelated changes.
- Report changed files, checks run, and remaining risks.