CLAUDE.md Template

# Project Instructions

## Project Overview
[One sentence describing the product and primary runtime.]

## Commands
- Install: `[exact command]`
- Develop: `[exact command]`
- Focused test: `[exact command]`
- Full test: `[exact command]`
- Lint: `[exact command]`
- Type-check: `[exact command]`
- Build: `[exact command]`

## Architecture
- `[path]`: [responsibility and boundary]
- `[path]`: [responsibility and boundary]
- Source of truth for [domain]: `[path]`

## Claude Code Working Agreement
- Explain material assumptions when repository evidence is incomplete.
- Read the nearest implementation and tests before introducing a pattern.
- Preserve unrelated changes and do not rewrite files outside the task.
- Ask before deployments, migrations, destructive operations, or external writes.
- Never read, print, or commit secrets unless the task explicitly requires an approved secret workflow.

## Validation
- Add or update tests when behavior changes.
- Run focused checks while iterating and the required full checks before handoff.
- Report exact commands, outcomes, skipped checks, and remaining risks.

## Optional Shared Instructions
<!-- If AGENTS.md is the shared source, remove this comment and uncomment the next line. -->
<!-- @AGENTS.md -->

# Project Instructions

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

## Architecture
- `[path]`: [responsibility]
- `[path]`: [responsibility]

## Working Agreement
- Inspect existing patterns before editing.
- Keep the diff within the requested scope.
- Never expose or commit secrets.
- Run relevant checks and report their exact results.