Conheça o Noea Code

O Noea Code (ou simplesmente Noea) ajuda você a entender e decidir como seu software se comporta ao desenvolver com IA. Você escreve os requisitos, um Agente de programação altera o código e você usa explicações da implementação, evidências e pontos de atenção para conferir se o resultado atende às suas expectativas.

Comece com uma única regra em um projeto existente. Um comportamento do produto, uma restrição arquitetural ou um requisito de algoritmo podem ser sua primeira intenção.

A intenção representa os requisitos que você quer que o software continue atendendo. Eles permanecem relevantes depois que uma funcionalidade fica pronta. Quando você decide mudar o comportamento, altera o texto correspondente. Não é preciso descrever o aplicativo inteiro: comece pelo que importa para você.

Conecte a intenção à implementação

Imagine que você está criando um aplicativo de check-in diário e escreve:

Conceder uma recompensa ao usuário após 7 dias consecutivos de check-ins.

Isso estabelece a condição para a recompensa, mas deixa algumas decisões em aberto: o que conta como um dia, o que acontece quando falta um check-in e que tipo de recompensa conceder. O Agente ainda precisará tomar essas decisões ao implementar a regra.

O Noea conecta a frase a uma explicação da implementação. Você pode ler como o código conta os dias, abrir as referências de código ou os materiais de teste que sustentam a explicação e identificar requisitos não atendidos ou decisões que merecem discussão. Se decidir que um dia deve seguir a data do calendário local do usuário, acrescente essa decisão à intenção para que os próximos trabalhos a respeitem.

Conheça os três tipos de conteúdo

Os documentos de intenção são arquivos Markdown. Você pode acompanhar suas alterações com Git ou editá-los em outro editor. O Noea armazena as explicações da implementação separadamente e as exibe em notas à margem. Alguns rótulos da interface em inglês chamam os documentos de intenção de Source, traduzido como Fonte na interface em português; isso é diferente do código na pasta de implementação.

Siga o fluxo de trabalho do dia a dia

1. Esclareça a intenção. Escreva diretamente ou converse com o Agente e revise a redação proposta.
2. Implemente e entenda. Deixe o Agente trabalhar e depois investigue a implementação, lendo a explicação, as evidências e os pontos de atenção.
3. Registre suas decisões. Pergunte sobre um parágrafo específico, acrescente os requisitos que quer manter e continue implementando e conferindo.

Se o código já existe, escreva o requisito que quer conferir e execute Explicar. Se ainda precisar de implementação, use uma conversa ou a ação Implementar.

Você pode aceitar uma decisão que entende sem transformar cada detalhe da implementação em um requisito duradouro. Consulte Ler explicações e evidências para decidir o que deve fazer parte da intenção.

Entenda o papel do Noea e o do Agente

O Noea oferece a área de trabalho para escrever documentos, discutir decisões, revisar alterações e ler explicações. O Agente lê o projeto, usa ferramentas e altera código. Escolha um Agente compatível e use os modelos e métodos de login que ele oferece.

No fluxo de propostas do Noea, alterações nos documentos de intenção exigem sua decisão. Você pode editar e aceitar uma proposta ou descartá-la. Alterações de código e comandos dependem das capacidades e configurações de permissão do Agente.

As explicações da implementação não substituem testes nem o uso direto do software. Confira as evidências dos comportamentos importantes e verifique-os quando necessário.

Comece com uma pergunta pequena e relevante

Escolha algo específico com um resultado observável: quando uma recompensa é concedida, como a falta de estoque é tratada ou uma restrição que uma API deve respeitar. Você pode continuar usando seu processo de desenvolvimento atual no restante do projeto.

A seguir, instale e prepare o Noea e acompanhe seu primeiro fluxo de trabalho.