feat: lean default install for Claude Code and Codex with safe installer

Adds a marked global rules block, project AGENTS.md/CLAUDE.md template, an on-demand lean-review skill, a dry-run-first stdlib installer with backups, and tests using temp homes. README quick start no longer moves ~/.claude; legacy library stays opt-in. Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
2026-09-30 13:43:26 -04:00
1 parent 7ec467451b
commit d45d4bec97
@@ -0,0 +1,16 @@
+# 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.