session-audit-trail

Record append-only audit trails for SDD workflow runs.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/JNZader/javi-ai --skill session-audit-trail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-audit-trail
Source: https://github.com/JNZader/javi-ai/tree/main/own/skills/session-audit-trail
Command: npx skills add https://github.com/JNZader/javi-ai --skill session-audit-trail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audit trails for SDD workflow executions are often missing, making debugging, compliance, and replay difficult. This skill defines a deterministic protocol and storage model to capture run history, event streams, and provenance in an append-only log.

Core Features & Use Cases

  • Provides an auditable run lifecycle with run_id, start/end timestamps, and status.
  • Captures per-task events, file changes, and test outcomes for replay and analysis.
  • Integrates with engram-backed storage to enable fast replay and historical queries.

Quick Start

Initialize an AuditTrail instance at the start of /sdd-apply and emit events as tasks run to persist an auditable history.

Frequently Asked Questions about session-audit-trail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record audit trails for SDD workflow runs?

To record audit trails for SDD workflow runs, initialize an AuditTrail instance at the start of /sdd-apply and emit events as tasks run. This captures run start, per-task events, file changes, tests, and outcomes in an append-only log.

What is an append-only event log used for in software observability?

An append-only event log is used for debugging, compliance, and replay by capturing run history, event streams, and provenance. It provides a deterministic protocol and storage model that ensures recorded execution data remains untampered for historical queries.

Does the audit trail logging capture file changes and test outcomes?

Yes, the audit trail logging captures file changes and test outcomes. It records per-task events throughout the run lifecycle, including start and end timestamps, run IDs, and final status, enabling detailed debugging and analysis.

How do I replay a recorded workflow execution for debugging?

You replay a recorded workflow execution using the built-in replay formatter and optional replay APIs. This engram-backed system enables fast historical queries and reconstructs the exact sequence of run events for debugging.

Can I use this run-tracking system for compliance requirements?

Yes, you can use this run-tracking system for compliance requirements. It defines a deterministic protocol to capture provenance and run history in an append-only log, ensuring that workflow executions are fully auditable and verifiable.