Context-Driven Development

O Flow implementa uma metodologia de desenvolvimento baseada em contexto que estrutura cada tarefa em três fases distintas: Requisitos, Design e Implementação. Este processo garante alinhamento, rastreabilidade e foco constante na entrega de valor.

Terminal
$ npx @godrix/flow FEATURE_AUTH
🚀 Creating feature task context for: FEATURE_AUTH
✅ Task context created successfully!
📁 Location: .flow/01_FEATURE_AUTH
📄 Files created: APPROACH.md, BUSINESS_CONTEXT.md, COMPLETION_REPORT.md
$ _

Por que usar o Flow?

O Flow cria um ecossistema onde humanos e IA podem colaborar com precisão e propósito.

Metodologia ABC

Approach (Blueprint técnico), Business Context (Requisitos), Completion Report (Evidência)

Integração com IA

Servidor MCP para integração direta com assistentes de IA e geração automática de conteúdo

Templates IA-Friendly

Estrutura com tags delimitadas para fácil compreensão e preenchimento automático

Isolamento por Tarefa

Cada tarefa é independente e isolada, garantindo foco e organização

Rastreabilidade Completa

Documentação automática do progresso e conexão entre ações e objetivos

CLI Intuitivo

Comandos simples e diretos para criar, listar e validar tarefas

👨‍💻🤝🤖 A humanidade é uma coisa boa; a IA é apenas uma extensão dela.

Começar em 3 passos

Instale o Flow e crie sua primeira tarefa estruturada em minutos

1

Instalar

Instale o Flow globalmente via npm

Terminal
npm install -g @godrix/flow
2

Inicializar

Inicialize um novo projeto Flow

Terminal
npx @godrix/flow init --name "Meu Projeto" --mission "Resolver problema X"
3

Criar Tarefa

Crie sua primeira tarefa estruturada

Terminal
npx @godrix/flow FEATURE_AUTH --type feature

Exemplos de Uso

Veja como o Flow estrutura diferentes tipos de tarefas

BUSINESS_CONTEXT.md
# Contexto de Negócio: FEATURE_AUTH

## 🎯 Objetivo
Implementar sistema de autenticação completo para usuários

## 📋 Requisitos Funcionais
- Login com email/senha
- Registro de novos usuários
- Recuperação de senha
- Logout seguro

## ✅ Critérios de Aceitação
- [ ] Usuário pode fazer login com credenciais válidas
- [ ] Usuário pode registrar nova conta
- [ ] Usuário pode recuperar senha esquecida
- [ ] Sessão expira após inatividade

## 🔒 Regras de Negócio
- Senhas devem ter mínimo 8 caracteres
- Emails devem ser únicos
- Sessões expiram em 24h
- Tentativas de login limitadas a 5 por hora
BUSINESS_CONTEXT.md
# Contexto de Negócio: BUG_LOGIN_ISSUE

## 🐛 Problema Identificado
Usuários não conseguem fazer login após atualização

## 🔍 Descrição do Bug
- Login falha com erro 500
- Acontece apenas em produção
- Afeta 100% dos usuários
- Detectado após deploy v2.1.0

## ✅ Critérios de Aceitação
- [ ] Login funciona normalmente
- [ ] Não há regressões
- [ ] Performance mantida
- [ ] Logs de erro corrigidos

## 🚨 Impacto
- **Severidade**: Crítica
- **Usuários afetados**: 100%
- **Prioridade**: P0
BUSINESS_CONTEXT.md
# Contexto de Negócio: IMPROVE_PERFORMANCE

## 🚀 Objetivo
Melhorar performance da aplicação em 50%

## 📊 Métricas Atuais
- Tempo de carregamento: 3.2s
- Bundle size: 2.1MB
- First Contentful Paint: 2.8s
- Largest Contentful Paint: 3.1s

## 🎯 Metas
- Tempo de carregamento: < 1.6s
- Bundle size: < 1.0MB
- First Contentful Paint: < 1.4s
- Largest Contentful Paint: < 1.6s

## ✅ Critérios de Aceitação
- [ ] Performance melhorada em 50%
- [ ] Sem regressões funcionais
- [ ] Métricas validadas em produção
BUSINESS_CONTEXT.md
# Contexto de Negócio: RESEARCH_AI_INTEGRATION

## 🔬 Objetivo
Avaliar integração de IA para automação de testes

## 📋 Escopo da Pesquisa
- Análise de ferramentas disponíveis
- Avaliação de custo-benefício
- Protótipo de integração
- Documentação de recomendações

## ✅ Critérios de Aceitação
- [ ] Relatório comparativo de ferramentas
- [ ] Análise de custo-benefício
- [ ] Protótipo funcional
- [ ] Recomendações documentadas

## 📅 Prazo
- **Duração**: 2 semanas
- **Entregável**: Relatório + Protótipo

Integração MCP

Conecte o Flow diretamente com assistentes de IA para automação completa do desenvolvimento

O que é MCP?

O Model Context Protocol (MCP) permite que assistentes de IA se conectem diretamente ao Flow, executando comandos e gerando conteúdo automaticamente.

🔧 Configuração

Adicione o Flow ao seu assistente de IA favorito:

cursor/mcp_servers.json
{
  "mcpServers": {
    "flow": {
      "command": "npx",
      "args": ["@godrix/flow", "mcp"]
    }
  }
}
claude_desktop_config.json
{
  "mcpServers": {
    "flow": {
      "command": "npx",
      "args": ["@godrix/flow", "mcp"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}
.aider.conf.yml
mcp:
  servers:
    flow:
      command: npx
      args: ["@godrix/flow", "mcp"]

read: AGENTS.md
.gemini/settings.json
{
  "mcpServers": {
    "flow": {
      "command": "npx",
      "args": ["@godrix/flow", "mcp"]
    }
  },
  "contextFileName": "AGENTS.md"
}

🚀 Workflow Completo com IA

Veja como a IA pode interagir automaticamente com o Flow:

1

Inicializar Projeto

A IA cria a estrutura completa do projeto

Comando da IA: "Inicialize um novo projeto Flow para e-commerce"
Ação: init_flow_project()
2

Criar Task

A IA cria uma nova tarefa estruturada

Comando da IA: "Crie uma task para implementar autenticação"
Ação: create_task("FEATURE_AUTH", "feature")
3

Gerar Contexto

A IA gera requisitos detalhados automaticamente

Comando da IA: "Gere o BUSINESS_CONTEXT baseado na descrição"
Ação: generate_business_context()
4

Planejar Implementação

A IA cria o plano técnico detalhado

Comando da IA: "Gere o APPROACH baseado no contexto"
Ação: generate_approach()
5

Documentar Conclusão

A IA documenta o trabalho realizado

Comando da IA: "Após implementar, gere o COMPLETION_REPORT"
Ação: generate_completion_report()

🛠️ Ferramentas Disponíveis

Core Features

  • init_flow_project - Inicializar projeto
  • create_task - Criar tasks
  • list_tasks - Listar tasks
  • validate_task - Validar estrutura
  • get_task_info - Obter informações
  • get_project_status - Estatísticas

AI Integration

  • generate_business_context - Gerar contexto
  • generate_approach - Gerar plano
  • generate_completion_report - Gerar relatório
  • analyze_codebase - Analisar código
  • update_project_context - Atualizar contexto
  • customize_agents - Personalizar AGENTS.md

💡 Exemplo Prático

Veja uma conversa real entre você e a IA:

Você 14:32
Preciso implementar um sistema de carrinho de compras para meu e-commerce. Pode me ajudar a estruturar isso com o Flow?
IA 14:33
Claro! Vou criar uma estrutura completa para o sistema de carrinho. Primeiro, vou inicializar o projeto Flow e depois criar a task específica.

Executando: init_flow_project()
Executando: create_task("FEATURE_CART", "feature")
Executando: generate_business_context()

✅ Estrutura criada! Agora vou gerar o contexto de negócio detalhado...
Você 14:34
Perfeito! Agora preciso do plano técnico para implementar.
IA 14:35
Executando: generate_approach()

✅ Plano técnico gerado! O APPROACH.md agora contém:
• Arquitetura do carrinho
• Modelos de dados
• APIs necessárias
• Estratégia de testes

Pronto para implementação! 🚀

Documentação Completa

Explore todos os recursos e funcionalidades do Flow

Guia de Instalação

Instale e configure o Flow em seu ambiente

Ler mais →

Comandos CLI

Referência completa de todos os comandos

Ler mais →

Integração MCP

Configure integração com assistentes de IA

Ler mais →

Templates

Personalize templates para seu projeto

Ler mais →