docs: sync READMEs — auto-format hook, /cleanup-worktrees, qa agent write scope

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: lvergro

README.md

@@ -19,7 +19,7 @@ Four subagents with **enforced** tool access (via `tools` / `disallowedTools` fr
 | `planner` | Architect + Researcher | `opus` | Read, analyze, design, write to memory/ and docs/ | Bash, code, commits |
 | `builder` | Programmer | `sonnet` | Write code, tests, run commands | Push, force-edit gate-protected areas |
 | `git` | Release Manager | `haiku` | Commits and push | Edit/Write any file |
-| `qa` | QA Validator | `sonnet` | Run tests, browser automation, write reports | (no source-edit restriction yet — by convention) |
+| `qa` | QA Validator | `sonnet` | Run tests, browser automation, write reports | Edit app source (writes limited to QA artifacts + tests — by rule) |
 
 ---
 
@@ -104,6 +104,7 @@ Parallel features? Multiple terminals, each with a different `/feature #N`. Each
 │
 ├── hooks/                              # Lifecycle hooks (run as shell scripts)
 │   ├── gate-check.sh                   #   PreToolUse Edit|Write — blocks gate_protected_areas
+│   ├── auto-format.sh                  #   PostToolUse Edit|Write — formats the modified file
 │   └── session-context.sh              #   SessionStart — injects project-state Current Focus
 │
 ├── rules/                              # Path-scoped rules (load only when matching files touched)
@@ -137,7 +138,8 @@ Parallel features? Multiple terminals, each with a different `/feature #N`. Each
 │   ├── summarize-context/SKILL.md      #   Context compression
 │   ├── write-tests/SKILL.md            #   Test strategy
 │   ├── analyze-architecture/SKILL.md   #   Drift detection
-│   └── archive-state/SKILL.md          #   State lifecycle
+│   ├── archive-state/SKILL.md          #   State lifecycle
+│   └── cleanup-worktrees/SKILL.md      #   /cleanup-worktrees — remove merged worktrees
 │
 └── memory/                             # Compact runtime state — derived from docs/, not duplicated
     ├── architecture.md                 #   Executive summary, ~30 lines (full C4 lives in docs/architecture/)
@@ -344,6 +346,7 @@ Useful when you already have a partial setup and just want to evolve one piece.
 /audit src/auth                                           # security audit on a path
 /sync-schema                                              # force data model sync
 /prepare-commit                                           # validate readiness + draft commit msg
+/cleanup-worktrees                                        # remove worktrees whose PRs merged
 ```
 
 ---

README_ES.md

@@ -19,7 +19,7 @@ Cuatro subagentes con acceso a herramientas **enforced** (mediante `tools` / `di
 | `planner` | Arquitecto + Investigador | `opus` | Leer, analizar, diseñar, escribir en memory/ y docs/ | Bash, código, commits |
 | `builder` | Programador | `sonnet` | Escribir código, tests, ejecutar comandos | Push, editar áreas gate-protected |
 | `git` | Release Manager | `haiku` | Commits y push | Edit/Write de cualquier archivo |
-| `qa` | Validador QA | `sonnet` | Tests, automatización de browser, reportes | (sin restricción de edición de fuente aún — por convención) |
+| `qa` | Validador QA | `sonnet` | Tests, automatización de browser, reportes | Editar código fuente (escrituras limitadas a artefactos QA + tests — por regla) |
 
 ---
 
@@ -104,6 +104,7 @@ PHASE 6 → Cleanup (archivar estado)
 │
 ├── hooks/                              # Hooks de ciclo de vida (corren como shell scripts)
 │   ├── gate-check.sh                   #   PreToolUse Edit|Write — bloquea gate_protected_areas
+│   ├── auto-format.sh                  #   PostToolUse Edit|Write — formatea el archivo modificado
 │   └── session-context.sh              #   SessionStart — inyecta Current Focus de project-state
 │
 ├── rules/                              # Reglas con paths (cargan solo al tocar archivos matching)
@@ -137,7 +138,8 @@ PHASE 6 → Cleanup (archivar estado)
 │   ├── summarize-context/SKILL.md      #   Compresión de contexto
 │   ├── write-tests/SKILL.md            #   Estrategia de tests
 │   ├── analyze-architecture/SKILL.md   #   Detección de drift
-│   └── archive-state/SKILL.md          #   Ciclo de vida del estado
+│   ├── archive-state/SKILL.md          #   Ciclo de vida del estado
+│   └── cleanup-worktrees/SKILL.md      #   /cleanup-worktrees — elimina worktrees mergeados
 │
 └── memory/                             # Estado runtime compacto — derivado de docs/, sin duplicar
     ├── architecture.md                 #   Resumen ejecutivo, ~30 líneas (C4 completo en docs/architecture/)
@@ -344,6 +346,7 @@ No hace falta correr el pipeline completo. Cada fase es una skill standalone:
 /audit src/auth                                           # auditoría de seguridad por path
 /sync-schema                                              # forzar sync del modelo de datos
 /prepare-commit                                           # validar readiness + draft de commit
+/cleanup-worktrees                                        # eliminar worktrees con PR mergeado
 ```
 
 ---