diff --git a/.gitignore b/.gitignore
index a9d145d..a34dba7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -36,4 +36,3 @@ CLAUDE.md.bak*
 AGENTS.md.bak*
 # <<< gitwise managed <<<
 .aider.conf.yml
-CONVENTIONS.md
diff --git a/CONVENTIONS.md b/CONVENTIONS.md
new file mode 100644
index 0000000..b3c108f
--- /dev/null
+++ b/CONVENTIONS.md
@@ -0,0 +1,8 @@
+# Git conventions
+
+- Diff: `gitwise diff` (= `git diff --name-status HEAD`). Never raw `git diff`.
+- Log: `git --no-pager log --oneline -n 20`. Never without a limit.
+- Commits: conventional format `feat/fix/refactor/docs/chore: <description>`.
+- Commits: always GPG-signed. Never `--no-gpg-sign`.
+- Branch switch: `gitwise worktree new <branch>`. Never `git stash + checkout`.
+- Before large commits: `gitwise audit --quick`.
diff --git a/README.es.md b/README.es.md
index b4d757e..da25c6a 100644
--- a/README.es.md
+++ b/README.es.md
@@ -80,6 +80,8 @@ Para todos los comandos, ejemplos, aliases y uso JSON:
 - [Política de seguridad](SECURITY.es.md)
 - [Code of Conduct](CODE_OF_CONDUCT.md)
 - [Código de conducta](CODE_OF_CONDUCT.es.md)
+- [Git conventions](CONVENTIONS.md)
+- [Convenciones Git](CONVENTIONS.es.md)
 
 ## Modelo de seguridad y GPG
 
@@ -95,8 +97,8 @@ Para todos los comandos, ejemplos, aliases y uso JSON:
 | `GITWISE_DEBUG=1` | Muestra cada comando `git` ejecutado por subprocess en stderr |
 | `GITWISE_LOG_JSON=1` | Emite logs estructurados en stderr como líneas JSON |
 | `GITWISE_JSON_PRETTY=1` | Formatea JSON en modo pretty por defecto |
-| `GITWISE_LANG=es|en` | Fuerza el locale de salida |
-| `GITWISE_THEME=dark|light|auto` | Fuerza selección de tema de color |
+| `GITWISE_LANG=es` / `GITWISE_LANG=en` | Fuerza el locale de salida |
+| `GITWISE_THEME=dark` / `GITWISE_THEME=light` / `GITWISE_THEME=auto` | Fuerza selección de tema de color |
 | `GITWISE_NO_COLOR=1` | Desactiva salida ANSI con color |
 | `GITWISE_OUTPUT=agent` | Fuerza modo de salida orientado a máquina |
 | `GITWISE_AGENT=1` | Alias para habilitar modo agent |
diff --git a/README.md b/README.md
index 4be3193..5e7a0fd 100644
--- a/README.md
+++ b/README.md
@@ -76,7 +76,9 @@ For all commands, examples, aliases, and JSON usage, see:
 - [Security policy](SECURITY.md)
 - [Politica de seguridad](SECURITY.es.md)
 - [Code of Conduct](CODE_OF_CONDUCT.md)
-- [Codigo de conducta](CODE_OF_CONDUCT.es.md)
+- [Código de conducta](CODE_OF_CONDUCT.es.md)
+- [Git conventions](CONVENTIONS.md)
+- [Convenciones Git](CONVENTIONS.es.md)
 
 ## GPG and Safety Model
 
@@ -92,8 +94,8 @@ For all commands, examples, aliases, and JSON usage, see:
 | `GITWISE_DEBUG=1` | Print each `git` subprocess command to stderr |
 | `GITWISE_LOG_JSON=1` | Emit structured stderr logs as JSON lines |
 | `GITWISE_JSON_PRETTY=1` | Pretty-print JSON output by default |
-| `GITWISE_LANG=es|en` | Force output locale |
-| `GITWISE_THEME=dark|light|auto` | Override color theme selection |
+| `GITWISE_LANG=es` / `GITWISE_LANG=en` | Force output locale |
+| `GITWISE_THEME=dark` / `GITWISE_THEME=light` / `GITWISE_THEME=auto` | Override color theme selection |
 | `GITWISE_NO_COLOR=1` | Disable ANSI color output |
 | `GITWISE_OUTPUT=agent` | Force machine-oriented output mode |
 | `GITWISE_AGENT=1` | Alias to enable agent output mode |