diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..a538d220
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,14 @@
+# AGENTS.md
+
+## Commit rules
+
+- NEVER use `git commit --no-verify` or any other way to bypass git hooks.
+- NEVER use `git push --no-verify`.
+- The pre-commit hook runs `format:check`, `lint:check`, `typecheck`. Every commit must pass all three.
+- If the hook fails, fix the root cause and retry. Never bypass.
+- Run `pnpm run format:check && pnpm run lint:check && pnpm run typecheck` before committing.
+
+## Generated files
+
+- Do not edit `pnpm-lock.yaml` directly; change dependencies via pnpm.
+- Do not edit `extra/sidecar/` or `node_modules/.temp/`; they are generated by `scripts/prepare.mjs`.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..073ccedf
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,16 @@
+# CLAUDE.md
+
+## Commit rules
+
+- NEVER use `git commit --no-verify` or any other way to bypass git hooks.
+- NEVER use `git push --no-verify`.
+- The pre-commit hook runs `format:check`, `lint:check`, `typecheck`. Every commit must pass all three.
+- If the hook fails, fix the root cause and retry. Never bypass.
+- Run `pnpm run format:check && pnpm run lint:check && pnpm run typecheck` before committing.
+
+## Generated files
+
+- Do not edit `pnpm-lock.yaml` directly; change dependencies via pnpm.
+- Do not edit `extra/sidecar/` or `node_modules/.temp/`; they are generated by `scripts/prepare.mjs`.
+
+Same rules as `AGENTS.md` (for other AI tools).