Ir para o conteúdo

Construir uma feature

Use /n45-feat sempre que quiser adicionar ou melhorar algo — um novo endpoint, uma mudança de UI, um novo domínio, qualquer coisa de uma correção de typo a um sistema de autenticação completo.

O N45 decide automaticamente entre o caminho rápido (aplicar a mudança direto) ou o caminho estruturado (discovery → spec → roadmap → execução completos). A decisão é tomada durante a triagem com base em quatro condições.

As quatro condições

Todas as quatro precisam ser verdadeiras pro caminho rápido. Se qualquer uma falhar, o N45 escala pro caminho estruturado.

Condição O que significa
Intenção clara Pedido específico. Sem decisões pendentes do tipo "deveria ser X ou Y?"
Sem mudança arquitetural Sem novo módulo, padrão ou abstração
Sem schema ou migration Banco intacto — sem CREATE / ALTER / DROP
Sem novo contrato público Sem novo endpoint, breaking change de API, evento de webhook ou flag pública

O fluxo

flowchart TD
    Start([/n45-feat]) --> Triage[Triagem]
    Triage --> Project[Lê padrões do projeto
STACK · PATTERNS · PROJECT]
    Project --> Ask[Clarificar intenção e escopo]
    Ask --> Plan[Apresentar plano]
    Plan --> Decision{Condições do
caminho rápido?}
    Decision -->|todas as 4 atendidas| Quick[Caminho rápido
branch + executor]
    Decision -->|alguma falha| Structured[Caminho estruturado
discovery + spec + roadmap]
    Quick --> Validation
    Structured --> Validation
    Validation([Validação])

A triagem sempre roda primeiro, e sempre lê os documentos fundamentais do seu projeto — mesmo no caminho rápido. É assim que o N45 evita quebrar padrões arquiteturais em mudanças pequenas.

Após o plano ser apresentado, você confirma antes de qualquer mudança ir adiante:

Confirmar feat
Aplicar a mudança proposta no codebase?

Caminho rápido — exemplo

"Trocar a cor de fundo do botão primário de azul pra violeta."

  1. O N45 lê PATTERNS pra entender suas convenções de CSS/estilo
  2. Confirma o escopo: um componente, uma linha num stylesheet
  3. Decide: caminho rápido — todas as quatro condições atendidas
  4. Cria uma branch dedicada (quick-feat/button-violet)
  5. Dispara o executor com a mudança precisa
  6. Retorna: arquivos modificados, resumo, como testar
  7. Você valida → commit → merge

Tempo total: cerca de 1 minuto.

Caminho estruturado — exemplo

"Adicionar login com Google OAuth ao lado de email/senha."

  1. O N45 lê os padrões do projeto e confirma o escopo
  2. Triagem detecta um novo contrato público (endpoint /auth/google) — falha a condição 4
  3. Decide: caminho estruturado
  4. Roda discovery completo — explora código de auth, pergunta sobre modelo de sessão, escopos, URLs de redirect
  5. Gera uma spec — fluxos propostos, endpoints, persistência, casos de erro
  6. Você revisa e aprova a spec
  7. O N45 gera um roadmap com fases (DB → backend → frontend → testes)
  8. Cada fase passa por agentes dedicados (executor + revisor por task)
  9. Após todas as fases passarem na revisão, você entra na validação
  10. Aprovado → merge ou PR

Tempo total: minutos a horas dependendo do escopo. Você é consultado em cada decisão relevante.

O que é criado

  • Caminho rápido: uma branch, um commit, opcionalmente um PR
  • Caminho estruturado: acima, mais artefatos permanentes dentro de .n45/:
    • Um documento de discovery
    • Uma spec
    • Um roadmap com tasks
    • Uma retrospectiva no fechamento

Esses artefatos permitem que execuções futuras construam sobre o contexto anterior — inclusive o seu, semanas depois.

Veja também