Communitygithub.com

Maples7/VibeChard

Worktrees isolados por tarefa para desenvolvimento Apple paralelo com agentes de IA. Execute múltiplas sessões Claude/Codex/Copilot/Cursor no mesmo projeto Xcode sem bloqueios de build.db, conflitos no DerivedData ou colisões de simulador.

O que é VibeChard?

VibeChard é um skill inovador que resolve o problema fundamental de concorrência em ambientes de desenvolvimento Apple com múltiplos agentes de IA. Ele cria worktrees do Git isolados por tarefa, garantindo que cada sessão de um agente como Claude, Codex, Copilot ou Cursor opere em seu próprio espaço de trabalho, eliminando completamente os conflitos de bloqueio do banco de dados de build (build.db), a contenção na pasta DerivedData e colisões de simuladores. Isso permite que desenvolvedores executem fluxos de trabalho paralelos no mesmo projeto Xcode, como revisão de código, geração de funcionalidades e correção de bugs, sem que uma sessão interfira na outra. Suportado em plataformas como Claude Code, Cursor, Windsurf e Cody, o VibeChard é especialmente útil para equipes que utilizam agentes de IA para acelerar o desenvolvimento e precisam manter a integridade do projeto. Ele funciona gerenciando estados de trabalho separados e integrando-se diretamente com ferramentas de IA, fornecendo instruções claras para criar, listar e alternar entre worktrees. Ao automatizar a configuração de pastas DerivedData dedicadas e simuladores independentes, o VibeChard garante compilações rápidas e execução paralela sem erros de compilação, aumentando significativamente a produtividade em projetos iOS e macOS.

Funciona com✓Claude Code✓Codex CLI✓Cursor
npx skills add Maples7/VibeChard

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que VibeChard faz?

Worktrees isolados por tarefa para desenvolvimento Apple paralelo com agentes de IA. Execute múltiplas sessões Claude/Codex/Copilot/Cursor no mesmo projeto Xcode sem bloqueios de build.db, conflitos no DerivedData ou colisões de simulador.

Visão Geral

O VibeChard resolve o problema de agentes de IA enlouquecendo com bloqueios de banco de dados de build, conflitos de DerivedData e colisões de simuladores do Xcode. Ele usa worktrees do Git para dar a cada sessão de IA seu próprio espaço de trabalho limpo, mantendo todos sincronizados com seu branch principal.

Como Funciona

  1. Worktrees Isolados do Git: Cada tarefa recebe um branch e worktree separado. Sem conflitos de arquivos, sem pisar nos calos uns dos outros.
  2. DerivedData Dedicado: Cada worktree é configurado para usar seu próprio diretório DerivedData, evitando colisões de cache de compilação.
  3. Simuladores Independentes: Diferentes sessões podem usar diferentes simuladores ou destinos, evitando conflitos de execução de aplicativos.

Instalação

Adicione o VibeChard ao seu ~/.claude/skills.json, arquivo de configuração .cursorrules ou ferramenta de agente similar.

{
  "maples7-vibechard": {
    "name": "Maples7/VibeChard",
    "url": "https://raw.githubusercontent.com/Maples7/VibeChard/main/skill.md"
  }
}

Uso

Depois que o skill é carregado, seu agente de IA terá acesso aos seguintes comandos:

  • /vh-create <nome-da-tarefa>: Cria um novo worktree e branch para uma tarefa. Muda automaticamente para ele.
  • /vh-list: Lista todos os worktrees ativos e seus branches.
  • /vh-switch <nome-da-tarefa>: Muda para um worktree de tarefa existente.
  • /vh-remove <nome-da-tarefa>: Remove um worktree de tarefa e seu branch (após concluir a tarefa).

Exemplo

# De dentro de uma sessão do Claude Code
/vh-create feature/adicionar-login-biometrico
# O Claude agora opera dentro de worktrees/feature/adicionar-login-biometrico
# com seu próprio DerivedData e configuração de simulador

Plataformas Suportadas

  • Claude Code
  • Cursor
  • Windsurf
  • Cody

Por que VibeChard?

Desenvolvimento Apple com agentes de IA frequentemente leva a:

  • Bloqueios de build.db: Apenas um processo pode escrever no banco de dados de build do Xcode por vez.
  • Conflitos de DerivedData: Compilações simultâneas corrompem os caches uma da outra.
  • Colisões de Simulador: Duas sessões tentam instalar no mesmo simulador, causando falhas.

O VibeChard elimina tudo isso dando a cada sessão de IA seu próprio sandbox.

Licença

MIT

Habilidades Relacionadas