Datos y privacidad
Agent Note está pensado para equipos que quieren historial de review de IA sin backend hospedado. Los datos permanentes son git-native y los temporales permanecen en el clone local.
Resumen
Sección titulada «Resumen»| Tema | Comportamiento |
|---|---|
| Hosted service | No requiere servidor de Agent Note |
| Historial permanente | Git notes en refs/notes/agentnote |
| Datos temporales | .git/agentnote/, no se commitean |
| Telemetry | No envía prompts, responses ni paths a un servicio Agent Note |
Qué se guarda
Sección titulada «Qué se guarda»| Campo | Propósito |
|---|---|
prompt / response | Conversación detrás del commit |
contexts[] | Pistas display-only para prompts cortos |
files | Archivos commitados y si la IA los tocó |
attribution | AI Ratio, método y conteos de líneas (cuando estén disponibles) |
agent / model | Metadata de agent y modelo |
Los paths que coinciden con la .agentnoteignore en la raíz del repository siguen en files; solo se excluyen del denominador del AI Ratio.
El schema completo está en Cómo funciona.
Antes de activar Dashboard
Sección titulada «Antes de activar Dashboard»| Pregunta | Recomendación |
|---|---|
| ¿Quienes ven Pages también pueden leer los prompts? | Activa Dashboard solo si la visibilidad de Pages coincide con la política del repositorio. |
| ¿Los prompts pueden contener secretos o datos de clientes? | Trata las git notes como datos de revisión y evita secretos en los prompts. |
| ¿Solo necesitas contexto para revisar la PR? | Usa solo PR Report y omite --dashboard. |
Dónde vive
Sección titulada «Dónde vive»| Capa | Ubicación | Compartido |
|---|---|---|
| Datos temporales de sesión | .git/agentnote/sessions/ | No |
| Notes permanentes | refs/notes/agentnote | Sí, con git push |
| PR Report | Descripción o comentario de PR | Sí, en GitHub |
| Dashboard | Artefacto de Pages y gh-pages/dashboard/notes/*.json | Sí, si está activado |
Qué no se guarda
Sección titulada «Qué no se guarda»- Todo el workspace.
- No se guarda output de shell commands como file evidence.
- Datos enviados a un backend de Agent Note.
Visibilidad del equipo
Sección titulada «Visibilidad del equipo»Quien pueda fetch refs/notes/agentnote puede leer prompts y responses guardados. Trata las git notes como datos del repository.
Dashboard es opcional. Si no quieres una vista web compartida, usa solo PR Report y omite --dashboard.