Preserve o escopo, os limites de verificação e o progresso de tarefas longas de programação com IA entre sessões.
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português (Brasil)
## O que você pode fazer com o Dev Flow O Dev Flow ajuda a gerenciar tarefas longas de programação com IA no Codex, DeepSeek, Claude Code ou ZCode. Ele salva localmente os requisitos acordados, o escopo de arquivos, o plano de verificação, o progresso e os resultados para você continuar depois que a sessão terminar. - **Definir o escopo:** registre os arquivos previstos e compare as alterações reais com o plano. - **Planejar os testes:** escolha verificações pertinentes e limite o esforço de validação. - **Retomar o trabalho:** continue a mesma tarefa e o trabalho restante no diretório original. - **Consultar resultados:** acompanhe o progresso, as verificações e os problemas que precisam de atenção. É útil para trabalhos em repositórios que atravessam sessões ou precisam de limites claros de arquivos e testes. Para perguntas pontuais, explicações de código e pequenas alterações que não precisam salvar o progresso, usar Codex, DeepSeek, Claude Code ou ZCode diretamente costuma ser mais simples. ## Início rápido > Instale Node.js `>=24` e o Host que pretende usar. Consulte as versões necessárias e as plataformas verificadas na [matriz de suporte](docs/SUPPORT-MATRIX_en.md). ### 1. Instale o Dev Flow A instalação pública abaixo atende às integrações publicadas do Codex e do DeepSeek. Para Claude Code, siga o [guia de instalação pelo código-fonte](docs/CLAUDE_en.md); a CLI pública anterior não instala um Adapter disponível apenas no código-fonte. O ZCode também usa o [guia de instalação pelo código-fonte](docs/ZCODE_en.md). Os pacotes locais têm como alvo Windows x64 e macOS arm64; a validação do ZCode em um Mac ainda está pendente. ```sh npm install -g @imotong/dev-flow@latest dev-flow ``` Escolha seu Host entre as opções do instalador utilizado. No Codex, revise e autorize o hook do Dev Flow em `/hooks`; no DeepSeek, reinicie o Profile selecionado. No Claude Code, recarregue os plugins ou abra uma nova conversa e revise as permissões solicitadas. No ZCode, instale e ative o plugin em Settings → Plugins e abra uma nova conversa para ativar os hooks. Preparar o pacote local não confirma que o ZCode o carregou. ### 2. Inicie uma tarefa Após concluir a instalação correspondente, envie uma destas mensagens na conversa do Host: **Codex** ```text $dev-flow-codex:dev-flow Adicione limite de frequência para falhas de login. Altere apenas arquivos de autenticação e execute no máximo 4 verificações direcionadas. ``` **DeepSeek Harness** ```text /dev-flow Adicione limite de frequência para falhas de login. Altere apenas arquivos de autenticação e execute no máximo 4 verificações direcionadas. ``` **Claude Code** ```text /dev-flow-claude:dev-flow Adicione limite de frequência para falhas de login. Altere apenas arquivos de autenticação e execute no máximo 4 verificações direcionadas. ``` **ZCode** Selecione `dev-flow` no menu `/` → Skills do campo de entrada e descreva a tarefa. ```text Use Dev Flow para limitar falhas de login. Altere apenas arquivos de autenticação e execute no máximo 4 verificações direcionadas. ``` Envie essas mensagens na conversa, não no terminal. Descreva o objetivo, os critérios de aceite, o escopo de arquivos e o limite de testes. A primeira resposta avalia o pedido e pergunta se você quer trabalhar diretamente ou usar o Dev Flow. Ao escolher o Dev Flow, o padrão é criar um novo branch de tarefa a partir do HEAD atual no diretório atual. Confirme o branch e se as alterações existentes ainda não commitadas fazem parte da tarefa. As dependências, configurações locais, arquivos e estado do índice são preservados; a mesma sessão continua quando consegue acessar todos os diretórios participantes. Você também pode escolher explicitamente usar o branch atual ou criar um worktree Git dedicado. Para um worktree, selecione também a origem local ou remota e o branch inicial. O Codex abre o novo diretório quando o ambiente permite; o DeepSeek e o Claude Code fornecem o comando de reinício correspondente. Cada diretório admite apenas uma Task ativa. Edições manuais ou de outras ferramentas também são observadas, e mudar de branch durante a tarefa pausa o processo. Diretórios e branches locais são preservados ao concluir; alterações não commitadas precisam ser consideradas ao iniciar a próxima tarefa. Antes da implementação, revise e discuta os requisitos, o projeto, as tarefas, os arquivos previstos e o plano de verificação. O desenvolvimento começa após sua aprovação explícita do plano completo. Alterações no plano ou ampliação do conjunto de arquivos exigem nova aprovação. Escolher Dev Flow ou um worktree não substitui essa aprovação. ### 3. Retome e acompanhe o progresso Depois de reiniciar a sessão, volte ao diretório original e peça para continuar a tarefa. O Dev Flow retoma o progresso salvo. Se esse diretório sumiu ou foi substituído, a tarefa fica pausada até que você o restaure ou abandone explicitamente a tarefa. No DeepSeek Harness, inclua `/dev-flow` na mensagem que pede para retomar a tarefa. No Claude, volte ao diretório e à conversa originais e peça explicitamente para continuar a tarefa salva com `/dev-flow-claude:dev-flow`. No ZCode, reabra o diretório original, selecione a Skill Dev Flow e peça para continuar a tarefa salva. Se outro diretório for preparado, siga as instruções retornadas para abrir esse espaço de trabalho. Estes comandos usam o gerenciador global instalado. Para instalações pelo código-fonte, use a entrada correspondente do guia. ```bash # Consultar as integrações instaladas dev-flow status --host all # Abrir a visualização local das tarefas dev-flow webui start ``` Para instalação não interativa, Profiles personalizados do DSH, atualizações, reparo e remoção, consulte a [referência de comandos](docs/COMMANDS_en.md). ## Mascote de desktop O mascote exige um Adapter configurado e o aplicativo de desktop instalado. Instalar apenas um Adapter não instala o aplicativo de desktop. O mascote mostra várias tarefas em balões sobrepostos e abre a WebUI de cada uma. Ele prioriza tarefas bloqueadas e passa automaticamente para outra tarefa pendente quando a atual termina; você também pode fixar uma tarefa. É possível personalizar a aparência, controlar animações, ajustar o tamanho e iniciar ou parar o mascote de forma independente. ```bash dev-flow pet start dev-flow pet stop ``` Os aplicativos de desktop são destinados ao macOS arm64 e Windows 10/11 x64. Consulte o [guia do mascote](docs/DESKTOP-PETS_en.md) para instalação e controles, e a [matriz de suporte](docs/SUPPORT-MATRIX_en.md) para a disponibilidade verificada. ## Limites de uso Um worktree dedicado separa as alterações de código. Processos, acesso à rede, credenciais e serviços externos continuam compartilhados com seu ambiente. Concluir uma tarefa não cria commits, envia alterações nem exclui o worktree automaticamente. Essas operações exigem sua autorização separada. ## Documentação - **Uso:** [Codex](docs/CODEX_en.md) · [DeepSeek](docs/DEEPSEEK_en.md) · [Claude Code](docs/CLAUDE_en.md) · [ZCode](docs/ZCODE_en.md) · [Comandos](docs/COMMANDS_en.md) · [Control Center](docs/WEBUI_en.md) - **Projeto:** [Definição do produto](docs/PRODUCT_en.md) · [Matriz de suporte](docs/SUPPORT-MATRIX_en.md) · [Segurança](SECURITY.md) - **Desenvolvimento e contribuições:** [Índice de documentação](MANIFEST_en.md) · [Guia de contribuição](CONTRIBUTING.md) ## Licença [Apache License 2.0](LICENSE)