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.