NOEA CODE BETA

Na era da AGI,
sua intenção importa mais.

Noea Code. Programação com IA guiada pela sua intenção.

macOS · Windows · Linux

A funcionalidade foi entregue.
Na próxima vez que precisar mudar,
não tenho certeza de que consigo.

A aceitação passou e a tarefa foi fechada. Alguns dias depois chegou um novo requisito, e percebi que não sabia explicar por que ela funciona do jeito que funciona.

Este é o meu projeto.
Algumas decisões,
não sei dizer por que foram tomadas.

Alguém pergunta sobre um comportamento. Vasculho conversas, documentos e código para explicar por que foi feito assim, e não consigo achar onde isso está registrado.

Fiz mais coisas.
Afinal, o que eu acumulei de fato?

Tarefa após tarefa, eu de fato sei mais. Mas esse conhecimento não forma um todo, e quando surge um problema novo ele não sustenta o meu julgamento.

Deixe sua intenção
continuar moldando seu software.

Queremos que cada implementação ajude você a entender seu software,
formar o próprio julgamento e continuar decidindo para onde ele vai.

Mantenha o porquê
no projeto

Depois de entregue,você continua entendendo.

01 /

Pare de ler uma pilha de diffs para conferir se ficou certo.

Os Agents já são capazes o bastante para que provar que o trabalho está certo não deva continuar caindo sobre você. No Noea Code você declara sua intenção, e o Agent explica como a implementação responde a essa frase: o caminho que seguiu, as escolhas que fez e o que ainda cabe a você julgar. Você lê uma resposta ao que disse, e não alterações espalhadas por dezenas de arquivos.

Saiba mais

Reembolsos

Reembolsos

Uma assinatura pode ser reembolsada integralmente em até 14 dias após o pagamento, sem perguntas.

1

Após 14 dias, uma assinatura anual é reembolsada proporcionalmente aos meses inteiros restantes; uma assinatura mensal não é reembolsada e segue até o fim do período.

2

Explicação geral

Implementação

O valor do reembolso é calculado em um só lugar, refundAmount, acionado por POST /refunds. Primeiro verifica os dias desde o pagamento: até FULL_REFUND_DAYS (14), devolve o valor integral pago.refund.ts:12-20

Reembolso solicitado≤ 14 dias desde o pagamento?SimReembolso integralNãoPlano anual?NãoSem reembolso; segue até o fim do períodoSimmeses restantes = ⌊dias restantes ÷ 30⌋reembolso = taxa anual × meses restantes ÷ 12

Depois de 14 dias, a decisão depende do período de cobrança. No mensal, devolve 0 e a assinatura é mantida até currentPeriodEnd. No anual, divide os dias restantes por 30 e arredonda para baixo para obter os meses inteiros restantes, depois multiplica por um doze avos da taxa anual.refund.ts:22-41

Os valores são inteiros, em centavos, do início ao fim, e só são convertidos na última etapa, então nenhum erro de arredondamento aparece. gateway.refund devolve o dinheiro pelo mesmo caminho; em caso de sucesso, um evento refund.issued é gravado, e a página de cobrança mostra o reembolso a partir dele.gateway.ts:88-104

Evidências

Atenção

Escolha de implementação

Um mês é contado como 30 dias, não como mês do calendário. Uma assinatura anual paga em fevereiro recebe alguns dias a mais do que daria com meses do calendário. Usar meses do calendário é uma decisão sua.

Lacuna

O documento não diz quando os assentos são liberados após um reembolso. Hoje são liberados imediatamente.

Investigado em 11 nov 2026, 15:04

Os reembolsos voltam para a forma de pagamento original. O prazo depende do provedor de pagamento.

1
Exemplo · Registro de hábitos
02 /

Cada ponto-chave de uma frase tem sua própria implementação.

A sensação de controle ao escrever código vem de saber o que cada símbolo significa. Envie um prompt ou uma especificação e você não consegue dizer qual palavra fez diferença, nem onde. O Noea Code faz o Agent explicar ponto por ponto o que “entra em vigor imediatamente” significa e como os “dias restantes” são calculados. Mude uma dessas palavras e você consegue prever o que muda.

Saiba mais

Planos e assentos

Planos e assentos

O dono da equipe pode trocar de plano, para um superior ou um inferior, a qualquer momento.

1

A mudança de plano entra em vigor imediatamente; a diferença de preço é calculada pro rata pelos dias restantes e é somada à próxima fatura.

3

Explicação 2 / 4entra em vigor imediatamente

← Explicação geral

Implementação

changePlan atualiza plan e seats em uma única transação, sem esperar o fim do período. As verificações de permissão leem o plan atual da assinatura a cada vez, então a próxima requisição após um upgrade já tem os novos recursos.plan.ts:30-52

Atenção

Escolha de implementação

Um rebaixamento também entra em vigor imediatamente: os assentos acima do limite do novo plano passam a ser somente leitura na hora, em vez de valer até o fim do período.

Explicação 3 / 4dias restantes

← Explicação geral

Implementação

prorate divide os milissegundos restantes do período pelo total de milissegundos do período para obter uma razão entre 0 e 1, depois multiplica pela diferença de preço entre os dois planos. Um upgrade gera um valor a pagar; um rebaixamento gera um crédito.proration.ts:8-27

Atenção

Escolha de implementação

O pro rata é por milissegundo, não por dias inteiros: mudar de plano à tarde custa meio dia a menos do que mudar pela manhã. Arredondar para dias é uma decisão sua.

O número de assentos não pode ser menor que o número atual de membros da equipe.

1
Exemplo · Registro de hábitos
03 /

O que o Agent decidiu por você, ele mesmo lista.

A preocupação com um trabalho escrito por um Agent é saber se ele tomou decisões por você em silêncio e deixou armadilhas. Encontrá-las costumava exigir revisar o código linha por linha. Aqui, o próprio Agent precisa listá-las: as escolhas de implementação que fez, e as lacunas, riscos e sugestões que vê. Assim, você não precisa ter todos os detalhes resolvidos de antemão. Comece com uma ideia geral, veja o que ele lista e então decida quais decisões retomar.

Saiba mais

Exportação de faturas

Exportação de faturas

O dono da equipe pode exportar as faturas de um intervalo de datas como um arquivo CSV.

4

Explicação geral

Implementação

Evidências

Atenção

Lacuna

O documento não diz por quanto tempo um intervalo pode abranger em uma exportação. Hoje o limite é de 12 meses; um intervalo maior retorna um erro.

Escolha de implementação

O intervalo de datas é lido no fuso horário da equipe, não em UTC.

Risco

A coluna de valor não traz moeda, então uma equipe que usa várias moedas não consegue distingui-las na exportação.

Sugestão

Quando uma exportação levar mais de 10 segundos, gere-a em segundo plano e envie um e-mail quando estiver pronta.

Investigado em 11 nov 2026, 15:04

Cada linha do arquivo é uma fatura: número, data, valor e status.

1
Exemplo · Registro de hábitos
04 /

Ele diz que terminou. Também precisa mostrar por quê.

Um Agent dizer “implementado” não basta. Cada explicação vem com suas evidências: o código que leu, os testes que rodou, os registros de execução e capturas de tela, a um clique de distância. Quando alguém perguntar, você pode apontar o lugar exato.

Saiba mais

Renovação

Depois que a cobrança de renovação falha, a assinatura mantém um período de carência de 7 dias, e a cobrança é tentada de novo a cada 2 dias.

2

Explicação geral

Implementação

openGrace inicia o período de carência e registra o prazo em graceEndsAt; outra falha dentro do período não o estende.grace.ts:6-15

Evidências

Li o código do período de carência e o job diário de renovação, e rodei os testes do período de carência: os 6 passam. Uma captura de tela guardada do turno em que isso foi implementado mostra um aviso no topo da página de configurações da equipe durante o período de carência.

✓ a primeira falha abre um período de carência de 7 dias ✓ outra falha dentro da carência não o estende ✓ rebaixa para Free após o dia 7 6 aprovados · 0 falhas · 412 ms

grace.ts

4export const GRACE_DAYS = 7;56export function openGrace(subscription, failedAt) {7  if (subscription.graceEndsAt !== undefined) {8    return { ...subscription, lastChargeAttemptAt: failedAt };9  }10  return {11    ...subscription,12    graceEndsAt: addDays(failedAt, GRACE_DAYS),13    lastChargeAttemptAt: failedAt,14  };15}1617export function inGrace(subscription, now) {18  return subscription.graceEndsAt !== undefined19    && now < subscription.graceEndsAt;20}
Exemplo · Registro de hábitos
05 /

Um colega mudou o código. O que isso significa para a sua intenção?

Sua intenção é o seu ponto de vista. Depois que você traz as mudanças da equipe, o que recebe não é uma longa lista de commits, mas quais das suas intenções são afetadas, marcadas na barra lateral, no documento e na explicação. Investigue de novo e você saberá o que essas mudanças significam para aquilo com que você se importa.

Saiba mais

Renovação

Renovação

As assinaturas são renovadas automaticamente a cada período. A cobrança é feita na data de vencimento; se der certo, a assinatura avança um período.

Depois que a cobrança de renovação falha, a assinatura mantém um período de carência de 7 dias, e a cobrança é tentada de novo a cada 2 dias.

Renovação

Renovação

As assinaturas são renovadas automaticamente a cada período. A cobrança é feita na data de vencimento; se der certo, a assinatura avança um período.

1

Depois que a cobrança de renovação falha, a assinatura mantém um período de carência de 7 dias, e a cobrança é tentada de novo a cada 2 dias.

2

Explicação geral

Esta explicação pode estar desatualizada

1 arquivo que ela leu ou cita foi alterado depois que ela foi escrita:

src/billing/grace.ts

Investigar Novamente

Implementação

openGrace inicia o período de carência e registra o prazo em graceEndsAt; o job diário tenta de novo as assinaturas cuja última tentativa foi há pelo menos 2 dias.grace.ts:6-15

Se o período de carência terminar sem pagamento, a equipe passa para o Free e os dados são mantidos por 90 dias.

1
1 / 22 talvez desatualizado ProjetoEste documento Explicar 2

Trouxe 3 commitsmain · Ana, Lucas

Exemplo · Registro de hábitos
06 /

Mudanças em dezenas de arquivos, lidas pela sua intenção.

Abra o cartão de alterações no fim de um turno. As mudanças não aparecem arquivo por arquivo, mas agrupadas pela intenção a que respondem, assim você vê qual frase sua cada mudança atende. Mudanças que não respondem a nenhuma intenção são listadas separadamente no fim, sem se misturar às outras.

Saiba mais

Estender o teste para 21 dias

Estenda o período de teste de 14 para 21 dias, e mova para antes do fim os lembretes que acompanham esse prazo.

Levou 3 min 02 s · 23 ferramentas

Implementado; os 18 testes passam. Equipes que já estão em teste recebem uma nova data de fim calculada a partir da data de cadastro, então ninguém precisa fazer nada manualmente.

12 arquivos alterados+214−374 intenções·2 sem correspondência

Ver alterações

Mensagem para Claude Code…

AutomáticoOpus 5.5 · Default

Estender o teste para 21 dias · Turno 1

12 arquivos+214−37Por arquivoPor intenção

Período de teste › Duração do teste

Uma nova equipe ganha um teste de 21 dias no cadastro, com todos os recursos do plano Team.

Duração do teste alterada para 21 diasL2

A constante TRIAL_DAYS passa de 14 para 21; todas as datas de fim são calculadas a partir dela.

src/billing/trial.ts+6−2

8 linhas inalteradas

Linhas 9–12+1−11 intenções

9-export const TRIAL_DAYS = 14;9+export const TRIAL_DAYS = 21;1011export function trialEndsAt(team) {12  return addDays(team.createdAt, TRIAL_DAYS);

Período de teste › Lembretes

Envie ao dono da equipe um lembrete 3 dias antes do fim do teste e outro no dia em que ele termina.

O horário dos lembretes acompanha a nova data de fimL2

runTrialReminders não fixa mais o dia 11; ele conta 3 dias para trás a partir da data de fim.

src/jobs/trial-reminders.ts+14−9

21 linhas inalteradas

Linhas 22–25+2−21 intenções

22-  const due = addDays(team.createdAt, 11);22+  const due = addDays(trialEndsAt(team), -3);23  if (!sameDay(due, today)) continue;

Sem intenção correspondente2

package-lock.json+41−18

tests/helpers/clock.ts+12−0

Exemplo · Registro de hábitos
Já entreguei uma funcionalidade e depois não consegui mudá-la para um caso novo. Conheço bem essa sensação de insegurança. Agora cada requisito vem seguido da sua implementação e do código. Quando faço uma afirmação, sei em qual linha ela cai. Se alguém questiona, consigo mostrar na hora.
Ryan LiuEngenheiro sênior · renderização gráfica
Em módulos que eu não conhecia bem, costumava pegar o texto do requisito e conferir, ponto a ponto, no código que a IA tinha alterado. Agora o requisito e a explicação da implementação estão no mesmo lugar, não mais espalhados. Quando algo precisa mudar, eu começo por este documento.
Owen SuEngenheiro sênior · sistemas de negócio

As decisões que você tomoucontinuam lá na próxima vez.

07 /

O que você decidiu não fica mais só no registro do chat.

Você conversa com um Agent durante uma tarde e decide uma dúzia de coisas. Uma semana depois, quantas você ainda consegue encontrar? Aqui, o que você decide vai para um documento de intenção, escrito com as palavras que você usou, para que você o reconheça como seu próprio raciocínio. Ele diz apenas o que o software deve ser agora, não guarda um diário do que aconteceu e reúne cada assunto em um só lugar. Nada conta até você ter lido e aceitado.

Saiba mais

Reembolsos

Reembolsos

Uma assinatura pode ser reembolsada integralmente em até 14 dias após o pagamento, sem perguntas.

1

Após 14 dias não há reembolso; a assinatura segue até o fim do período.

Adicionado

Após 14 dias, uma assinatura anual é reembolsada proporcionalmente aos meses inteiros restantes; uma assinatura mensal não é reembolsada e segue até o fim do período.

Os reembolsos voltam para a forma de pagamento original.

1
1 de 1DescartarImplementar DiretamenteAceitar
1 / 11 ProjetoEste documento Implementar 1Explicar 1

Regra de reembolso anual

Quando alguém com plano anual quer sair no meio do caminho, hoje é tudo ou nada. Isso é rígido demais. Depois de 14 dias, devolva os meses inteiros que restam.

Pensando2,1 s

Levou 41 s · 6 ferramentas

Hoje refundAmount retorna 0 para toda assinatura após 14 dias. Escrevi esta regra como intenção, reformulando uma frase em Reembolsos. Revise, por favor. Nenhum código foi alterado ainda.

Reembolsar assinaturas anuais após 14 dias pelos meses inteiros restantes

Reembolsos.noea.md

PendenteAceitaDescartarImplementar DiretamenteAceitar

Mensagem para Claude Code…

AutomáticoOpus 5.5 · Default

Exemplo · Registro de hábitos
08 /

Para mudar o software, mude aquela frase.

Digamos que o teste deva durar 21 dias em vez de 14. Você não precisa encontrar o código antes, nem descobrir como descrevê-lo para um Agent. Encontre a frase no documento e troque 14 por 21. A edição fica marcada; escolha Implementar e o Agent trabalha só nessa mudança, depois informa o que alterou.

Saiba mais

Período de teste

Período de teste

Uma nova equipe ganha um teste de 1421 dias no cadastro, com todos os recursos do plano Team.

Envie ao dono da equipe um lembrete 3 dias antes do fim do teste e outro no dia em que ele termina.

2

Se o teste terminar sem pagamento, a equipe passa para o Free e os dados são mantidos.

1
1 / 1 ProjetoEste documento
1 / 11 ProjetoEste documento Implementar 1Explicar 1

Implementar · Período de teste

Implementar as alterações de intenção: Período de teste (1 reescrita)

Pensando1,6 s

Levou 46 s · 7 ferramentas

TRIAL_DAYS é 14 hoje, e um job de lembretes fixa “dia 11”. Vou alterar os dois e adicionar os testes correspondentes.

Editar src/billing/trial.ts

Editar src/jobs/trial-reminders.ts

Executar testes

Executar testes · 18 aprovados

4 arquivos alterados+38−92 intenções

Ver alterações

Adicione uma ideia ou programe o próximo passo…

AutomáticoOpus 5.5 · Default

Exemplo · Registro de hábitos
09 /

“Os dados continuam lá depois de um rebaixamento de plano?” Pesquise e descubra.

Perguntas assim costumavam exigir escavar o código ou perguntar a quem o escreveu. Agora você pesquisa com palavras simples: ⌘K procura em intenções, explicações e conversas anteriores ao mesmo tempo. O que você encontra é como o software funciona agora, com a implementação logo ao lado.

Saiba mais
Exemplo · Registro de hábitos
10 /

Cada tarefa concluída deixa algo para você.

Termine uma tarefa com um Agent e o que sobra costuma ser uma pilha de código que você não leu. Aqui, cada tarefa também deixa um pedaço de intenção: por que este fluxo de pagamento foi desenhado assim, o que há de inteligente naquele algoritmo. Sintaxe e detalhes de implementação podem ficar com o Agent; esse julgamento é seu. Quando se acumulam ou se repetem, peça ao Agent que proponha como organizá-los. Você revisa cada alteração, e nada entra até você aceitar.

Saiba mais

Organizar · Assinaturas

Levou 1 min 38 s · 12 ferramentas

Organizei os 4 documentos em Assinaturas. A regra para manter os dados após um rebaixamento estava escrita tanto em Renovação quanto em Período de teste. Unifiquei-a em Planos e assentos e deixei, em cada um dos outros dois, uma frase que aponta para ela.

Inalteradas31Mescladas2Movidas1

Reescritas2Removidas0Adicionadas1

Caracteres2 184 → 2 037Exclusões147

Renovação.noea.mdPeríodo de teste.noea.mdPlanos e assentos.noea.md

Observações deixadas durante a organização

  • Reembolsos diz “fim do período” de duas formas diferentes com o mesmo sentido; sugiro padronizar em uma. Não alterei desta vez porque isso está fora do que me pediram para organizar.

Mensagem para Claude Code…

AutomáticoOpus 5.5 · Default

Renovação

Renovação

Depois que a cobrança de renovação falha, a assinatura mantém um período de carência de 7 dias, e a cobrança é tentada de novo a cada 2 dias.

2

Se o período de carência terminar sem pagamento, a equipe passa para o Free e seus dados são mantidos por 90 dias; pagar em até 90 dias restaura o plano e todos os dadosManter. Para saber como os dados são mantidos após um rebaixamento, veja Planos e assentos.

Após uma renovação bem-sucedida, a fatura aparece na página de cobrança em até 1 minuto.

1
1 de 2Comparar com o OriginalRejeitarAceitar
1 / 1Aceito ProjetoEste documento
Exemplo · Registro de hábitos
11 /

Quanto deste software você realmente domina?

Um quadro responde. Um quadrado por arquivo, organizado por módulo; quanto mais escuro o quadrado, mais linhas dele as suas explicações citam. O que ainda está em branco e quais explicações estão desatualizadas aparecem de relance. Aponte para uma intenção e os arquivos que ela cobre se acendem.

Saiba mais

Nova Conversa

Cobertura de intenções15:05 · b8d56a4

68%41 / 60 arquivos

Linhas referenciadasExplicação desatualizadaSem intenção

Módulos

src/billing

src/jobs

src/notify

src/web

Assinaturas

Planos e assentos

Período de teste

Renovação

Reembolsos

Cobrança

Notificações

Exemplo · Registro de hábitos
12 /

Como você chegou às suas decisões continua tudo lá.

Cada mudança em um documento de intenção é mantida. Escolha uma versão para ver quais documentos ela alterou e o que mudou em cada um, e se você fez a edição ou o Agent propôs e você aceitou.

Saiba mais

Renovação

Período de carência

Depois que a cobrança de renovação falha, a assinatura mantém um período de carência de 7 dias, e a cobrança é tentada de novo a cada 2 dias.

Quando uma cobrança de renovação falha e inicia o período de carência, envie um e-mail ao dono da equipe informando que a cobrança falhou e quantos dias de carência restam.

Se o período de carência terminar sem pagamento, a equipe passa para o Free. Para saber como os dados são mantidos após um rebaixamento, veja Planos e assentos.

Se o período de carência terminar sem pagamento, a equipe passa para o Free e os dados são mantidos por 90 dias; pagar em até 90 dias restaura o plano e todos os dados.

Se o período de carência terminar sem pagamento, a equipe passa para o Free. Para saber como os dados são mantidos após um rebaixamento, veja Planos e assentos.

Após uma renovação bem-sucedida, a fatura aparece na página de cobrança em até 1 minuto.

1 de 1
Exemplo · Registro de hábitos

BUILT FOR YOUR FREEDOM

Sua linguagem. Seus arquivos. Seu Agent.

Aa

Sua linguagem

Linguagem natural, DSLs, linguagens de modelagem, código. Misture à vontade.

.md

Seus arquivos

A intenção fica em Markdown comum. Gerencie com Git e mantenha em qualquer editor.

↗

Seu agente

Continue com o agente de código que já usa. O Noea não o substitui.

Com seus agentes de programação habituais

CodexClaude CodeOpenCodeCodeBuddy

FOR THE PEOPLE BEHIND THE SOFTWARE04

Se você responde pelo software,
isto foi escrito para você.

Se você é responsável por uma parte da lógica, por uma equipe ou pelo produto inteiro,
comece pelo que importa para você.

01

Engenheiro sênior

Algo quebrou em produção. Todos na sala de reunião olham para você: “Por que essa lógica funciona assim?”

↳ No Noea

Abra a intenção por trás dessa lógica. A implementação, as evidências e o que ainda não foi decidido estão no mesmo lugar. O que você diz em voz alta é o que você já conferiu.

02

Tech lead / CTO

Duas da manhã, a produção está fora do ar. A única pessoa que entendia aquele código saiu no mês passado. Sobrou um chat de quatrocentos turnos.

↳ No Noea

Regras e decisões ficam nos documentos de intenção do projeto, junto das explicações e do código em que se apoiam. Quem assumir começa lendo aqui, e não naqueles quatrocentos turnos.

03

Fundador / empresa de uma pessoa

Um usuário pagante escreve: “Por que falta uma coluna na minha exportação?” Você encara a tela sem saber se é um bug, uma decisão sua ou uma escolha que o Agent fez por você.

↳ No Noea

A partir da pergunta, volte à intenção e à sua implementação, e veja quais partes você decidiu e quais o Agent escolheu. Manter essa coluna é decisão sua.

Noea Code

YOUR NEXT CHAPTER

Comece com sua intenção.

Noea Code. Programação com IA guiada pela sua intenção.

Baixar Noea CodemacOS · Windows · Linux / Beta público