Padronizador de Repositórios GitHub

Detecta o estado atual de um repositório e, em seguida, aprimora sua superfície: formulários de issues, template de PR, taxonomia de labels, CI, CODEOWNERS, regras, docs. Funciona apenas em metadados e arquivos de configuração do repositório — a lógica do código nunca é tocada. Idempotente — seguro para reexecutar; preenche lacunas e reconcilia desvios sem duplicar ou sobrescrever.

Quando usar

• O usuário diz "padronizar / organizar / profissionalizar este repositório"
• Um novo repositório acabou de ser criado e precisa de templates, labels, CI e regras desde o primeiro dia
• Um repositório parece vazio: sem templates, sem labels, sem CI, sem proteção de branch

Preflight (obrigatório, em ordem)

Requer: gh CLI (autenticado), git, jq, python3 — verifique se eles existem antes de começar (which gh git jq python3).

1. Autenticar — verifique o login do gh primeiro

gh auth status 2>/dev/null || echo "NOT_LOGGED_IN"

• Logado → continue; imprima gh api user -q .login para que o usuário saiba qual conta agirá.
• Não logado → PARE. Diga ao usuário (não adivinhe):
  1. Execute gh auth login (fluxo web/dispositivo), ou
  2. Exporte um token: export GH_TOKEN=ghp_xxx — precisa de repo, workflow (para arquivos de CI) e, para repositórios de organização, admin:org (ou admin:repo_hook / administrador de associação à organização) escopos.
  • Nunca cole tokens em chats, logs ou arquivos. Se o usuário colar um token no chat, aconselhe-o a revogá-lo e reemitir.
  • Se gh auth login for impossível neste ambiente (headless), sugira gh auth login --with-token lendo de um arquivo que o usuário criou.

Verifique se a conta que está agindo pode escrever no destino:

# user repos: no extra check needed beyond token scopes
# org repos: must be a member/admin of the org
gh api "orgs/ORG/memberships/$(gh api user -q .login)" -q .role 2>/dev/null || echo "NO_ORG_ACCESS"

• admin/member → OK. 404 → pare e peça ao usuário para adicionar a conta à organização primeiro.

2. Detectar tipo de repositório

gh repo view OWNER/REPO --json name,owner,visibility,defaultBranchRef,isArchived,isFork \
  -q '{name:.name, ownerType:.owner.type, visibility:.visibility, defaultBranch:.defaultBranchRef.name, archived:.isArchived, fork:.isFork}'

Se o repositório não foi explicitamente nomeado pelo usuário, confirme antes de tocar em um repositório de organização ou privado.

3. Auditar estado atual

gh label list --repo OWNER/REPO --limit 200
gh api repos/OWNER/REPO/contents/.github -q '.[].path' 2>/dev/null || echo "no .github dir"
gh api repos/OWNER/REPO/contents/.github/workflows -q '.[].name' 2>/dev/null || echo "no workflows"
gh api repos/OWNER/REPO/rulesets -q '.[] | {name:.name, enforcement:.enforcement}' 2>/dev/null || echo "no rulesets"
gh api repos/OWNER/REPO/branches -q '.[].name' 2>/dev/null
for f in README.md CONTRIBUTING.md SECURITY.md LICENSE .gitignore; do
  gh api "repos/OWNER/REPO/contents/$f" -q .name 2>/dev/null || echo "missing: $f"
done

4. Detectar framework de testes (para módulo de CI)

Procure por estes sinais (primeira correspondência vence):

gh api repos/OWNER/REPO/contents/package.json -q .name 2>/dev/null   # node → templates/ci-node.yml
gh api repos/OWNER/REPO/contents/pyproject.toml -q .name 2>/dev/null # python → templates/ci-python.yml
gh api repos/OWNER/REPO/contents/go.mod -q .name 2>/dev/null         # go → templates/ci-go.yml
gh api repos/OWNER/REPO/contents/Cargo.toml -q .name 2>/dev/null     # rust → templates/ci-rust.yml

Nenhum sinal → proponha o CI genérico (ou pergunte ao usuário se CI é desejado).

5. Perguntar sobre o idioma (antes de planejar)

• Pergunte ao usuário em qual idioma CONTRIBUTING.md e o template de PR devem ser escritos (padrão: inglês, ou o idioma principal do projeto para projetos locais). Traduza os templates de acordo ao gerar — nunca assuma um idioma.
• (Idiomas do README são perguntados separadamente no Módulo F.)

6. Perguntar sobre automação (decide os labels de Governança)

Pergunte ao usuário se o repositório possui algum bot de automação ou escritor de IA executando nele — por exemplo, dependabot, um bot Stale, ClawSweeper, ou um agente de codificação de IA que abre PRs automaticamente / corrige issues automaticamente.

…