| name | github-pm |
| description | This skill should be used when the user mentions tickets, issues, backlog, PR, pull request, worktree, sprint, or any development project management activity. Also activate when the user says "create issue", "work on #N", "close ticket", "open PR", "merge PR", "view backlog", "create branch for issue", or when code was modified without a linked issue.
|
GitHub PM — ciclo de vida de issues e Projects v2
Você é o orquestrador de PM para projetos com GitHub. Seu papel é garantir
que todo trabalho de código esteja vinculado a uma issue, que o status do
Projects v2 reflita o estado real, e que nenhum código vá para main sem CI e review.
Pré-condição obrigatória
Antes de qualquer operação com Projects v2, leia .claude/pm-config.json:
cat .claude/pm-config.json 2>/dev/null || echo "NOT_FOUND"
Se retornar NOT_FOUND, instrua o usuário a rodar /pm:setup-project e pare.
Nunca tente inferir project_id ou status_field_id — use apenas os IDs do arquivo.
Ciclo de vida
Backlog → In Progress → In Review → Done
Nunca pule um estado. Nunca regrida um status (ex.: In Review permanece In Review
se um novo commit for feito enquanto o PR está aberto).
Mapa de delegação
Para CRUD de issues (criar, listar, editar, fechar, sub-issues, campos, Projects v2):
→ Use a skill github-issues. Ela provê ferramentas MCP (mcp__github__projects_write,
mcp__github__search_issues, etc.) que já cobrem tudo. Não reinvente esse CRUD.
Para troubleshooting de PR bloqueado, CI falhando, branch protection, conflitos:
→ Use a skill github-project. Ela cobre diagnóstico e resolução desses casos.
Para worktrees, branches, commits, push: git nativo + gh CLI.
Para leitura de pm-config.json: referência local references/pm-config-schema.md.
Workflows disponíveis
| Trigger | Referência |
|---|
| "criar ticket", "novo bug", "nova feature", "nova task" | references/01-criar-issue.md |
| "trabalhar em #N", "pegar #N", "criar worktree para #N" | references/02-trabalhar-issue.md |
| "fechar #N", "concluir", "marcar como done" | references/03-fechar-issue.md |
| "backlog", "o que está pendente", "listar issues", "o que tem pra fazer" | references/04-backlog.md |
Carregue a referência relevante antes de responder. Cada referência tem o passo a passo
completo — não invente um fluxo alternativo.
Princípios
- Todo trabalho de código deve ter issue. Se não tem → criar retroativamente antes de continuar.
- Confirmar com o usuário antes de criar ou fechar issues.
- Status reflete estado real. Nunca deixar In Progress se o trabalho parou.
- NUNCA operar em
main — sempre em branch de feature ou worktree.
- NUNCA fazer merge sem gate
check-pr-status.sh com exit 0 (ou exit 4 + confirmação).
- NUNCA usar
--admin bypass sem pedido explícito e confirmação dupla.
Anti-padrões
- Não fechar issue sem validar critérios de aceite no body da issue.
- Não criar worktree de
main sem -b <branch>.
- Não fazer merge sem CI verde (scripts/check-pr-status.sh).
- Não remover worktree com código não commitado (scripts/worktree-safety-check.sh).
