# Arbgjr Sdlc Agentico Github Sync

> GitHub Sync Skill

- Skill: `tomevault-io/arbgjr-sdlc-agentico-github-sync` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/arbgjr-sdlc-agentico-github-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/arbgjr-sdlc-agentico-github-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/arbgjr-sdlc-agentico-github-sync

---


# GitHub Sync Skill

Skill base que fornece utilitarios para sincronizacao com GitHub Issues, Labels e Milestones.

## Objetivo

Prover uma camada de abstracao sobre a API do GitHub para que outros agentes e skills
possam gerenciar issues, labels e milestones de forma consistente e automatizada.

## Scripts Disponiveis

### label_manager.py

Gerencia labels SDLC no repositorio.

```bash
# Criar todos os labels SDLC se nao existem
python3 .claude/skills/github-sync/scripts/label_manager.py ensure

# Listar labels existentes
python3 .claude/skills/github-sync/scripts/label_manager.py list

# Verificar se labels SDLC existem
python3 .claude/skills/github-sync/scripts/label_manager.py check
```

**Labels criados:**
- `phase:0` a `phase:8` - fase atual do SDLC
- `complexity:0` a `complexity:3` - nivel de complexidade
- `type:story`, `type:task`, `type:epic` - tipo de item
- `sdlc:auto` - criado automaticamente pelo SDLC

### milestone_sync.py

Gerencia milestones (sprints) no repositorio.

```bash
# Criar milestone
python3 .claude/skills/github-sync/scripts/milestone_sync.py create \
  --title "Sprint 1" \
  --description "Sprint goal" \
  --due-date "2026-01-28"

# Fechar milestone
python3 .claude/skills/github-sync/scripts/milestone_sync.py close --title "Sprint 1"

# Listar milestones
python3 .claude/skills/github-sync/scripts/milestone_sync.py list

# Obter milestone por titulo
python3 .claude/skills/github-sync/scripts/milestone_sync.py get --title "Sprint 1"
```

### issue_sync.py

Gerencia issues com integracao SDLC.

```bash
# Criar issue com labels SDLC
python3 .claude/skills/github-sync/scripts/issue_sync.py create \
  --title "[TASK-001] Implementar feature X" \
  --body-file task.md \
  --phase 5 \
  --type task \
  --milestone "Sprint 1"

# Atualizar issue
python3 .claude/skills/github-sync/scripts/issue_sync.py update \
  --number 123 \
  --phase 6 \
  --state open

# Sincronizar task YAML para issue
python3 .claude/skills/github-sync/scripts/issue_sync.py sync-task \
  --task-path .agentic_sdlc/projects/xxx/tasks/task-001.yml

# Buscar issue por titulo
python3 .claude/skills/github-sync/scripts/issue_sync.py find --title "[TASK-001]"
```

## Mapeamento SDLC <-> GitHub

| SDLC Agentico | GitHub |
|---------------|--------|
| Sprint | Milestone |
| Sprint goal | Milestone description |
| Sprint end date | Milestone due_on |
| Task | Issue |
| Story | Issue (type:story) |
| Epic | Issue (type:epic) |
| Phase | Label (phase:N) |
| Complexity | Label (complexity:N) |

## Labels por Cor

| Label | Cor | Descricao |
|-------|-----|-----------|
| `phase:0` | #0E8A16 | Preparation |
| `phase:1` | #1D76DB | Discovery |
| `phase:2` | #5319E7 | Requirements |
| `phase:3` | #FBCA04 | Architecture |
| `phase:4` | #F9D0C4 | Planning |
| `phase:5` | #C5DEF5 | Implementation |
| `phase:6` | #BFD4F2 | Quality |
| `phase:7` | #D4C5F9 | Release |
| `phase:8` | #0052CC | Operations |
| `complexity:0` | #C2E0C6 | Quick Flow |
| `complexity:1` | #FEF2C0 | Feature |
| `complexity:2` | #F9D0C4 | BMAD Method |
| `complexity:3` | #E99695 | Enterprise |
| `type:story` | #D93F0B | User Story |
| `type:task` | #0075CA | Task |
| `type:epic` | #7057FF | Epic |
| `sdlc:auto` | #EDEDED | Auto-generated |

## Integracao com Outros Skills

Esta skill e usada por:
- `github-projects` - Para criar issues e adicionar ao project
- `orchestrator` - Para sincronizar estado do SDLC com GitHub
- `delivery-planner` - Para criar milestones de sprints

## Pre-requisitos

- GitHub CLI (`gh`) instalado e autenticado
- Permissoes de escrita no repositorio
- Scope `project` para integracao com Projects V2

```bash
# Verificar autenticacao
gh auth status

# Adicionar scope project se necessario
gh auth refresh -s project
```

## Exemplos de Uso

### Preparar repositorio para SDLC

```bash
# 1. Criar labels
python3 .claude/skills/github-sync/scripts/label_manager.py ensure

# 2. Criar primeiro milestone
python3 .claude/skills/github-sync/scripts/milestone_sync.py create \
  --title "Sprint 1" \
  --description "Inicio do projeto" \
  --due-date "$(date -d '+14 days' +%Y-%m-%d)"
```

### Criar issue para task

```bash
python3 .claude/skills/github-sync/scripts/issue_sync.py create \
  --title "[TASK-001] Implementar autenticacao" \
  --body "## Descricao\n\nImplementar sistema de autenticacao OAuth2.\n\n## Acceptance Criteria\n\n- [ ] Login funcional\n- [ ] Logout funcional" \
  --phase 5 \
  --type task \
  --milestone "Sprint 1"
```

### Transicao de fase

```bash
# Atualizar issue para nova fase
python3 .claude/skills/github-sync/scripts/issue_sync.py update \
  --number 123 \
  --phase 6
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/arbgjr) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->