From 549d9870d7359f6116bfc00379c9361330defdee Mon Sep 17 00:00:00 2001 From: drzioner Date: Sat, 23 May 2026 16:13:58 -0500 Subject: [PATCH 1/3] docs(readme): fix env var table formatting and add conventions links --- README.es.md | 6 ++++-- README.md | 8 +++++--- 2 files changed, 9 insertions(+), 5 deletions(-) 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 | From 1e7312485ec80369bf6fa56a8e23272fc38e7fa6 Mon Sep 17 00:00:00 2001 From: drzioner Date: Sat, 23 May 2026 16:20:58 -0500 Subject: [PATCH 2/3] docs(readme): fix env var formatting and expose conventions --- .gitignore | 1 - CONVENTIONS.md | 8 ++++++++ 2 files changed, 8 insertions(+), 1 deletion(-) create mode 100644 CONVENTIONS.md 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..35f547f --- /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 `. Never `git stash + checkout`. +- Before large commits: `gitwise audit --quick`. From 08ab8b97f71b8aec5e4db7ef879b7c81b7675aa6 Mon Sep 17 00:00:00 2001 From: drzioner Date: Sat, 23 May 2026 16:35:36 -0500 Subject: [PATCH 3/3] docs(conventions): align title level and placeholder style --- CONVENTIONS.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CONVENTIONS.md b/CONVENTIONS.md index 35f547f..b3c108f 100644 --- a/CONVENTIONS.md +++ b/CONVENTIONS.md @@ -1,8 +1,8 @@ -## Git conventions +# 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: conventional format `feat/fix/refactor/docs/chore: `. - Commits: always GPG-signed. Never `--no-gpg-sign`. - Branch switch: `gitwise worktree new `. Never `git stash + checkout`. - Before large commits: `gitwise audit --quick`.