O que você não decidiu, o agente decide.
Modelos, armazenamento, camadas: o que você não especificou fica com ele.
A camada de controle contínuo entre intenção e implementação
A IA constrói. Você continua sendo o autor.
Agentes reescrevem seu software todos os dias. O Noema mantém em vigor a intenção que você escreveu: você a vê e pode mudá-la.
- Beta público
- macOS 13+ · Apple silicon
- Intenção salva em Markdown puro
- Comece por uma parte só
Escreva em Markdown, com suas palavras. O que você não especificar, o agente decide.O agente implementa dentro do que a sua intenção permite.Para cada trecho, veja a implementação, as evidências e o que merece atenção.Mude uma frase ou converse com o agente: ele propõe uma edição, e você revisa e decide.
Ilustração: um app de acompanhamento de hábitos como exemplo.
Problema 01
A IA assumiu a implementação,
mas não a responsabilidade.
Você ainda precisa explicar o sistema em reuniões, rastrear problemas em incidentes e decidir conforme a arquitetura evolui, sem ter escrito o código linha a linha.
Você não precisa ler cada linha. Só confira se ela fez o que você pediu.
AntesLendo as mudanças do agente
habit-app
47
streak.tsMreward.tsMcheckin.tsMnotify.tsM
src › features › checkin › streak.ts
@@ -18,14 +18,22 @@ export function computeStreak(
18−
export function streak(days: Date[], tz: string) {19−
let n = 0;20−
for (const d of sortedDesc(days)) {21−
if (!isNextDay(d, n, tz)) break;22−
n++;23−
}24−
return n;25−
}18+
export function computeStreak(entries: CheckIn[], now: Date, tz: string): number {19+
const days = new Set(entries.map((e) => toLocalDay(e.at, tz)));20+
let cursor = toLocalDay(now, tz);21+
let count = 0;22+
while (days.has(cursor)) {23+
count += 1;24+
cursor = prevDay(cursor);25+
}26+
return count;27+
}2628
2729
const REWARD_AT = 7;28−
if (streak(days, tz) >= 7) grantReward(user);30+
export async function maybeReward(user: User, streak: number) {31+
if (streak < REWARD_AT || user.rewards.has("streak-7")) return;32+
await rewards.grant(user.id, "streak-7");33+
await notify(user.id, { kind: "reward", id: "streak-7" });34+
}2935
36+
export const STREAK_WINDOW_DAYS = 400;feat/streak-rewrite47 arquivos alterados · +1,284 −903
AgoraAbra a nota de uma intenção
Após uma sequência de 7 dias, dê uma recompensa ao usuário.
1Realization
computeStreak converte cada registro de check-in em um dia do calendário no fuso horário do usuário, remove duplicatas e conta de trás para frente a partir de hoje, parando no primeiro dia sem registro. Perdeu um dia, a sequência volta a zero.
Quando a sequência chega a REWARD_AT (7), maybeReward concede uma recompensa streak-7 e avisa o usuário. Quem já a resgatou não a recebe duas vezes.
Escolha-chave Contagem por dia do calendário, não por 24 horas; o fuso horário vem das configurações do dispositivo.
Evidence
streak.test.tscobre 7 dias seguidos, um dia perdido e check-ins repetidos no mesmo dia; os 3 casos passam- Fluxo de check-in executado de ponta a ponta: a recompensa do dia 7 é concedida uma única vez
Attention
Viajar entre fusos horários ou fazer check-in depois da meia-noite pode ser lido como sequência quebrada; hoje ela segue o fuso do dispositivo. Escrever isso na intenção?
Regras 02
Três regras
sobre quem tem a palavra final.
O Noema não substitui o julgamento do agente. Ele só guarda estes três limites.
O que você decidiu, o agente cumpre.
O que você escreveu nunca é ignorado nem reescrito em silêncio.
Escolhas importantes precisam estar visíveis.
Tudo o que afeta experiência, risco ou custo fica à vista.
Autonomia 03
O Noema não pede que você entregue o controle
a outra caixa-preta.
Ele não é dono de como você se expressa nem de como define seu produto, e não pede que você troque o agente de código a que está acostumado.
01 · Linguagem
prose + C4 + DSL + codeSua linguagem
Linguagem natural, DSLs, linguagens de modelagem, código. Misture à vontade.
02 · Arquivos
*.noema.mdSeus arquivos
Markdown puro, gerenciado no Git. São seus mesmo sem o Noema.
03 · Agent
ACP / agent adaptersSeu agente
Continue com o agente de código que já usa. O Noema não o substitui.
Para quem é 04
Se você responde pelo software,
isto foi escrito para você.
Engenheiro sênior
Algo quebrou em produção. Todos na sala de reunião olham para você: “Por que essa lógica funciona assim? Explica aí.”
Você é mesmo dono deste sistema ou só o “meat proxy” do agente?
O agente escreveu o código, mas quem responde por ele é você. Você explica em nome dele e não sabe dizer por que é do jeito que é.
Como o Noema ajudaSiga uma intenção até a implementação atual, confira as evidências e veja o que ainda é incerto. O que você explica é o que você de fato entende.
Tech lead / CTO
2h da manhã, produção fora do ar. A única pessoa que sabia ler aquele código saiu no mês passado. Deixou só um histórico de chat com quatrocentas trocas.
Você realmente controla este produto ou só o vê sair do controle dia após dia?
Ninguém revisa milhares de linhas alteradas por dia, então tudo passa, e bugs escondidos ficam. Quando alguém sai do time, esse código vira uma bomba que ninguém sabe desarmar.
Como o Noema ajudaO Noema deixa um documento que qualquer pessoa lê direto, com o motivo escrito ao lado de cada frase. Ele não depende da memória de ninguém nem se esconde numa sessão. Quando as pessoas saem, o time e o produto continuam documentados.
Fundador / empresa solo
Um usuário pagante escreve: “Por que falta uma coluna na minha exportação?” Você encara a tela sem saber se é bug, decisão sua ou uma escolha que o agente fez por você.
Você está mesmo construindo uma empresa ou só consumindo um produto que um agente de código fez para você?
Você só descobre o que seu produto faz pelos seus usuários. A IA fez centenas, até milhares de escolhas em silêncio e foi reescrevendo um produto que você achava ter criado.
Como o Noema ajudaLeve a dúvida de um usuário direto à intenção e à implementação por trás dela, separe suas decisões de produto das escolhas do agente e retome as que realmente importam.
FAQ 05
Perguntas que você pode ter.
O Noema é uma nova linguagem de programação?
Não. Linguagens de programação descrevem implementação; o Noema trata de como a implementação responde à sua intenção.
Preciso escrever todos os meus requisitos?
Não. Escreva só o que importa para você e deixe o resto com o agente. Ele mostra as escolhas relevantes.
Funciona com projetos existentes?
Sim. Você não precisa levar o código todo para o Noema antes. Escreva intenções só para o que mais importa; o agente continua implementando o resto como antes.
O agente vai alterar a intenção que escrevi?
Não. Só você altera uma intenção. O agente é somente leitura por padrão, e as sugestões dele só valem depois que você confirma.
Em que formato ficam os arquivos de intenção?
Arquivos Markdown puros terminados em .noema.md. Qualquer editor abre, e eles vão para o Git.
Ele substitui o agente de código que uso hoje?
Não. O agente continua escrevendo o código; o Noema é uma camada de controle por cima.
O que acontece na primeira vez que abro?
Se nenhum agente de código estiver disponível, o app guia você para escolher, instalar, entrar e verificar um. A primeira verificação baixa um runtime, e o app informa o tamanho.
O Noema coleta meus dados?
Relatórios de erro e estatísticas de uso são duas opções independentes, na página Privacidade dos Ajustes. Só são coletados eventos de ação de categorias fixas, nunca seu texto, seus arquivos ou caminhos.
Download 06
Mantenha a velocidade.
Mantenha o rumo.
Baixe o Beta agora e percorra o ciclo você mesmo.
- macOS 13+
- Apple silicon (Intel ainda não é compatível)
- Beta público; os recursos ainda estão evoluindo
