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
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.
.rei/specs/<id>/
Planificación, progreso e historial viven en el repositorio, no en la issue.
Existe, se asigna y se cierra como reflejo del Work Item.
Contiene el trabajo que el Reviewer verifica.
Propone el cambio;
.reisigue 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
ghygitbajo orden explícita del Leader. .reimanda 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, bajointegrations.github.
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.
rei github <enable|disable|status>
Activa, desactiva o consulta la integración opcional GitHub Issues. El CLI nunca llama a GitHub.
rei github enable --repo owner/name --base main --strategy squash
rei github disable
rei github statusUn 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.
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.
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.
É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.
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,
--adminy auto-merge. - Flags de acciones GitHub en rei.
![Cabecera de la GitHub Issue #3 «[prueba v2] Épica: módulo de prueba» con estado Closed y etiquetas rei, rei:epic.](/_next/image?url=%2Fevidence%2Fgh-3-head.png&w=3840&q=75)