pro-workflow (Claude Skill) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Capturar correções como regras duráveis vinculadas ao escopo de arquivo/feature
Surfacear regras relevantes no início de uma tarefa (sem precisar repetir por sessão)
Orquestração paralela de git worktrees para threads de agente concorrentes
Acumula ao longo de 50+ sessões — redução mensurável de deriva
Auto-edições do CLAUDE.md com controle de versão

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pro-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "pro-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "pro-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pro-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "pro-workflow-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "pro-workflow-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/rohitg00/pro-workflow",
          "~/.claude/skills/pro-workflow"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add pro-workflow-skill -- git clone https://github.com/rohitg00/pro-workflow ~/.claude/skills/pro-workflow

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: pro-workflow

Parar de corrigir o Claude Code pela mesma coisa duas vezes

👤 Usuários diários do Claude Code ⏱ ~10 min beginner

Quando usar: Você disse ao Claude «use lodash isEmpty, não !arr.length» três vezes e ele continua revertendo.

Pré-requisitos

Skill instalada no repositório — git clone https://github.com/rohitg00/pro-workflow ~/.claude/skills/pro-workflow

Fluxo

Capturar a próxima correção

Use pro-workflow. Capture this rule: 'Use lodash isEmpty for emptiness checks; never !arr.length'. Scope: src/utils/.✓ Copiado

→ Regra salva com escopo; CLAUDE.md atualizado
Verificar na próxima sessão

Tomorrow: ask Claude to clean up an empty-check pattern in src/utils/.✓ Copiado

→ Claude usa isEmpty sem precisar ser lembrado
Auditar o conjunto de regras mensalmente

List all captured rules. Anything stale or superseded?✓ Copiado

→ Lista de regras com datas de última aplicação; remova entulho

Resultado: Cada correção é paga uma vez, não semanalmente.

Armadilhas

Regras muito abrangentes ('sempre use estilo funcional') têm efeito contrário — Escopo regras para diretórios ou áreas de feature; concreto > geral

Combine com: filesystem

Executar duas threads do Claude Code no mesmo repositório sem conflitos

👤 Devs executando tarefas longas de agente ⏱ ~20 min intermediate

Quando usar: Você quer refatorar o módulo A enquanto o Claude continua uma feature no módulo B.

Fluxo

Criar worktrees

Use pro-workflow. Create two worktrees: ../wt-refactor-a and ../wt-feature-b from main.✓ Copiado

→ Worktrees criadas; regras sincronizadas em cada uma
Executar as threads

Start a Claude Code session in each. Worktree-aware rules apply per directory.✓ Copiado

→ Ambas as sessões rodando; sem conflitos de merge em andamento
Reintegrar

When both branches are ready, open PRs. The skill notes any rules that triggered and their effects.✓ Copiado

→ PRs incluem sumários de efeitos das regras

Resultado: Paralelismo real — throughput do agente multiplicado sem custo de coordenação.

Armadilhas

Regras divergem entre worktrees se atualizadas em apenas uma — A skill sincroniza o conjunto de regras na criação do worktree; para edições contínuas, execute sync-rules

Auditar como o contexto se acumula ao longo de 50 sessões

👤 Líderes de engenharia avaliando fluxos de trabalho com IA ⏱ ~30 min advanced

Quando usar: Você quer dados sobre se «a IA fica mais inteligente neste repositório com o tempo» é real ou percepção.

Fluxo

Baseline

Use pro-workflow. Show me corrections per session over the last 30 days.✓ Copiado

→ Gráfico de tendência; espere curva descendente
Categorizar as correções

Categorize corrections: style, architecture, dependency choice, test pattern. Show category-wise decay.✓ Copiado

→ Tendência por categoria
Decidir

Recommend whether to roll this out team-wide based on data.✓ Copiado

→ Recomendação concreta com ressalvas

Resultado: Decisão fundamentada em dados sobre investimento em fluxo de trabalho com agente.

Armadilhas

Queda nas correções != qualidade crescente — pode ser que você parou de revisar — Compare com feedback de revisão de PR ou taxa de falhas de testes

Combinações

Combine com outros MCPs para 10× de alavancagem

pro-workflow-skill + filesystem

Persistir regras no repositório para o time compartilhar

Commit .claude/rules/ and CLAUDE.md to git; teammates inherit the same rule set.✓ Copiado

pro-workflow-skill + claude-mem-skill

Memória em camadas — pro-workflow para regras, claude-mem para continuidade de sessão

Use pro-workflow to capture corrections; use claude-mem to bridge session context.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
capture_rule	rule_text, scope_path?, severity?	Logo após corrigir o Claude em algo durável
list_rules	scope?	Auditoria / limpeza
create_worktree	branch, path	Iniciar uma thread paralela de agente
sync_rules	—	Após atualizar regras em um worktree, sincronizar com os outros
correction_stats	since?	Auditoria de tendências

Custo e limites

O que custa rodar

Cota de API: Nenhuma — local
Tokens por chamada: Regras surfaceadas adicionam 100–800 tokens ao system prompt; limpeza importa
Monetário: Gratuito
Dica: Audite regras mensalmente; regras muito abrangentes ou desatualizadas custam tokens permanentemente

Segurança

Permissões, segredos, alcance

Escopos mínimos: filesystem-read filesystem-write

Armazenamento de credenciais: Regras armazenadas no repositório (.claude/rules/) — mesma confiança que o repositório

Saída de dados: Nenhuma

Não capture secrets como regras — regras vão para o git

Solução de problemas

Erros comuns e correções

Regra não aplicada na próxima sessão

Verifique o caminho de escopo; a regra pode ter escopo mais estreito que o arquivo que você está editando

Verificar: list_rules --scope /the/file

Edições no CLAUDE.md causando conflitos de merge

A skill escreve regras em arquivo separado; apenas o índice no CLAUDE.md muda — verifique a estratégia de rebase

Criação de worktree falha

git versão >= 2.5 necessária; certifique-se de que nenhum arquivo não rastreado bloqueie o novo caminho

Verificar: git worktree list

Stats não mostram decaimento ao longo de 50 sessões

Provavelmente as regras são muito estreitas para serem aplicadas; execute auditoria e amplie algumas das principais

Alternativas

pro-workflow vs. outros

Alternativa	Quando usar	Troca
claude-reflect (BayramAnnakov)	Você quer uma captura mais passiva orientada a reflexão em vez de explícita	Estilo de captura diferente; menos orquestração de worktrees
Curação manual do CLAUDE.md	Seu time é pequeno e você não se importa de curar regras manualmente	Sem analytics; sem ajuda para worktrees paralelos

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills