From 0edc7a621894effe763fc3fe254df5bb949527f6 Mon Sep 17 00:00:00 2001
From: Joel Alvarez Mexia <139817810+jeresoftx@users.noreply.github.com>
Date: Wed, 22 Jul 2026 13:39:18 -0700
Subject: [PATCH] =?UTF-8?q?docs:=20registra=20flujo=20de=20coautor=C3=ADa?=
 =?UTF-8?q?=20revisable?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Concepto: la coautoría requiere atribución y revisión humana comprobable.

Problema: la guía no describía el flujo validado por el PR #136.

Alternativas: dejar la práctica implícita o documentar los pasos verificables.

Justificación: registrar autor, coautor, asignación, revisión y squash merge evita automatizar la aprobación.

Co-authored-by: Joel Alvarez D. <124008575+joelalvarezduenas@users.noreply.github.com>
---
 AGENTS.md                 |  3 +++
 docs/higiene-ramas-prs.md | 20 ++++++++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index b65caf5..772e7a3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -62,6 +62,9 @@ issues de GitHub:
   <139817810+jeresoftx@users.noreply.github.com>`; `joelalvarezduenas` usa
   `Joel Alvarez D. <124008575+joelalvarezduenas@users.noreply.github.com>`.
   No se crean PRs vacíos ni se reescribe historial solo por achievements.
+- cuando una coautoría requiera revisión humana, el PR se asigna a
+  `jeresoftx`, solicita revisión de la identidad coautora y solo se fusiona
+  después de su aprobación y de las compuertas aplicables en verde.
 
 Si se usa GitHub Project, debe estar asociado al repositorio, contener todos los
 issues accionables y tener su vista principal agrupada por `Milestone`. No
diff --git a/docs/higiene-ramas-prs.md b/docs/higiene-ramas-prs.md
index d310a6b..e045634 100644
--- a/docs/higiene-ramas-prs.md
+++ b/docs/higiene-ramas-prs.md
@@ -44,6 +44,26 @@ Esta regla no justifica PRs vacíos, commits artificiales ni cambios sin valor.
 Los achievements son secundarios; la trazabilidad, la calidad del curso y la
 revisión humana siguen siendo la prioridad.
 
+### Flujo revisable validado
+
+Cuando la contribución de una segunda identidad requiera revisión humana, se
+usa este flujo completo:
+
+1. La autora principal crea una rama desde `main` actualizado y registra el
+   cambio real con el trailer `Co-authored-by` de la identidad colaboradora.
+2. El PR se asigna a `jeresoftx`, conserva el milestone y los labels del issue,
+   y solicita revisión de la identidad coautora.
+3. La identidad coautora revisa el cambio en GitHub. No se fusiona con una
+   solicitud pendiente ni con una aprobación ausente.
+4. Después de la aprobación humana y de las compuertas en verde, el squash
+   merge conserva tanto `Closes #N` como el trailer `Co-authored-by`.
+
+El [PR #136](https://github.com/jeresoftx/rust-cloud/pull/136) valida este
+flujo: fue asignado a `jeresoftx`, revisado y aprobado por
+`joelalvarezduenas`, y fusionado solo después de esa aprobación. Este patrón
+documenta colaboración real; no autoriza crear trabajo artificial para obtener
+achievements.
+
 ## Antes de crear el PR
 
 El agente debe verificar que la rama nace de `main` actualizado y que solo