configurar-repo
Configura el repositorio de GitHub de punta a punta con gh — descripción, topics, labels, rama develop, protección de ramas, merge settings y metadatos — a partir de la definición del producto. Úsalo
SKILL.md.claude/skills/configurar-repo/SKILL.md
GitHubDeja el repositorio de GitHub operativo y coherente con la plantilla. Requiere gh
autenticado; verifica con gh auth status antes de empezar.
Paso 1 — Contexto
Lee README.md y docs/product/business-model.md para derivar descripción y
topics. Detecta el repo actual (gh repo view). Si no existe remoto, pregunta si
crearlo (gh repo create — público/privado lo decide la persona).
Paso 2 — Metadatos
- Descripción: una frase desde la visión del producto (
gh repo edit --description). Homepage: la URL del producto si existe. - Topics: 3–6 derivados del stack y el dominio (
gh repo edit --add-topic).
Paso 3 — Labels
Ejecuta .github/scripts/setup-labels.sh (usa .github/LABELS.md como catálogo).
Paso 4 — Ramas y flujo
- Crea
developdesdemainsi no existe, publícala y establécela como rama por defecto del repo (gh api -X PATCH repos/{owner}/{repo} -f default_branch=develop) — no es opcional: la rama por defecto es a donde apuntan los PRs nuevos y los de Dependabot; si quedamain, el Git Flow se rompe (CONTRIBUTING.md). - Verifica que
.github/dependabot.ymltengatarget-branch: "develop"en cada ecosistema. - Protección de
main(ydevelopsi la persona quiere): PR obligatorio, sin force-push, conversaciones resueltas y checks requeridos por su nombre de check run, no por el del workflow:Calidad(dequality.yml) yGitleaks(desecret-scan.yml). Si pones el nombre del workflow, el PR se queda esperando un check que nunca reporta. Verifícalos congh api repos/{owner}/{repo}/commits/{sha}/check-runs --jq '.check_runs[].name'sobre un commit que ya haya corrido CI. Aplica víagh api repos/{owner}/{repo}/branches/{branch}/protectiony muestra el JSON antes de aplicar. - Comprueba que los hooks locales corran:
bash .github/scripts/check-hooks-enabled.sh(con--arreglarlos activa).core.hooksPathno viaja en el repositorio, así que el estado por defecto de cualquier clon nuevo es «sin ninguna verificación local».
Si GitHub responde 403 a la protección
gh: Upgrade to GitHub Pro or make this repository public to enable this feature. (HTTP 403)
En un repositorio privado de plan gratuito la protección de ramas no existe. No es
un error suelto que se reporta al final: es un resultado previsto que cambia lo que
el proyecto puede prometer. CONTRIBUTING.md y AGENTS.md declaran PR obligatorio,
nada de push directo a main/develop y checks requeridos para fusionar — y todo eso
lo hace cumplir el servidor. Sin él queda esto:
| Control | Qué cubre | Cómo se salta |
|---|---|---|
git-guardrails.sh |
Push desde una rama protegida | Es un hook del agente: no aplica a la persona |
.githooks/pre-push |
Los checks antes de publicar | git push --no-verify |
core.hooksPath |
Activa lo anterior | Se olvida: es manual, una vez por clon |
Haz tres cosas, en el momento en que aparece el 403:
- Dilo con todas las letras, sin suavizarlo: «este repositorio no tiene protección
de ramas; los hooks locales son el único control y se saltan con
--no-verify». - Plantea la salida real: hacer público el repositorio activa la protección gratis. Es una decisión de producto, no técnica — pregúntala aquí, no después.
- Déjalo por escrito en el
README.mdo en el ADR de instanciación, para que quien llegue después no dé por buenas unas reglas que nadie aplica.
Paso 5 — Ajustes de merge e higiene
- Squash merge habilitado, borrar ramas al mergear, issues habilitados; template de PR/issues ya vienen del repo.
- Verifica que Actions esté habilitado y que los workflows activos (
quality.yml,secret-scan.yml) corran.
Paso 6 — Cierre
Resume qué quedó configurado (con los comandos ejecutados) y regístralo en el CHANGELOG
bajo Unreleased. Y di qué NO quedó protegido, con su consecuencia — no basta con
listar qué falló por permisos: si no hay protección de ramas, el resumen tiene que decir
que las reglas de CONTRIBUTING.md no las hace cumplir nadie (Paso 4).
Reglas: muestra cada comando destructivo o de configuración antes de ejecutarlo la primera vez; NO borres labels/ramas existentes sin confirmar; NO toques repos que no sean el del proyecto actual.