Como funciona¶

O N45 orquestra subagentes especializados dentro da sua IDE. O fluxo depende do tamanho da requisição.

O fluxo¶

flowchart TD
    User([Usuário]) -->|/n45-feat ou /n45-fix| Triage[Triagem]
    Triage -->|escopo pequeno e claro| Quick[Caminho rápido]
    Triage -->|mudança arquitetural| Structured[Caminho estruturado]
    Quick --> Executor1[Agente executor]
    Structured --> Discovery[Discovery]
    Discovery --> Spec[Spec]
    Spec --> Roadmap[Roadmap]
    Roadmap --> Executor2[Executor + Revisor]
    Executor1 --> Validation[Validação]
    Executor2 --> Validation
    Validation -->|aprovado| Merge[Merge / PR]

Dois caminhos, uma filosofia¶

Caminho rápido — para mudanças pequenas e claras (cor de um botão, correção de typo, refactor menor). O agente de triagem confirma o escopo e dispara um executor numa branch dedicada.

Caminho estruturado — para novos domínios, mudanças de schema, refactors ou qualquer coisa ambígua. O N45 roda discovery completo, monta uma spec, gera um roadmap de tasks e executa em fases — cada uma revisada por um agente dedicado antes de seguir adiante.

A triagem decide o caminho baseada em quatro condições. Se qualquer uma delas falhar (impacto arquitetural, mudança de schema, novo contrato público ou intenção pouco clara), o N45 escala automaticamente para o caminho estruturado.

As regras não-negociáveis¶

• O N45 nunca escreve código diretamente. Toda mudança passa por um agente especializado.
• Você fica no loop. O N45 para e pergunta sempre que uma decisão real precisa ser tomada.
• Seus padrões são respeitados. Na primeira execução, o N45 lê seu codebase e registra os padrões arquiteturais que vai seguir.

Veja Construir uma feature pra ver o fluxo na prática.