Uma Sticky Note é pequena, mas mantém o trabalho à vista

Uma Sticky Note começa como um post-it para humanos. Conectada a um CodingAgent, torna-se uma memória de trabalho compartilhada: você e o agente podem registrar o que importa durante o turno sem depender de uma conversa que vai ficar para trás.

Ver imagem em tamanho original

Veja o agente trabalhando com a Specification e as notas → (abre em uma nova aba)

Uma nota compartilhada mantém observações, decisões abertas e próximos passos visíveis junto do grafo.

O que a Sticky Note faz

Uma Sticky Note é útil mesmo sem um agente. Escreva uma pergunta, uma hipótese, um lembrete ou uma lista curta de coisas que você quer observar. O valor cresce quando o conteúdo passa a ser parte do mesmo grafo de trabalho.

Com uma Connection a um CodingAgent, o agente pode ler e atualizar a nota junto com você. Use-a para manter:

• um resumo de feito / fazendo / próximo;
• uma decisão ainda aberta durante a formação de uma Specification;
• um ponto de atenção que você quer revisar depois;
• descobertas encontradas durante a implementação;
• findings de uma revisão independente;
• um checklist de handoff entre participantes do grafo.

A nota é deliberadamente informal. Ela ajuda o trabalho a ficar transparente nos dois sentidos: você entende o que o agente observou, e o agente recebe uma superfície explícita para preservar o que merece continuar visível.

Três formas de usar

1. Memória do seu turno

Antes de começar, escreva o objetivo e as dúvidas que não podem desaparecer. Durante o trabalho, acrescente fatos curtos, links ou decisões provisórias. No fim, deixe os próximos passos claros para quando você retornar ao Workspace.

Um formato simples funciona bem:

## Status
- Feito: reproduzi o problema no fluxo de login.
- Fazendo: comparando as duas respostas da API.
- Próximo: decidir se o retry pertence ao cliente ou ao servidor.

## Atenção
- A falha aparece somente depois de uma sessão expirar.

2. Segunda mão do CodingAgent

Conecte a Sticky Note ao agente e peça que ele registre somente fatos úteis para sua próxima decisão:

Mantenha a Sticky Note como um resumo curto do turno. Registre mudanças feitas, evidências, riscos e perguntas que precisam da minha decisão. Não transforme hipóteses em decisões finais.

Se a nota já contém suas observações, deixe explícito o que o agente pode atualizar. Ele não deve tomar uma nota preenchida como um convite para reorganizá-la por conta própria. Uma instrução mais delimitada é:

Mantenha esta Sticky Note durante a investigação. Preserve minhas anotações e as do Reviewer. Acrescente apenas suas descobertas verificadas e atualize somente os itens identificados com seu nome. Peça minha autorização antes de reorganizar o corpo inteiro.

O agente pode acrescentar blocos separados ou substituir o conteúdo quando você pedir uma reorganização completa. O conteúdo continua editável pelo humano e cada alteração precisa respeitar a versão mais recente da nota.

3. Ponte entre implementação e revisão

Um Builder pode registrar o que mudou e quais verificações executou. Um Reviewer pode acrescentar findings e riscos. Você acompanha ambos sem procurar a informação em duas sessões diferentes.

Specification — Builder — Reviewer
                         │
                    Sticky Note

O desenho acima representa Nodes no mesmo grafo. A Connection entre CodingAgents não é uma sequência automática de workflow; ela torna os participantes alcançáveis e permite a troca de mensagens.

Exemplo: uma nota que ajuda você a retomar o trabalho

Ao investigar uma falha de login, você não precisa transformar toda observação em uma decisão de arquitetura. Use uma nota para preservar a descoberta, a evidência e a pergunta ainda aberta:

## Feito
- Reproduzida a falha após a sessão expirar.
- O login com uma sessão nova continua funcionando.

## Fazendo
- Comparando a resposta de sessão expirada com o tratamento do cliente.

## Atenção do humano
- Decidir se o cliente deve renovar a sessão ou pedir novo login.
- Hipótese: o retry repete o request com a credencial antiga. Ainda não confirmado.

## Evidência
- Terminal Checks: comando de reprodução e resposta observada.
- File do cliente: ponto em que o retry é iniciado.

## Próximo
- Confirmar a hipótese antes de editar o cliente.

Peça ao agente:

Acrescente descobertas verificadas e perguntas à nota. Preserve minhas observações. Quando uma hipótese for confirmada ou descartada, atualize seu estado com a evidência. Se a decisão definir o escopo de uma correção, leve-a para a Specification correspondente e deixe aqui uma referência curta.

Para uma revisão, um bloco separado pode registrar cenário, comportamento observado, evidência e próximo passo. Isso permite distinguir o que o Builder concluiu do que o Reviewer verificou.

Use uma atualização pontual ou um novo bloco quando só houver uma descoberta. Peça uma reorganização do corpo quando a nota acumular status antigos; mantenha decisões ainda abertas e suas observações. O resultado deve permitir retomar o turno sem reler todas as conversas.

Compartilhar a nota não significa tomar posse dela

Um caminho de Connections torna a nota alcançável para leitura e para escritas autorizadas. Isso não equivale a pedir que todo agente do grafo passe a reportar ali automaticamente.

Sem um pedido seu, o relato automático se limita a uma Sticky Note diretamente conectada ao próprio CodingAgent que estava vazia quando ele a encontrou. Nesse caso, ele usa uma lista curta e identifica cada item com seu nome:

- [x] Builder — done: reproduced the expired-session failure.
- [ ] Builder — doing: checking the client's retry handling.
- [ ] Builder — will: verify the fix against the Specification.

O agente atualiza apenas os próprios itens, em momentos que mudam o estado do trabalho. Ele não deve concluir, reescrever ou remover entradas suas ou de outro agente. Uma nota preenchida precisa de um pedido explícito para ser mantida; ser alcançável por outra rota ou estar conectada a um colega não autoriza relato proativo.

Se você limpar uma nota em que o agente já estava escrevendo, ele deve respeitar essa limpeza e deixá-la vazia até você pedir que retome o relato. Isso permite usar a nota como memória compartilhada sem perder o controle sobre o que permanece no Canvas.

Essas são orientações de colaboração dadas ao CodingAgent, não um bloqueio técnico de toda edição possível. Quando precisar impedir escritas pelas operações do Kavor, use sticky_note_read_only na Connection direta.

Markdown, edição e conflitos

A Sticky Note aceita Markdown para títulos, listas, tarefas, ênfase, código e outros elementos comuns de uma nota de trabalho. HTML bruto não é aceito. A nota comporta até 64.000 pontos de código Unicode e oferece quatro cores para separar visualmente contextos, mas a cor não muda a autoridade do conteúdo.

O Kavor salva alterações automaticamente e sinaliza quando outro participante modificou a nota antes da sua gravação. Em vez de apagar a alteração concorrente silenciosamente, a interface permite resolver o conflito. Uma escrita pode ser um append, para acrescentar um novo bloco, ou um replace, para substituir o corpo inteiro.

O que ela não deve ser

Não use uma Sticky Note como substituta para tudo:

• uma decisão estável, com escopo e critérios de aceite, pertence a uma Specification;
• o código-fonte e outros artefatos canônicos pertencem a um File;
• comandos e evidências de execução pertencem ao Terminal;
• uma mensagem coordena participantes, mas não deve ser o único registro de uma decisão importante.

A melhor nota é curta o bastante para ser lida e rica o bastante para evitar que o próximo passo dependa da memória de uma sessão.

Guardrail e alcance

Uma Sticky Note só fica ao alcance de um CodingAgent por um caminho válido de Connections. A proximidade visual no Canvas ou uma menção em mensagem não concede acesso.

Você pode colocar o Guardrail sticky_note_read_only na Connection direta entre o agente e a nota. Nesse caso, o agente continua podendo consultá-la, mas não pode fazer append ou replace por meio das operações do Kavor. O Guardrail restringe aquele par direto; ele não cria uma Connection nem transforma a nota em uma política global do Workspace.

Continue

• Entenda o modelo dos Nodes.
• Escolha o menor conjunto de Connections para o trabalho.
• Feche seu primeiro loop com Specification, CodingAgents, Terminal e Sticky Note.