Guia geral do Dev Command Center

Use o DCC como centro de comando local para agentes e terminais

O fluxo principal e simples: escolha um projeto, crie um workspace para a tarefa, abra terminais e agentes lado a lado, revise as mudancas e decida o que entra no codigo. A IA sugere; voce aprova.

ComecarWorkbenchDelegarSkillsCredenciaisMobileTailscaleReferencias
01

Projeto

Escolha um repositorio Git local para o DCC acompanhar.

~/projetos/minha-api
02

Workspace

Crie uma area de trabalho para uma tarefa, branch ou review especifico.

feat/checkout-stripe
03

Panes

Abra terminal, Claude, Gemini, Codex ou Cursor lado a lado no workspace.

Terminal + Claude + Gemini
04

Atencao

Acompanhe quando um agente terminou, precisa de voce ou gerou mudancas para revisar.

toast + sidebar + historico local

Primeiro uso

Como comecar sem se perder

Pense no DCC como um workbench: cada tarefa deve nascer dentro de um workspace explicito. Isso evita trocas de branch desnecessarias, reduz troca de contexto e deixa cada agente trabalhando no lugar certo.

Baixe o desktop pelo GitHub Releases.

Abra o app e registre um repositorio Git local.

Crie um workspace novo para a tarefa atual.

Abra Panes de terminal e agente conforme a necessidade.

Revise diffs, rode testes e faca commit no seu ritmo.

Exemplo mental do fluxo

1. Abra o projeto
2. Crie um workspace para a tarefa
3. Abra um terminal para rodar o app
4. Abra um agente para implementar
5. Abra outro agente para revisar/testar
6. Revise, teste e faca commit

Workbench

Superficies que voce usa durante a tarefa

O DCC junta revisao, codigo, terminal, plano e agentes no mesmo fluxo. A ideia e simples: encontre o contexto certo, selecione o que importa e envie para o agente quando precisar de ajuda.

Inspector

Use para revisar a arvore de arquivos alterados, abrir diffs e decidir o que precisa de atencao antes de aplicar ou commitar.

  1. 1Abra Inspector -> Changes no workspace.
  2. 2Clique em um arquivo para ver o diff.
  3. 3Selecione um trecho, arquivo ou achado relevante.
  4. 4Envie para o Composer ou para um agente com o contexto da selecao.

Dock de codigo

Use como mini editor dentro do DCC para ler, ajustar e separar trechos de codigo sem sair do workbench.

  1. 1Abra o arquivo no dock de codigo.
  2. 2Selecione uma funcao, trecho ou bloco problematico.
  3. 3Envie a selecao para o agente explicar, refatorar ou criar testes.
  4. 4Volte ao Inspector para conferir o diff depois da mudanca.

Terminais

Use terminais para comandos que voce quer controlar diretamente: dev server, testes, lint, migracoes, Git e diagnostico.

  1. 1Abra um Pane de terminal no workspace.
  2. 2Rode comandos no mesmo contexto da tarefa.
  3. 3Mantenha logs visiveis enquanto agentes trabalham.
  4. 4Use a saida do terminal como contexto para o Composer quando precisar.

Composer e Plan

Use o Composer para conversar com o agente e o modo Plan quando quiser alinhar estrategia antes de mudar codigo.

  1. 1Descreva o objetivo no Composer.
  2. 2Peca um plano antes da implementacao.
  3. 3Revise etapas, riscos e arquivos provaveis.
  4. 4Aprove o caminho e so entao siga para implementacao.

Spec

Use specs para transformar uma tarefa ambigua em uma definicao clara de objetivo, escopo, criterios e verificacao.

  1. 1Crie ou abra uma spec no workspace.
  2. 2Registre objetivo, fora de escopo e criterios de aceite.
  3. 3Use a spec como contexto para agentes.
  4. 4Atualize a spec quando a decisao de produto ou engenharia mudar.

Abrir na IDE favorita

Use quando precisar de uma edicao maior no editor que voce ja usa, mantendo o DCC como centro de coordenacao.

  1. 1Escolha sua IDE preferida nas configuracoes quando aplicavel.
  2. 2Abra o workspace em Cursor, Zed ou VS Code.
  3. 3Edite no editor e acompanhe mudancas no Inspector.
  4. 4Volte ao DCC para revisar, delegar, testar e commitar.

Delegacao

O que delegar e como executar

Terminal

Comandos deterministicos, logs, testes, build e Git.

yarn testnpm run lintgit diff --statgit status --short

Agente CLI

Tarefas de codigo em linguagem natural, sempre dentro do workspace aberto.

claudegeminicodex

Provider no DCC

Runtime/provider escolhido no workbench para sessoes, Panes e delegacoes compativeis.

ClaudeGeminiCodexCursor

Hotfix sem perder contexto

  1. 1Crie um workspace temporario a partir da branch de producao.
  2. 2Abra um Pane de terminal para reproduzir o bug.
  3. 3Delegue para um agente investigar a causa e sugerir patch pequeno.
  4. 4Rode testes no terminal, revise o diff e faca commit apenas quando estiver satisfeito.

Prompt exemplo

Investigue a falha de login neste workspace. Proponha o menor patch possivel, explique o risco e aguarde minha revisao antes de ampliar o escopo.

Refatoracao com testes em paralelo

  1. 1Abra um workspace para a refatoracao.
  2. 2Use um Pane com Claude/Codex para alterar a arquitetura.
  3. 3Use outro Pane com Gemini para criar testes e casos de borda.
  4. 4Use o terminal para rodar test suite, lint e inspecionar o diff final.

Prompt exemplo

Refatore este modulo mantendo o contrato publico. Liste arquivos alterados, riscos e comandos de verificacao. Nao mude comportamento fora do escopo.

Review de PR local

  1. 1Crie um workspace a partir da branch do PR.
  2. 2Abra terminal para instalar/rodar o projeto sem tocar no seu setup principal.
  3. 3Delegue para um agente revisar regressao, testes ausentes e legibilidade.
  4. 4Valide manualmente e feche o workspace ao terminar.

Prompt exemplo

Revise esta branch como code review. Priorize bugs, regressao, risco operacional e testes faltando. Responda com achados por severidade.

Delegar um plano para outro modelo executar

O fluxo mais seguro para mudancas maiores e separar planejamento de execucao. Use um modelo na sessao principal para planejar em Plan mode, aprove o caminho, depois delegue a implementacao para outro modelo em uma worktree isolada.

A sessao principal continua sendo o lugar de decisao.

O modelo executor recebe o plano completo e o contexto necessario.

A implementacao aparece como diff revisavel no Inspector.

Voce aplica, pede ajuste ou descarta sem misturar trabalho incompleto.

Formato enviado ao executor

Implement the plan below using the current workspace.

<plano completo capturado pelo Plan mode>

Execution criteria:
- Keep the implementation scoped to this plan.
- Preserve the planner's frontend/design decisions.
- Use the repository's existing patterns and available project skills/instructions.
- Run focused validation where practical and report the exact commands/results.
- End with a concise summary of changed files, decisions, and validation.

Planejar com um modelo, implementar com outro

Use quando voce quer que um modelo pense a estrategia, UX ou arquitetura antes de outro modelo tocar no codigo.

Prompt para o planejador

Planeje uma melhoria compacta para a tela de documentacao. Foque em clareza para usuario final, ordem das secoes e exemplos praticos. Nao implemente ainda.

  1. 1Abra a conversa com o modelo planejador.
  2. 2Ative Plan mode antes de enviar o pedido.
  3. 3Revise o plano retornado e ajuste o escopo se necessario.
  4. 4Clique em Delegate plan.
  5. 5Mantenha Implement e Full reanchor para o executor receber plano, contexto e diff.
  6. 6Envie para o provider de implementacao, por exemplo Codex.
  7. 7Revise o diff no Inspector antes de aplicar.

Linha opcional para o executor

Preserve as decisoes do plano. Rode a validacao mais focada possivel e termine com arquivos alterados, decisoes e resultado dos comandos.

Transformar investigacao em correcao isolada

Use quando o planejador ja encontrou a causa provavel de um bug e voce quer testar a solucao sem sujar o workspace principal.

Prompt para o planejador

Investigue por que o banner de plano continua aparecendo depois que a tarefa ja foi delegada. Retorne um plano curto com arquivos provaveis, risco e validacao. Nao edite arquivos.

  1. 1Leia o plano e confirme se a causa faz sentido.
  2. 2Clique em Delegate plan para abrir a delegacao preenchida.
  3. 3Adicione uma restricao de teste se ela nao estiver no plano.
  4. 4Execute a delegacao em Implement.
  5. 5Use o Inspector para revisar arquivos alterados e diff.
  6. 6Se estiver quase certo, envie feedback para a sessao filha corrigir.
  7. 7Aplique apenas quando o resultado estiver pronto.

Linha opcional para o executor

Inclua ou atualize testes focados para o estado que esconde o banner depois da delegacao.

Spec vira plano, plano vira implementacao

Use quando a tarefa tem criterios de aceite e voce quer manter a trilha Spec -> Plan -> Implementacao revisavel.

Prompt para o planejador

Gere um plano a partir desta spec. Cubra explicitamente os criterios AC-1, AC-2 e AC-3. Nao implemente ainda.

  1. 1Crie ou abra a spec da tarefa.
  2. 2Use Generate plan para pedir o plano em Plan mode.
  3. 3Confira se os passos citam os criterios de aceite.
  4. 4Clique em Delegate plan.
  5. 5Mantenha Full reanchor para levar spec, plano e resumo da sessao.
  6. 6Revise a implementacao contra os criterios no Inspector.
  7. 7Aplique ou descarte a worktree isolada.

Linha opcional para o executor

No resumo final, diga quais criterios foram cobertos e quais comandos validaram a entrega.

Full reanchor

Melhor para Delegate plan. Envia resumo da sessao, spec, plano e diff para o executor continuar da intencao aprovada.

Review current diff

Melhor para uma segunda opiniao sobre as mudancas atuais, sem pedir implementacao nova.

Minimal

Melhor para perguntas pequenas quando contexto demais pode atrapalhar a resposta.

O que voce controla em uma delegacao

Voce escolhe o provider e o tipo de tarefa: Review, Explain ou Implement.

Review gera uma segunda opiniao sobre o trabalho.

Explain investiga e explica uma area do codigo.

Implement cria uma proposta de mudanca para revisar.

O Inspector mostra arquivos alterados e diffs antes de aplicar.

Voce pode enviar feedback para o agente melhorar a proposta.

Voce aplica o resultado quando estiver satisfeito.

Voce descarta a delegacao quando nao quiser usar o resultado.

Skills do DCC

Reutilizar instrucoes em varios agentes

Skills sao instrucoes reutilizaveis para o DCC orientar agentes em tarefas comuns do seu projeto. Em vez de repetir o mesmo prompt toda vez, voce cria uma skill, escolhe os agentes que devem usa-la e segue trabalhando.

Um lugar para padroes do time

Crie skills para tarefas repetidas como revisar PR, escrever testes, investigar bugs, preparar release ou documentar uma mudanca.

Disponivel nos agentes

Depois de salvar, o DCC deixa a skill disponivel para os agentes escolhidos. Voce nao precisa reescrever o mesmo prompt em cada ferramenta.

Controle de uso

Escolha quais agentes recebem a skill e desative a invocacao automatica quando quiser usar aquela instrucao apenas como referencia manual.

Exemplos de skills uteis

revisar-pr

Revisar mudancas por risco, regressao e testes faltando.

criar-testes

Gerar testes para a feature atual seguindo padroes do repo.

investigar-bug

Ler logs, mapear causa provavel e propor menor correcao.

documentar-feature

Atualizar README, docs de uso e exemplos da mudanca.

Claude

Bom para refatoracao, explicacao e implementacao orientada por contexto.

Selecione Claude quando a skill deve orientar sessoes do Claude no DCC.

Codex

Bom para engenharia de codigo, revisao, testes e manutencao de repos.

Selecione Codex quando a skill deve orientar sessoes Codex abertas pelo DCC.

Gemini

Bom para analise ampla, geracao de testes e leitura de contexto longo.

Selecione Gemini quando a skill deve orientar sessoes Gemini no workspace.

Cursor

Bom para manter regras do projeto alinhadas com o editor.

Selecione Cursor quando a skill deve acompanhar o fluxo de edicao no Cursor.

Fluxo dentro do app

  1. 1Abra um projeto/workspace no DCC.
  2. 2Abra Skills pelo workbench.
  3. 3Crie uma skill com nome, descricao e instrucoes.
  4. 4Selecione os agentes que devem receber aquela skill.
  5. 5Salve a skill.
  6. 6Abra um Pane do agente escolhido e use a skill no fluxo de trabalho.

Exemplo de instrucao

Nome: revisar-pr
Descricao: revisar uma branch antes de abrir ou atualizar PR

Instrucao:
- Priorize bugs, regressao e testes ausentes.
- Cite arquivo e linha quando possivel.
- Sugira correcoes, mas aguarde minha aprovacao.
- No final, liste comandos de verificacao.

Credenciais

Preparar GitHub, GitLab e providers para o DCC

Para o DCC usar GitHub, GitLab, CodeRabbit, Codex, Claude, Gemini ou Cursor, faca login nas ferramentas correspondentes no computador onde o app esta instalado. Depois abra o DCC e selecione o projeto normalmente.

GitHub

Faca login no GitHub CLI para o DCC conseguir abrir, consultar e preparar PRs de repositorios GitHub.

GitHub setup

brew install gh
gh auth login
gh auth status
gh auth setup-git
gh repo clone owner/repo
Docs oficiais

GitLab

Faca login no GitLab CLI para o DCC trabalhar com projetos GitLab, incluindo instancias self-managed.

GitLab setup

brew install glab
glab auth login
glab auth status
glab auth login --hostname gitlab.example.com
glab repo clone group/project
Docs oficiais

Codex / OpenAI

Faca login no Codex antes de abrir um Pane Codex no DCC. Use device auth quando estiver em ambiente sem navegador.

Codex / OpenAI setup

codex login
codex login --device-auth
codex
codex --help
ls ~/.codex
Docs oficiais

CodeRabbit

Em Settings > Account, conecte a CLI do CodeRabbit. Depois rode reviews em Inspector > Changes e escolha quais achados enviar para o Composer.

GitHub ou GitLab

Quando o projeto tiver remoto GitHub ou GitLab, o DCC mostra contexto de PR/MR e usa a conta autenticada na CLI correspondente.

Providers

Claude, Gemini, Codex e Cursor precisam estar instalados e autenticados no computador. O DCC abre esses agentes no workspace selecionado.

Checagens uteis

export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."
claude doctor
gemini --version
codex --version

Acesso movel

Parear o celular com o Desktop

O acesso movel serve para acompanhar o workbench quando voce nao esta na frente da tela principal. Pareie o celular pelo QR e use o painel movel para ver agentes em execucao e itens que precisam da sua atencao.

  1. 1No Desktop, abra Settings -> Connections -> Pair new device.
  2. 2Escolha LAN se o celular estiver na mesma rede ou Tailscale se estiver usando rede privada.
  3. 3Escaneie o QR com o celular.
  4. 4Digite o PIN de 6 digitos exibido no Desktop antes que ele expire.
  5. 5Depois de pareado, acompanhe panes, agentes em execucao e itens que precisam da sua atencao.

Boas praticas

Use rede confiavel

Prefira sua rede de casa, escritorio ou Tailscale. Evite Wi-Fi publico para parear.

Ative notificacoes

Use o mobile para perceber quando um agente terminou ou esta aguardando resposta.

Revogue quando necessario

Se trocar de aparelho ou perder o celular, remova o dispositivo pareado em Settings.

Rede

Opcoes para conectar o mobile

Mesma rede Wi-Fi

Use quando desktop e celular estao no mesmo Wi-Fi. E a opcao mais simples para casa ou escritorio confiavel.

Tailscale

Use quando quiser conectar celular e desktop mesmo fora da mesma rede, mantendo ambos na sua tailnet.

Link seguro

Se o navegador bloquear o pareamento por seguranca, use o link recomendado pelo DCC ou conecte pelo Tailscale.

Linux

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale status
tailscale ip -4

macOS com Homebrew

brew install --cask tailscale
open -a Tailscale
tailscale status
tailscale ip -4

iPhone ou Android

Instale Tailscale pela App Store ou Google Play, entre na mesma conta/tailnet do Desktop e confirme que o dispositivo aparece em `tailscale status` no computador.

Fluxo no DCC

Com Tailscale ativo no desktop e no celular, abra Settings -> Connections -> Pair new device, escolha o endpoint Tailscale e escaneie o QR pelo celular.

Links uteis: downloads do Tailscale, instalacao Linux.

Leitura complementar

Documentos do produto

O que e o produto

Definicao, publico, problemas resolvidos e limites do DCC.

Ler documento

Posicionamento

Linguagem e narrativa publica do produto.

Ler documento

Status do produto

Fase atual, distribuicao publica e escopo suportado.

Ler documento