REI HARNESS / DOSSIER DE PRODUCTO

HOJA 06 / 06

v0.3.0 · ES

Producto · GitHub Issues

GitHub Issues

Integración opcional GitHub Issues: issue y rama para Features, PR y merge bajo orden, GitHub como proyección.

Integración opcional GitHub Issues · proyección del trabajo

P.01Proyección

Hoja destacada

Una integración opcional

GitHub Issues es una proyección del trabajo, no su fuente de verdad. La integración es opcional: si la clave integrations.github no existe o enabled es false, el flujo es idéntico y el Leader no menciona GitHub Issues.

Proyección, no fuente

.rei/specs/<id>/

fuente de verdad

Planificación, progreso e historial viven en el repositorio, no en la issue.

  • Issue

    Existe, se asigna y se cierra como reflejo del Work Item.

  • Rama

    Contiene el trabajo que el Reviewer verifica.

  • PR

    Propone el cambio; .rei sigue mandando sobre el estado.

Integración opcional: se activa con rei github enable y el flujo funciona sin ella.

  • El CLI nunca llama a GitHub: las acciones reales las ejecutan gh y git bajo orden explícita del Leader.
  • .rei manda sobre la ejecución del Work Item; la issue manda sobre el problema, el alcance y la discusión.
  • La configuración vive en .rei/config.json, bajo integrations.github.

P.02Comandos

Activar, desactivar y consultar

rei github resuelve la configuración con la precedencia flag explícito, valor previo, detección desde git y valor por defecto. status es offline y de solo lectura: no llama a gh ni a la API de GitHub.

  1. rei github <enable|disable|status>

    Activa, desactiva o consulta la integración opcional GitHub Issues. El CLI nunca llama a GitHub.

Configuración
rei github enable --repo owner/name --base main --strategy squash
rei github disable
rei github status

Un flag desconocido, repetido, sin valor o inválido es uso incorrecto y no escribe la configuración. disable conserva repo, base, mergeStrategy y links.json.

P.03Puerta

Issue y rama solo para Features

La puerta issue + rama solo se ejecuta cuando meta.json está en ready, el usuario aprueba, la integración está activa y el Work Item es una Feature. Una Task se trabaja en la rama base, sin issue ni rama, y no existe opt-in para Tasks.

P.04PR y merge

PR y merge bajo orden

Nunca hay commit, push, PR ni merge sin una orden explícita del usuario. La estrategia de merge sale de la configuración —squash por defecto— y el merge no es automático: no hay auto-merge ni --admin.

P.05Épicas

Épicas, backlog y labels

La integración incluye épicas, backlog de hijas, adopción, publicación de la spec, asignación y cierre de la épica. links.json es un índice local recuperable, no la fuente de verdad.

Los marcadores identifican; las labels solo ayudan a una persona. Si un marcador aparece duplicado o hay más de una issue con el mismo marcador, la acción se detiene y se reporta la anomalía.

github.com · issues/3

Cabecera de la GitHub Issue #3 «[prueba v2] Épica: módulo de prueba» con estado Closed y etiquetas rei, rei:epic.
Cabecera de la épica #3, cerrada y con sus labels publicadas · captura del 2026-10-27

P.06Fuera de alcance

Fuera de alcance

  • Projects, milestones y sub-issues nativas.
  • PRs desde fork hacia upstream.
  • Sincronización bidireccional.
  • Work Items pending locales como sustituto del backlog.
  • Autoasignación por carga y time tracking.
  • Proveedores distintos de GitHub.
  • Commits, push o merge automáticos, --admin y auto-merge.
  • Flags de acciones GitHub en rei.