docs: document joelalvarezduenas coauthoring

AGENTS.md

@@ -56,11 +56,12 @@ issues de GitHub:
 - cada PR asignado a `jeresoftx`, asociado al milestone del issue y con labels;
 - no fusionar PR sin revisión humana, salvo autorización explícita de modo
   autónomo con revisión diferida.
-- si un bloque busca contar para Pair Extraordinaire de `jeresoftx`, el commit
-  debe llevar `Co-authored-by: Joel Alvarez Mexia
-  <139817810+jeresoftx@users.noreply.github.com>` y `jeresoftx` no debe ser el
-  autor principal; no se crean PRs vacíos ni se reescribe historial solo por
-  achievements.
+- si un bloque busca contar para Pair Extraordinaire, la cuenta destinataria no
+  debe ser autora principal y el trailer debe usar su correo noreply correcto:
+  `jeresoftx` usa `Joel Alvarez Mexia
+  <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.
 
 Si se usa GitHub Project, debe estar asociado al repositorio, contener todos los
 issues accionables y tener su vista principal agrupada por `Milestone`. No

docs/higiene-ramas-prs.md

@@ -23,27 +23,22 @@ asignación, milestone y labels, además de cerrar el issue con `Closes #N`.
 
 ## Coautoría para Pair Extraordinaire
 
-Si el objetivo explícito del bloque es que el achievement Pair Extraordinaire
-cuente para `jeresoftx`, `jeresoftx` no debe quedar como autor principal del
-commit. GitHub atribuye el achievement al usuario que aparece como coautor
-válido, siempre que el correo del trailer `Co-authored-by` pertenezca a esa
-cuenta.
-
-Por eso, para que cuente hacia `jeresoftx`, el commit principal y el squash
-merge deben incluir:
-
-```text
-Co-authored-by: Joel Alvarez Mexia <139817810+jeresoftx@users.noreply.github.com>
-```
-
-No usar para ese objetivo:
-
-```text
-Co-authored-by: Joel Alvarez D. <124008575+joelalvarezduenas@users.noreply.github.com>
-```
-
-Ese correo pertenece a otra identidad y puede atribuir la coautoría fuera de
-`jeresoftx`.
+Cuando un bloque real requiera acreditar la coautoría a una identidad concreta,
+esa identidad no debe quedar como autora principal. GitHub puede reconocer la
+coautoría cuando el trailer `Co-authored-by` utiliza un correo asociado a la
+cuenta; la elegibilidad final la determina GitHub.
+
+El commit principal y el squash merge deben conservar el trailer de la cuenta
+destinataria:
+
+| Cuenta destinataria | Trailer válido |
+| --- | --- |
+| `jeresoftx` | `Co-authored-by: Joel Alvarez Mexia <139817810+jeresoftx@users.noreply.github.com>` |
+| `joelalvarezduenas` | `Co-authored-by: Joel Alvarez D. <124008575+joelalvarezduenas@users.noreply.github.com>` |
+
+El correo válido de una cuenta no sustituye al de la otra: se elige según la
+identidad que deba recibir la atribución. Antes de fusionar, confirmar que el
+autor principal corresponde a una identidad distinta de la destinataria.
 
 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