Puertas de Lanzamiento de GitHub

Gobernanza de lanzamientos respaldada por evidencia para software generado con IA

Enterprise Skills clasifica el riesgo de cada cambio, exige la evidencia adecuada y publica una decisión de lanzamiento explicable y vinculada al commit como verificación obligatoria, y luego demuestra exactamente por qué cada commit llegó a producción. La configuración son cuatro pasos obligatorios, unos diez minutos, más un paso opcional para evidencia producida por agentes.

1. 1

   Instala la GitHub App

   Instala Enterprise Skills Release Governor en los repositorios que quieras gobernar. Los permisos son mínimos: checks (escritura), pull requests, contenidos y metadatos (lectura).

2. 2

   Añade tu clave de licencia como secreto del repositorio

   En tu repositorio: Settings → Secrets and variables → Actions → New repository secret. Llámalo ES_LICENSE_KEY con la clave de licencia de tu correo de compra. La clave nunca aparece en los archivos de workflow. Los límites de repositorios activos siguen tu plan (Pro 3 · Team 10 · Enterprise según contrato).

3. 3

   Añade el workflow del Release Governor

   Crea .github/workflows/release-governor.yml:

   name: Release Governor
   on:
     pull_request:
       types: [opened, synchronize, reopened]
   permissions:
     contents: read
     id-token: write
   jobs:
     govern:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v4
           with:
             ref: ${{ github.event.pull_request.head.sha }}
             fetch-depth: 0
         - uses: actions/setup-node@v4
           with:
             node-version: 20
         - name: Activate license
           run: |
             mkdir -p ~/.enterprise-skills
             node -e "require('fs').writeFileSync(require('os').homedir()+'/.enterprise-skills/license.json', JSON.stringify({ key: process.env.ES_LICENSE_KEY }))"
           env:
             ES_LICENSE_KEY: ${{ secrets.ES_LICENSE_KEY }}
         - name: Govern and post the decision
           run: npx --yes enterprise-skills@^4.3.0 govern --post --pr "$PR_NUMBER" --base "origin/$BASE_REF"
           env:
             PR_NUMBER: ${{ github.event.number }}
             BASE_REF: ${{ github.base_ref }}

   El Governor lee evidencia vinculada al commit desde .project-ai/skill-outputs/ : producida por tu agente revisor para cada cambio. Cada archivo declara el commit contra el que se produjo con un campo commit: <sha> de nivel superior; ejecuta enterprise-skills evidence bind despues de confirmar el cambio para sellarlo. La evidencia faltante de un dominio requerido falla cerrada, y tambien la evidencia sin vinculacion o de un commit anterior.

4. 4

   Opcional: produce evidencia semántica automáticamente

   Cuando un cambio requiere evidencia que ninguna herramienta de CI produce mecánicamente: compatibilidad de API, seguridad de migraciones, preparación de observabilidad/rollback. Puedes dejar que tu propio agente de código la produzca en CI en lugar de depender de que un revisor la suba. Añade este paso antes del paso govern, con tus credenciales de modelo como secreto:

         # Optional: auto-produce semantic evidence before governing.
         # Runs ONLY the agents this diff's risk classification requires.
         - name: Semantic domain agents
           run: npx --yes enterprise-skills@^4.3.0 agents run --yes --base "origin/$BASE_REF" --agent-cmd "claude -p \"{prompt}\" --permission-mode acceptEdits"
           env:
             BASE_REF: ${{ github.base_ref }}
             ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

   La misma clasificación de riesgo que usa el Governor selecciona qué agentes se ejecutan: un cambio de docs no ejecuta ninguno, una migración ejecuta migration-safety, y cada agente debe escribir evidencia con esquema válido sin tocar nada más, o el paso falla cerrado. Cualquier CLI de agente funciona vía --agent-cmd; nunca elegimos un proveedor por ti. La salida del agente es evidencia, nunca política: el Governor determinista sigue tomando la única decisión.

5. 5

   Haz la verificación obligatoria

   Settings del repo → Rules → Rulesets → New branch ruleset: apunta a tu rama por defecto y exige el status check enterprise-skills/release-governor. Desde ese momento, los merges se bloquean hasta que exista una decisión fresca y aprobatoria para el commit exacto.

¿Necesitas una licencia? Ver planes. ¿Preguntas? Centro de ayuda.