From da24b029b37cb4383965a2194c442ae28d11a76b Mon Sep 17 00:00:00 2001
From: William Valentin <william.valentin.info@gmail.com>
Date: Mon, 25 May 2026 18:16:36 -0700
Subject: [PATCH] docs(atlas): add agent audit event template

---
 .../Templates/Atlas Artifacts/README.md       |  2 +
 .../Atlas Artifacts/agent-audit-event.md      | 49 +++++++++++++++++++
 2 files changed, 51 insertions(+)
 create mode 100644 swarm-common/obsidian-vault/will/will-shared-zap/Templates/Atlas Artifacts/agent-audit-event.md

diff --git a/swarm-common/obsidian-vault/will/will-shared-zap/Templates/Atlas Artifacts/README.md b/swarm-common/obsidian-vault/will/will-shared-zap/Templates/Atlas Artifacts/README.md
index 464d95e..056f631 100644
--- a/swarm-common/obsidian-vault/will/will-shared-zap/Templates/Atlas Artifacts/README.md	
+++ b/swarm-common/obsidian-vault/will/will-shared-zap/Templates/Atlas Artifacts/README.md	
@@ -23,6 +23,7 @@ Canonical templates for durable Atlas outputs. Use these when chat, Kanban, or s
 - [[test-report]] — test, benchmark, evaluation, and smoke-check reports.
 - [[status-report]] — weekly/monthly/milestone status updates.
 - [[postmortem]] — incident/failure writeups.
+- [[agent-audit-event]] — short audit notes for agent actions: model, provider, tools/MCP, data touched, outcome, cost, and latency.
 - [[reviewer-checklist]] — common review checklist for all artifacts.
 
 ## Destination policy
@@ -46,6 +47,7 @@ Use lowercase kebab-case filenames with a date prefix where chronology matters.
 - Test reports: `YYYY-MM-DD-<scope>-test-report.md`
 - Status reports: `YYYY-MM-DD-status-report.md`
 - Postmortems: `YYYY-MM-DD-<incident-name>-postmortem.md`
+- Agent audit events: `YYYY-MM-DD-<agent-or-system>-<event-topic>-audit.md`
 
 ## Promotion workflow
 
diff --git a/swarm-common/obsidian-vault/will/will-shared-zap/Templates/Atlas Artifacts/agent-audit-event.md b/swarm-common/obsidian-vault/will/will-shared-zap/Templates/Atlas Artifacts/agent-audit-event.md
new file mode 100644
index 0000000..c62fc49
--- /dev/null
+++ b/swarm-common/obsidian-vault/will/will-shared-zap/Templates/Atlas Artifacts/agent-audit-event.md	
@@ -0,0 +1,49 @@
+---
+type: agent-audit-event
+project: "{{project}}"
+status: draft
+owner: "Atlas"
+created: {{date}}
+updated: {{date}}
+source: "{{source-session-or-kanban-task}}"
+tags: [atlas, audit, agent-event]
+---
+
+# Agent Audit Event — {{event-title}}
+
+Use this short note when an Atlas/Hermes agent action should be auditable but does not need a full status report or postmortem.
+
+## Summary
+
+- **When:** {{timestamp-or-date}}
+- **Actor:** {{atlas/profile/agent-name}}
+- **Trigger:** {{user-request | cron-job | webhook | kanban-task | manual-ops}}
+- **Outcome:** {{success | partial | failed | cancelled}}
+- **One-line result:** {{what changed or what was learned}}
+
+## Runtime
+
+- **Model:** {{model-name}}
+- **Provider:** {{provider-name}}
+- **Profile/session:** {{profile-name-or-session-id}}
+- **Tools used:** {{terminal, file, web, browser, etc.}}
+- **MCP servers / external services:** {{server-or-service names, or none}}
+
+## Data touched
+
+- **Local paths:** {{paths read/written, or none}}
+- **Remote systems:** {{GitHub, Gitea, Google, n8n, Obsidian API, etc., or none}}
+- **Secrets/PII exposure:** {{none | brief description + mitigation}}
+- **Writes/side effects:** {{files changed, messages sent, jobs scheduled, services restarted, or none}}
+
+## Cost and latency
+
+- **Approx. cost:** {{amount, token cost, or unknown/not reported}}
+- **Latency / runtime:** {{duration, or unknown/not reported}}
+- **Notable performance notes:** {{slow tool, retry, timeout, cache hit/miss, or none}}
+
+## Evidence
+
+- **Verification:** {{test/check/log/URL/commit/path proving outcome}}
+- **Artifacts:** {{links to reports, diffs, generated files, or none}}
+- **Follow-up:** {{next action, owner, or none}}