FASE. - Framework de Automação Sem Enrolação. Brazilian Portuguese translation of get-shit-done for AI coding assistants
🇧🇷 Tradução brasileira do get-shit-done para Claude Code, OpenCode, Gemini, Codex e Qwen Code.
Spec-driven development, context engineering e meta-prompting — agora em português brasileiro.
Funciona no Mac e Linux. Node.js 20+
"Chega de enrolação. Descreve o que quer e FASE acontecer."
🌐 Visite a Landing Page — Conheça o projeto de forma visual
📖 Documentação Completa — Guias, referência e exemplos
O FASE. é a versão em português brasileiro do Get Shit Done (GSD) — um sistema de meta-prompting e context engineering que faz os assistentes de IA (Claude Code, OpenCode, Gemini, Codex, Qwen Code) funcionarem de verdade em projetos de software.
Ele traz:
Traduzimos:
Mantivemos em inglês:
Suportados agora:
npx fase-ai
O instalador perguntará:
# Claude Code
npx fase-ai --claude
# OpenCode
npx fase-ai --opencode
# Gemini
npx fase-ai --gemini
# Codex
npx fase-ai --codex
# Qwen Code
npx fase-ai --qwen
# Todos os runtimes
npx fase-ai --all
Para projetos em equipe, instale FASE como dev dependency para garantir versão consistente entre todos os desenvolvedores:
# Instalar como dev dependency
npm install --save-dev fase-ai@4.0.0
# Ou com yarn
yarn add --dev fase-ai@4.0.0
# Ou com pnpm
pnpm add --save-dev fase-ai@4.0.0
O FASE será instalado automaticamente via postinstall após o npm install. Para configurar quais runtimes instalar, crie .fase-ai/config.json:
{
"runtimes": ["claude", "opencode"],
"auto_install": true
}
Benefícios:
package.json — todo time usa a mesma versãoApós instalar, teste o comando de ajuda:
# Claude Code / OpenCode / Gemini / Qwen Code
/fase-ajuda
# Codex
$fase-ajuda
Se vir a mensagem de boas-vindas, FASE foi instalado com sucesso! ✅
# Remove FASE do seu sistema
npx fase-ai --uninstall
# Dentro do Claude Code / assistente
/fase-atualizar
Ou via npx (sempre usa a versão mais recente):
npx fase-ai@latest
O FASE verifica automaticamente por atualizações em cada sessão:
SessionStart verifica silenciosamente se há novas versões no npm⬆ /fase:atualizar)Para verificar manualmente:
node ~/.claude/fase-ai/hooks/fase-check-update.js
Quer ver FASE em ação? Temos 3 exemplos reais mostrando diferentes níveis de complexidade:
Construir uma ferramenta de linha de comando simples com FASE.
Refatorar um script grande em partes menores e testáveis.
Implementar uma feature completa com testes, documentação e múltiplas dependências.
👉 Explorar todos os exemplos →
Watch FASE in action. Below are terminal recordings showing real workflows:
# Record your installation session
asciinema rec assets/demo-install.cast
# Then embed in README as:
# <asciinema-player src="assets/demo-install.cast"></asciinema-player>
# Record a workflow session with these steps:
# 1. /fase-novo-projeto
# 2. /fase-planejar-etapa 1
# 3. /fase-executar-etapa 1
# 4. /fase-validar-etapa 1
asciinema rec assets/demo-workflow.cast
Tools to record your own demos:
asciinema — Interactive recordings, embeddable, shareable
npm install -g asciinema
asciinema rec my-recording.cast
asciinema upload my-recording.cast
termtosvg — Generates SVG animations
pip install termtosvg
termtosvg record my-recording.svg
O FASE agora verifica automaticamente por atualizações:
⬆ /fase:atualizar quando há atualizaçãoTodos os comandos e agentes agora usam um padrão universal @~/.fase/ que é convertido automaticamente para caminhos específicos de cada runtime durante a instalação:
~/.claude/fase/~/.config/opencode/fase/~/.gemini/fase/~/.codex/fase/Isso garante que FASE funciona identicamente em todos os 4 runtimes, sem duplicação de código.
FASE é organizado em 4 camadas principais:
Cada agente tem um propósito específico no ciclo de desenvolvimento:
fase-planejador, fase-roadmapperfase-pesquisador-fase, fase-pesquisador-projeto, fase-sintetizador-pesquisafase-executor, fase-mapeador-codigofase-verificador, fase-verificador-plano, fase-verificador-integracaofase-depurador, fase-auditor-nyquistOrganize em categorias por função (planning, research, execution, verification, debug, utility)
Context monitoring para gerenciar estado e histórico automaticamente via integração nativa (settings.json)
Suporta múltiplos runtimes (Claude Code, OpenCode, Gemini, Codex, Qwen Code) com detecção automática
FASE. = Framework de Automação Sem Enrolação
É um trocadilho com "fases de desenvolvimento" porque cada entrega é uma fase concluída, sem burocracia.
A filosofia:
FASE oferece 34 comandos em português brasileiro, organizados por função:
/fase-ajuda # Mostra ajuda completa
/fase-novo-projeto # Inicializa novo projeto com FASE
/fase-configuracoes # Abre painel de configurações
/fase-novo-marco # Cria novo milestone
/fase-planejar-etapa # Detalha planejamento de uma fase
/fase-adicionar-etapa # Adiciona fase ao roadmap
/fase-inserir-etapa # Insere fase em posição específica
/fase-remover-etapa # Remove fase do plano
/fase-progresso # Mostra status de conclusão
/fase-roadmapper # Cria roadmap visual (via agente)
/fase-pesquisar-etapa # Pesquisa contexto para uma fase
/fase-mapear-codigo # Mapeia codebase existente
/fase-listar-premissas # Lista assunções da fase
/fase-planejar-lacunas # Identifica gaps no plano
/fase-verificar-trabalho # Valida código executado
/fase-validar-etapa # Verifica completude de fase
/fase-auditar-marco # Audita um milestone
/fase-checar-tarefas # Revisa task list
/fase-executar-etapa # Executa uma fase completa
/fase-rapido # Modo fast-track para tarefas simples
/fase-adicionar-testes # Gera testes para código
/fase-adicionar-tarefa # Adiciona task ao histórico
/fase-debug # Diagnostica problemas
/fase-depurador # Invoca agente debugger (via agente)
/fase-discutir-etapa # Abre discussão estruturada
/fase-pausar-trabalho # Pausa execução
/fase-retomar-trabalho # Continua de onde parou
/fase-completar-marco # Marca milestone como concluído
/fase-reaplicar-patches # Reaplica correções versionadas
/fase-definir-perfil # Configura perfil de modelo/agente
/fase-limpar # Remove arquivos temporários
/fase-saude # Checkup de saúde do projeto
/fase-atualizar # Atualiza FASE para versão latest
/fase-verificar-instalacao # Verifica instalação e sugere correções
→ Documentação completa: 📚 COMANDOS.md
✅ Projetos pessoais com requisitos bem definidos ✅ MVPs que precisam ir para produção rápido ✅ Refatorações estruturadas de legacies ✅ Automation scripts e ferramentas internas ✅ Prototipagem rápida de ideias ✅ Aprendizado de novas tecnologias/linguagens
❌ Substituto para design de sistema em time ❌ Solução para requisitos vagos ou mal definidos ❌ Ferramenta para escrever documentação de produto ❌ Gerenciador de sprint/kanban (use Jira/Linear para isso)
npm run build — Compila TypeScript e copia static filesnpm test — Executa testes de edge casesnpm run test:all — Executa todos os testes (legacy + moderno)src/ (TypeScript) → dist/ (compilado com static files)FASE possui um pipeline completo de CI/CD automatizado:
Execução: Automaticamente em cada push para main ou pull request
package.json com npm registryv{version} automaticamenteCHANGELOG.mdComo usar:
# 1. Atualize versão em package.json
echo '"version": "4.0.3"' > package.json
# 2. Atualize CHANGELOG.md
echo '## 4.0.3\n- New feature' >> CHANGELOG.md
# 3. Commit e push
git add package.json CHANGELOG.md
git commit -m "chore: bump version 4.0.2 → 4.0.3"
git push origin main
# Workflow automaticamente:
# ✓ Detecta mudança de versão
# ✓ Publica no npm
# ✓ Cria tag v4.0.3
# ✓ Cria GitHub Release
Documentação detalhada: Ver specs/PUBLICAR_NPM_WORKFLOW.md
Trabalhe com especificações claras e deixe o AI transformar em código funcional. Cada fase é uma entrega concreta.
FASE organiza automaticamente o contexto da sua sessão para que o AI sempre tenha as informações certas no local certo.
Pesquisa → Planejamento → Execução → Verificação → Iteração
Cada etapa tem seu agente especializado.
Histórico automático de fases, tarefas e checkpoints. Retome trabalho de onde parou, semanas depois.
Crie seus próprios hooks e customize o comportamento via settings.json nativa.
Funciona com:
FASE. é uma tradução comunitária em português brasileiro do projeto original:
Sem o trabalho incrível da comunidade GSD, isso não existiria. 🙌
Compatibilidade com GSD: FASE mantém total compatibilidade com GSD — todos os agents e comandos usam a mesma arquitetura subjacente, apenas traduzidos para português.
Quer ajudar a traduzir ou melhorar o FASE.?
Precisa de ajuda? Abre uma issue no GitHub.
Instale FASE:
npx fase-ai
Abra seu IDE e inicie um novo projeto:
/fase-novo-projeto
Descreva o que quer construir:
/fase-planejar-etapa para quebrar em fasesExecute as fases:
/fase-executar-etapa
Verifique o trabalho:
/fase-verificar-trabalho
Para mais detalhes, veja 📖 Guia do Usuário.
"Se você sabe claramente o que quer, isso VAI construir pra você. Sem burocracia, sem enrolação."
Feito com 🇧🇷 e 💙 para a comunidade brasileira de devs.
FAQs
FASE. - Framework de Automação Sem Enrolação. Brazilian Portuguese translation of get-shit-done for AI coding assistants
The npm package fase-ai receives a total of 41 weekly downloads. As such, fase-ai popularity was classified as not popular.
We found that fase-ai demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
pnpm 11.5 now recognizes npm staged publish approvals in release metadata, preventing those releases from being mistaken for lower-trust package publishes.
Security News
Federal audit finds NIST lacked a plan to clear the NVD backlog, wasted funds on duplicate work, and delayed use of CISA data.
Research
/Security News
A mini Shai-Hulud campaign compromised Red Hat Cloud Services npm packages to steal developer and CI/CD secrets during installation.