SDLC Codex
v0.1.0 disponível

Sua próxima aplicação.
Uma equipe inteira construindo.

Orquestre sessões do Codex com planejamento, revisão
e evidências em cada etapa.

Começar a usar Conhecer o fluxo

DO PROJETO À ENTREGA Uma fábrica de software. Cinco sessões em colaboração.

Do plano à entrega, cada papel tem uma responsabilidade

  1. Planejarplanner
  2. Construirdev
  3. Revisarreviewer
  4. Testartester-e2e
  5. Documentardocument

Cada papel tem contexto. Cada entrega tem evidências.

CONVERSA DE VERDADE

Sessões independentes.
Um objetivo em comum.

O desenvolvedor pergunta. O revisor responde. Cada sessão mantém seu contexto e conversa com o time nos dois sentidos.

CONTINUIDADE

O trabalho continua
de onde parou.

Estado, mensagens e checkpoints persistidos permitem retomar uma demanda com rastreabilidade entre as etapas.

CONTROLE HUMANO

A entrega tem provas.
A decisão é sua.

Plano aprovado, revisão independente e testes verificáveis. O fluxo termina com uma PR; merge e deploy dependem de você.

INSTALAÇÃO · WINDOWS NATIVO

Primeiro, prepare sua máquina.

O SDLC Codex coordena ferramentas instaladas no seu computador. Instale os componentes abaixo e depois confira o ambiente no terminal.

Já tenho os requisitos ↓

Codex CLI

Autenticado · queue · hooks

Executa cada agente do time. Siga a instalação oficial, abra codex e conclua o login. A versão instalada precisa oferecer queue e hooks.

Instalar Codex CLI ↗ (abre em nova aba)

Herdr

Terminal do time

Organiza as sessões Codex em abas e painéis. É necessário para abrir o time com sdlc-codex up; o SDLC Codex não instala o Herdr automaticamente.

Instalar Herdr ↗ (abre em nova aba)
Como instalar e abrir o Herdr no Windows?
  1. Abra o guia oficial de instalação (nova aba) e siga a opção Windows.
  2. Se preferir o download manual, vá às releases oficiais (nova aba) e baixe herdr-windows-x86_64.zip. Extraia a pasta inteira: mantenha herdr.exe e os arquivos de runtime juntos.
  3. No download manual, adicione a pasta extraída ao PATH do usuário. Reabra o terminal para carregar o novo PATH.
  4. Execute herdr --version para conferir a instalação e herdr para abrir o aplicativo no terminal.

O SDLC Codex foi validado com Herdr 0.7.5-preview. A versão atual oferecida pelo instalador pode ser diferente: confira a compatibilidade com doctor antes de abrir o time.

Quais acessos e versões preciso conferir?

A base validada do projeto usa Windows nativo, Node.js 22, Codex CLI 0.155.1 e Herdr 0.7.5-preview. Isso não garante compatibilidade automática com toda versão posterior. Veja o registro de compatibilidade.

Para baixar o SDLC Codex, sua conta GitHub precisa de acesso ao repositório privado. Para fluxos feature e hotfix, o projeto atendido precisa de um remoto GitHub e de permissão para publicar a branch e abrir PR. O Codex precisa estar autenticado com acesso ao modelo que será usado.

DO PRIMEIRO PROMPT À PRIMEIRA ENTREGA

Seu time começa
com uma conversa.

Siga as quatro etapas no PowerShell ou escolha um prompt para orientar o Codex. Os botões copiam instruções; nada é executado pela página.

Ler a documentação completa
Confira as ferramentas instaladasPOWERSHELL
node --version
npm --version
git --version
gh --version
herdr --version
codex --version
codex login status
codex queue --help
codex features list
gh auth status
Cada comando deve ser reconhecido antes de continuar.

Pré-requisitos: Windows, Node.js 22+, Git, GitHub CLI, Codex CLI autenticado e Herdr. O repositório é privado: sua conta precisa ter acesso.

Algo não funcionou na instalação?
  • Comando não encontrado: reabra o terminal e confira o PATH. Para o SDLC Codex, consulte npm prefix --global e confira se essa pasta está no PATH.
  • PowerShell bloqueou o shim .ps1: tente sdlc-codex.cmd --help ou npm.cmd, sem alterar a política global.
  • GitHub retornou 404 ou acesso negado: confira gh auth status e o acesso ao repositório privado.
  • queue, hooks ou Herdr incompatíveis: confira as versões no registro de compatibilidade. Depois de instalar o SDLC Codex, use sdlc-codex doctor --project . --json.
  • doctor apontou configuração ausente: em um projeto ainda não adotado, prepare o arquivo de configuração na etapa 03. Resolva também os erros de ferramentas antes de abrir o time.
CHANGELOG

O projeto evolui.
Você acompanha.

O que chegou e o que ainda
estamos explorando.

REGISTRO DE EVOLUÇÃOVer releases ↗
v0.1.0

Um time completo, no seu terminal.

Cinco papéis, mensagens bidirecionais, revisão com evidências e recuperação por checkpoint. Primeira release privada do SDLC Codex.

OrquestraçãoCLIWindows
Notas da versão
Em pesquisaSEM DATA DEFINIDA

Mais possibilidades. O mesmo método.

Pesquisa de provedores como DeepSeek e GLM. Validações adicionais de projetos em paralelo e instalação em máquina limpa.

ProvedoresValidaçãoExperiência de uso
ANTES DE COMEÇAR

Contexto para
o próximo passo.

É um painel web para controlar meus agentes?

O SDLC Codex é um CLI local. Ele organiza sessões independentes do Codex no Herdr. Esta página apresenta o projeto e ensina a usá-lo; não monitora nem executa suas sessões.

Posso pedir ao próprio Codex para preparar o projeto?

Sim. No tutorial, escolha “Prompt para o Codex”. O agente verifica o ambiente, prepara a configuração e abre o time. A execução da demanda depende do plano e dos artefatos de aprovação exigidos pelo método.

O time faz merge ou deploy automaticamente?

Não. O fluxo feature passa por desenvolvimento, revisão, testes, PR, revisão da PR e documentação. Merge, deploy e mudanças fora do escopo continuam sob decisão humana.

Já posso usar DeepSeek, GLM ou outros provedores?

A primeira versão usa os modelos disponíveis na sua instalação do Codex. A compatibilidade com provedores externos ainda está em pesquisa e não foi demonstrada.

DO PLANO AO CÓDIGO. COM MÉTODO.

Pronto para abrir seu primeiro time?

Siga o tutorial e coloque o SDLC Codex em ação no seu projeto.

Abrir tutorial