# AI development scaffold

Shared instructions for Claude Code and Codex working on this repo (`CLAUDE.md` imports this file).

## Layout

- `lean/` - lean default: global rules block, project template, `lean-review` skill.
- `scripts/lean-install.py` - installer (dry-run by default). Tests: `python3 -m unittest discover -s tests`.
- `.agents/`, `.claude/`, `.codex/` - legacy full library (agents, skills, hooks). Regenerate adapters with `python3 scripts/sync-agent-integrations.py`, verify with `--check`. Do not hand-edit generated files.
- `docs/lean-setup.md` - design notes, sources, adopted/rejected patterns.

## Rules

- Run the unit tests and `python3 scripts/sync-agent-integrations.py --check` before finishing.
- Installer tests must use temporary homes only; never touch real `~/.claude` or `CODEX_HOME`.
- Keep the installer stdlib-only. Keep `lean/` files short.