agent-project-board-sync

nome: project-board-sync descrição: Sincronizar enxames de IA com os Projetos do GitHub para gerenciamento visual de tarefas, acompanhamento do progresso e coordenação da equipe tipo: coordenação cor: "#A8E6CF" ferramentas:

• Bash
• Ler
• Gravar
• Editar
• Glob
• Grep
• LS
• Tarefas a fazer: Escrever
• mcp__claude-flow__swarm_init
• mcp__claude-flow__agent_spawn
• mcp__claude-flow__task_orchestrate
• mcp__claude-flow__swarm_status
• mcp__claude-flow__memory_usage
• mcp__claude-flow__github_repo_analyze
• mcp__claude-flow__gerenciar-pull-requests-no-github
• mcp__claude-flow__acompanhamento_de_issues_no_GitHub
• mcp__claude-flow__metricas_do_github
• mcp__claude-flow__workflow_create
• mcp__claude-flow__workflow_execute hooks: pre:
  • "gh auth status || (echo 'GitHub CLI não autenticado' && exit 1)"
  • "gh project list --owner @me --limit 1 >$dev$null || echo 'Nenhum projeto acessível'"
  • "git status --porcelain || echo 'Não está no repositório Git'"
  • "gh api user | jq -r '.login' || echo 'Verificação de acesso à API'" post:
  • "gh project list --owner @me --limit 3 | head -5"
  • "gh issue list --limit 3 --json number,title,state"
  • "git branch --show-current || echo 'Não está em um branch'"
  • "gh repo view --json nome,descrição"

Sincronização do Quadro de Projetos - Integração com o GitHub Projects

Visão geral

Sincronize os enxames de IA com os Projetos do GitHub para gerenciamento visual de tarefas, acompanhamento do progresso e coordenação da equipe.

Principais recursos

1. Inicialização do quadro

# Conecte o swarm ao Projeto do GitHub usando a CLI do gh
# Obtenha os detalhes do projeto
PROJECT_ID=$(gh project list --owner @me --format json | \
  jq -r '.projects[] | select(.title == "Development Board") | .id')# Inicialize o enxame com o projeto
npx ruv-swarm github board-init \
  --project-id "$PROJECT_ID" \
  --sync-mode "bidirectional" \
  --create-views "swarm-status,agent-workload,priority"# Criar campos do projeto para acompanhamento do Swarm
gh project field-create $PROJECT_ID --owner @me \
  --name "Status do Swarm" \
  --data-type "SINGLE_SELECT" \
  --single-select-options "pendente,em_andamento,concluído"

2. Sincronização de tarefas

# Sincronizar tarefas do swarm com cartões do projeto
npx ruv-swarm github board-sync \
  --map-status '{
    "todo": "A fazer",
    "in_progress": "Em andamento",
    "review": "Revisão",
    "done": "Concluído"
  }' \
  --auto-move-cards \
  --update-metadata

3. Atualizações em tempo real

# Ativar atualizações do quadro em tempo real
npx ruv-swarm github board-realtime \
  --webhook-endpoint "https:/$api.example.com$github-sync" \
  --update-frequency "immediate" \
  --batch-updates false

Configuração

Configuração de mapeamento do quadro

# .github$board-sync.yml
version: 1
project:
  name: "Quadro de Desenvolvimento de IA"
  number: 1
  
mapping:
  # Mapeie o status das tarefas do Swarm para as colunas do quadro
  status:
    pending: "Backlog"
   assigned: "Pronto"
    in_progress: "Em andamento"
    review: "Revisão"
    completed: "Concluído"
    blocked: "Bloqueado"
    
  # Mapeia os tipos de agentes para rótulos
  agents:
    coder: "🔧 Desenvolvimento"
    testador: "🧪 Testes"
    analista: "📊 Análise"
    designer: "🎨 Design"
    arquiteto: "🏗️ Arquitetura"
    
 # Mapeamento de prioridade para campos do projeto
  prioridade:
    crítica: "🔴 Crítica"
    alta: "🟡 Alta"
    média: "🟢 Média"
    baixa: "⚪ Baixa"
    
  # Campos personalizados
  campos:
   - nome: "Número de agentes"
      tipo: número
      fonte: task.agents.length
    - nome: "Complexidade"
      tipo: seleção
      fonte: task.complexity
   - nome: "Tempo estimado de conclusão"
      tipo: data
      fonte: task.estimatedCompletion

Ver configuração

// Visualizações personalizadas do quadro
{
  "views": [
    {
      "name": "Visão geral do Swarm",
      "type": "board",
      "groupBy": "status",
     "filters": ["is:open"],
      "sort": "priority:desc"
    },
    {
      "name": "Carga de Trabalho dos Agentes",
      "type": "table",
     "groupBy": "assignedAgent",
      "columns": ["title", "status", "priority", "eta"],
      "sort": "eta:asc"
    },
    {
     "name": "Progresso do Sprint",
      "type": "roadmap",
      "dateField": "eta",
      "groupBy": "milestone"
    }
  ]
}

Recursos de automação

1. Atribuição automática

# Atribuir cartões automaticamente aos agentes
npx ruv-swarm github board-auto-assign \
  --strategy "load-balanced" \
  --consider "expertise,workload,availability" \
  --update-cards

2. Acompanhamento do progresso

# Acompanhar e visualizar o progresso
npx ruv-swarm github board-progress \
  --show "burndown,velocity,cycle-time" \
  --time-period "sprint" \
  --export-metrics

3. Movimentação inteligente de cartões

# Transições inteligentes de estado dos cartões
npx ruv-swarm github board-smart-move \
  --rules '{
    "auto-progress": "when:all-subtasks-done",
    "auto-review": "when:tests-pass",
    "auto-done": "when:pr-merged"
  }'

Comandos do quadro

Criar cartões a partir de issues

# Converter issues em cartões de projeto usando a CLI do gh
# Listar issues com uma etiqueta
ISSUES=$(gh issue list --label "enhancement" --json number,title,body)# Adicionar issues ao projeto
echo "$ISSUES" | jq -r '.[].number' | while read -r issue; do
  gh project item-add $PROJECT_ID --owner @me --url "https:/$github.com/$GITHUB_REPOSITORY$issues/$issue"
done# Processar com o swarm
npx ruv-swarm github board-import-issues \
  --issues "$ISSUES" \
  --add-to-column "Backlog" \
  --parse-checklist \
  --assign-agents

Operações em massa

# Operações em massa com cartões
npx ruv-swarm github board-bulk \
  --filter "status:blocked" \
  --action "add-label:needs-attention" \
  --notify-assignees

Modelos de cartões

# Criar cartões a partir de modelos
npx ruv-swarm github board-template \
  --template "feature-development" \
  --variables '{
    "feature": "Autenticação de usuário",
    "priority": "high",
    "agents": ["arquiteto", "programador", "testador"]
  }' \
  --create-subtasks

Sincronização avançada

1. Sincronização entre vários quadros

# Sincronizar entre vários quadros
npx ruv-swarm github multi-board-sync \
  --boards "Desenvolvimento,QA,Lançamento" \
  --sync-rules '{
    "Desenvolvimento->QA": "quando:pronto-para-teste",
    "QA->Lançamento": "quando:testes-aprovados"
  }'

2. Sincronização entre organizações

# Sincronização de painéis entre organizações
npx ruv-swarm github cross-org-sync \
  --source "org1/Project-A" \
  --target "org2/Project-B" \
  --field-mapping "custom" \
  --conflict-resolution "source-wins"

3. Integração com ferramentas externas

# Sincronizar com ferramentas externas
npx ruv-swarm github board-integrate \
  --tool "jira" \
  --mapping "bidirectional" \
  --sync-frequency "5m" \
  --regras-de-transformação "personalizadas"

Visualização e relatórios

Análise do quadro

# Gerar análises do quadro usando dados da CLI do GitHub
# Buscar dados do projeto
PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)# Obter métricas de issues
ISSUE_METRICS=$(echo "$PROJECT_DATA" | jq -r '.items[] | select(.content.type == "Issue")' | \
 while read -r item; do
    ISSUE_NUM=$(echo "$item" | jq -r '.content.number')
    gh issue view $ISSUE_NUM --json createdAt,closedAt,labels,assignees
 done)# Gerar análises com o swarm
npx ruv-swarm github board-analytics \
  --project-data "$PROJECT_DATA" \
  --issue-metrics "$ISSUE_METRICS" \
  --metrics "throughput,cycle-time,wip" \
  --group-by "agent,priority,type" \
  --time-range "30d" \
  --export "dashboard"

Painéis personalizados

// Configuração do painel
{
  "dashboard": {
    "widgets": [
      {
       "type": "chart",
        "title": "Taxa de conclusão de tarefas",
        "data": "completed-per-day",
        "visualization": "line"
      },
      {
        "type": "gauge",
        "title": "Progresso do sprint",
        "data": "sprint-completion",
        "target": 100
      },
      {
        "type": "heatmap",
        "title": "Atividade dos agentes",
        "data": "agent-tasks-per-day"
      }
    ]
  }
}

Relatórios

# Gerar relatórios
npx ruv-swarm github board-report \
  --type "sprint-summary" \
  --format "markdown" \
  --include "velocity,burndown,blockers" \
  --distribute "slack,email"

Integração com fluxo de trabalho

Gerenciamento de sprints

# Gerenciar sprints com o Swarm
npx ruv-swarm github sprint-manage \
  --sprint "Sprint 23" \
  --auto-populate \
  --capacity-planning \
  --track-velocity

Acompanhamento de marcos

# Acompanhar o progresso dos marcos
npx ruv-swarm github milestone-track \
  --milestone "Lançamento da v2.0" \
  --update-board \
  --show-dependencies \
  --predict-completion

Planejamento de lançamento

# Planejar lançamentos usando dados do quadro
npx ruv-swarm github release-plan-board \
  --analyze-velocity \
  --estimate-completion \
  --identify-risks \
  --optimize-scope

Colaboração em equipe

Distribuição de tarefas

# Distribuir o trabalho entre a equipe
npx ruv-swarm github board-distribute \
  --strategy "skills-based" \
  --balance-workload \
  --respect-preferences \
  --notify-assignments

Automação de reuniões diárias

# Gerar relatórios de standup
npx ruv-swarm github standup-report \
  --team "frontend" \
  --include "ontem,hoje,obstáculos" \
  --format "slack" \
  --schedule "daily-9am"

Coordenação de revisões

# Coordenar revisões por meio do quadro
npx ruv-swarm github review-coordinate \
  --board "Revisão de Código" \
  --assign-reviewers \
  --track-feedback \
  --ensure-coverage

Melhores práticas

1. Organização do quadro

• Definições claras das colunas
• Sistema de rotulagem consistente
• Atualização regular do quadro
• Regras de automação

2. Integridade dos dados

• Validação da sincronização bidirecional
• Estratégias de resolução de conflitos
• Trilhas de auditoria
• Backups regulares

3. Adoção pela equipe

• Materiais de treinamento
• Fluxos de trabalho claros
• Revisões regulares
• Ciclos de feedback

Solução de problemas

Problemas de sincronização

# Diagnosticar problemas de sincronização
npx ruv-swarm github board-diagnose \
  --check "permissions,webhooks,rate-limits" \
  --test-sync \
  --show-conflicts

Desempenho

# Otimizar o desempenho do quadro
npx ruv-swarm github board-optimize \
  --analyze-size \
  --archive-completed \
  --index-fields \
  --cache-views

Recuperação de dados

# Recuperar dados do quadro
npx ruv-swarm github board-recover \
  --backup-id "2024-01-15" \
  --restore-cards \
  --preserve-current \
  --merge-conflicts

Exemplos

Quadro de Desenvolvimento Ágil

# Configurar quadro ágil
npx ruv-swarm github agile-board \
  --methodology "scrum" \
  --sprint-length "2w" \
  --ceremonies "planning,review,retro" \
  --metrics "velocity,burndown"

Quadro de fluxo Kanban

# Configurar quadro Kanban
npx ruv-swarm github kanban-board \
  --wip-limits '{
    "Em andamento": 5,
    "Revisão": 3
  }' \
  --cycle-time-tracking \
  --continuous-flow

Quadro de Projetos de Pesquisa

# Configurar quadro de pesquisa
npx ruv-swarm github research-board \
  --phases "ideação,pesquisa,experimento,análise,publicação" \
  --track-citations \
  --collaborate-external

Métricas e KPIs

Métricas de desempenho

# Acompanhar o desempenho do quadro
npx ruv-swarm github board-kpis \
  --metrics '[
    "tempo-médio-de-ciclo",
    "rendimento-por-sprint",
    "porcentagem-de-tempo-bloqueado",
    "taxa-de-aprovação-na-primeira-tentativa"
  ]' \
  --dashboard-url

Métricas da equipe

# Acompanhar o desempenho da equipe
npx ruv-swarm github team-metrics \
  --board "Desenvolvimento" \
  --per-member \
  --include "velocity,quality,collaboration" \
  --anonymous-option

Veja também: swarm-issue.md, multi-repo-swarm.md