Dados e privacidade
O Agent Note foi feito para times que querem AI review history sem hosted backend. Os dados permanentes são git-native, e os dados temporários ficam no clone local.
| Tema | Comportamento |
|---|---|
| Hosted service | Nenhum servidor Agent Note é necessário |
| Histórico permanente | Git notes em refs/notes/agentnote |
| Dados temporários | .git/agentnote/, não commitados |
| Telemetry | Não envia prompt, response ou path para serviço Agent Note |
O que é salvo
Seção intitulada “O que é salvo”| Campo | Finalidade |
|---|---|
prompt / response | Conversa por trás do commit |
contexts[] | Hints display-only para prompts curtos |
files | Committed files e se a IA tocou neles |
attribution | AI Ratio, método e contagem de linhas (quando disponível) |
agent / model | Metadata de agent e model |
Paths que correspondem à .agentnoteignore na raiz do repository continuam em files; eles são removidos apenas do denominador do AI Ratio.
O schema completo está em Como funciona.
Antes de ativar o Dashboard
Seção intitulada “Antes de ativar o Dashboard”| Pergunta | Recomendação |
|---|---|
| Quem vê Pages também pode ler os prompts? | Ative o Dashboard apenas se a visibilidade de Pages combinar com a política do repositório. |
| Os prompts podem conter secrets ou dados de clientes? | Trate git notes como dados de review e evite secrets nos prompts. |
| Você só precisa de contexto para review na PR? | Use apenas PR Report e ignore --dashboard. |
Onde fica
Seção intitulada “Onde fica”| Camada | Local | Compartilhado? |
|---|---|---|
| Dados temporários de sessão | .git/agentnote/sessions/ | Não |
| Notes permanentes | refs/notes/agentnote | Sim, no git push |
| PR Report | Descrição da PR ou comentário | Sim, no GitHub |
| Dashboard | Artefato do Pages e gh-pages/dashboard/notes/*.json | Sim, se ativado |
O que não é salvo
Seção intitulada “O que não é salvo”- O workspace inteiro.
- Outputs de shell command não são salvos como file evidence.
- Dados enviados para um backend do Agent Note.
Visibilidade do time
Seção intitulada “Visibilidade do time”Quem consegue fetch refs/notes/agentnote pode ler prompts e responses salvos. Trate git notes como dados do repository.
Dashboard é opcional. Se não quiser uma shared web view, use apenas PR Report e ignore --dashboard.