INTEGRACIÓN CON GITHUB

Tu repo y tus tareas,
siempre de acuerdo

Cada commit escribe su entrada de changelog, cada PR queda ligado a su tarea y cada merge la avanza. Lo que la IA detecta llega como sugerencia: tú decides.

GitHub App · webhooks · Keep a Changelog · versiones por plataforma

~/code/mi-app · zsh

$ git commit -m "fix: crash en onboarding (ORQ-91)"

$ git push

> Orquestra recibió el push

+ Changelog · Fixed · ligada a ORQ-91

> PR #42 mergeado

ORQ-91 → En revisión

> git tag v1.4.2 && git push --tags

✓ versión 1.4.2 cortada · notas listas para revisar

CONEXIÓN

Conectas una vez,
la usan todos tus proyectos

La conexión vive en el workspace. Cada proyecto elige sus repos de la lista — uno o varios — y cada repo se puede asociar a una plataforma (web, iOS, Android, backend) para llevar versiones y changelog separados.

GitHub App (recomendada)

La instalas desde Workspace → GitHub y eliges qué repos ve. No pegas ningún token: Orquestra usa tokens de instalación que duran una hora y tienen los permisos mínimos. Con la App llegan los eventos en segundos.

Token personal

Sigue disponible como alternativa. Con token, Orquestra revisa tus repos cada hora en vez de recibir eventos al instante, y no puede comentar ni publicar checks en tus PRs.

Cada repo conectado tiene su propio token de servicio, limitado a su proyecto y revocable por separado.

DEL COMMIT AL CHANGELOG

Escribes commits,
sale un changelog

Cada commit que llega a tu repo crea una entrada con su repo, sha y link, en la sección que indica su prefijo — sin IA, con una regla que puedes predecir. Los merges y los commits de bots se ignoran, y un mismo commit nunca se registra dos veces.

Si el mensaje trae el código de la tarea, la entrada queda ligada a ella. Y si el cambio sube la versión en package.json, build.gradle.kts o el proyecto de Xcode, la plataforma se actualiza sola.

feat:Added
fix:Fixed
refactor · perf · chore · style:Changed
remove · revert:Removed
security:Security
deprecate:Deprecated

Cortar una versión, de la forma que ya usas

Por tag

Un tag semver (v1.4.2) en el repo corta la versión en esa plataforma.

Por release de GitHub

Publicar un release la corta al instante. Los borradores y prereleases se ignoran.

A mano

"Nueva versión" arma el borrador con los commits reales y te sugiere si es mayor, menor o parche.

Notas con IA

Al cortar la versión, la IA redacta las notas del release a partir de las entradas. Tú las revisas.

TAREAS, RAMAS Y PRS

De la tarea al merge,
sin copiar links

Crea la rama desde la tarea

Un botón en el detalle de la tarea (o tu agente por MCP) crea la rama ORQ-123-titulo-de-la-tarea desde tu rama base y la deja guardada en la tarea.

Abre el PR borrador

Otro botón abre un PR en borrador desde esa rama, con el código y el link a la tarea. Si abres el PR tú, basta con que el título o la rama lleven el código de la tarea para que quede ligado.

El PR te dice si falta algo

Orquestra publica un check y un comentario en el PR con la tarea ligada y si ya tiene su entrada de changelog.

Al mergear, la tarea avanza

La tarea pasa sola a tu estatus de revisión — no a "hecho": cerrarla sigue siendo decisión tuya. Si el repo es de una plataforma, te propone marcarla como hecha ahí.

En el detalle de cada tarea ves su rama, el PR con su estado, cuántos commits lleva y el commit que la resolvió. El botón Actualizar desde GitHub lo trae en vivo cuando lo necesitas.

ADEMÁS

Lo que pasa en el repo,
llega a tu proyecto

Issues ↔ tareas

Opcional por repo. Un issue abierto crea una tarea de bug en el módulo que elijas, sin duplicados. Cerrar el issue cierra la tarea, y cerrar la tarea cierra el issue. Los comentarios del issue se pueden copiar a la tarea.

Asistente de cierre

Cruza tus tareas abiertas con PRs mergeados, commits a la rama principal y ramas sin mergear, y te propone cuáles ya están resueltas. Nunca cierra nada solo: tú aceptas o descartas.

Revisión con IA cada hora

Cada commit y PR mergeado pasa por una revisión que puede sugerirte un mejor texto para el changelog o avanzar una tarea. Llegan como sugerencias, no como cambios.

CI y deploys

Si falla un workflow de GitHub Actions te llega una notificación, y los deploys exitosos actualizan solos la fecha del último deploy de la plataforma.

DESDE TU AGENTE

Lo mismo, por MCP

Claude Code, Cursor o Codex crean la rama, abren el PR y cortan la versión mientras trabajan. Ver el servidor MCP.

create_task_branch

Crea la rama de la tarea desde la rama base.

open_task_pr

Abre el PR borrador de esa rama.

sync_task_from_github

Trae estado del PR, commits de la rama y el commit que la resolvió.

get_github_activity

Commits, PRs mergeados y ramas recientes del proyecto.

run_closure_scan

Corre el asistente de cierre y deja las propuestas.

release_changelog_version

Corta una versión del changelog.

update_github_issues_sync

Activa o apaga la sincronización de issues por repo.

LO QUE HOY NO HACE

Para que no haya sorpresas

Solo GitHub por ahora. GitLab y Bitbucket no están integrados.
Ligar commits, PRs y cierres depende del código de la tarea (ORQ-123) en el mensaje, el título o la rama.
La sección del changelog sale del prefijo del commit; lo que no sigue la convención cae en Changed.
Con token personal, todo llega en la revisión horaria y sin checks ni comentarios en PRs.

Deja de actualizar
el tablero a mano

Crea tu cuenta, instala la GitHub App en Workspace → GitHub y elige los repos de cada proyecto.