session-audit

Audit CC session transcripts for unpersisted substance with exact citations.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/fppfurtado/pragmatic-dev-toolkit --skill session-audit-fppfurtado
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-audit
Source: https://github.com/fppfurtado/pragmatic-dev-toolkit/tree/main/skills/session-audit
Command: npx skills add https://github.com/fppfurtado/pragmatic-dev-toolkit --skill session-audit-fppfurtado

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits the current CC session transcript for substance generated but not persisted to canonical artifacts (BACKLOG, NOTES.md, ADRs, CLAUDE.md/philosophy.md) and reports gaps grouped by type with batched, single-call prompts to capture what needs materialization before session end.

Core Features & Use Cases

  • Detects decisions, classifications, drift, and findings that have not been materialized into canonical artifacts.
  • Groups findings by type and provides batched recommendations for artifact creation (BACKLOG, NOTES, ADRs, doctrine updates).
  • Supports non-destructive review and audit before closing a session to preserve traceability and context.

Quick Start

Audit the current CC session to surface unpersisted substance and prepare batched gaps before ending the session.

Frequently Asked Questions about session-audit

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

FAQPage Schema
How do I audit a session transcript for unpersisted decisions and backlog gaps?

Session audit detects unpersisted decisions and backlog gaps by scanning the current CC session transcript for substance not yet saved to canonical artifacts like BACKLOG, NOTES.md, and ADRs, reporting findings grouped by type with exact transcript citations to preserve traceability.

What is the best way to capture unpersisted doctrine updates and ADRs before a session ends?

Capturing unpersisted ADRs and doctrine updates before session end involves running a non-destructive audit that produces batched, single-call remediation suggestions targeting CLAUDE.md, philosophy.md, and other canonical artifacts to materialize context.

How does the Resolution Protocol anchor session audit findings to artifact targets?

The Resolution Protocol anchors session audit findings by mapping unpersisted substance to exact transcript citations and resolved artifact targets, ensuring every detected gap in BACKLOG or NOTES.md has a precise, traceable remediation path before batched suggestions are generated.

Can I review session drift and findings non-destructively without altering existing canonical artifacts?

Yes, you can review session drift and findings non-destructively. The audit surfaces unpersisted substance and provides batched recommendations for artifact creation without modifying existing canonical artifacts, ensuring safe review before session end.

What types of unpersisted substance can a session audit detect in a CC transcript?

A session audit detects several types of unpersisted substance in a CC transcript, including decisions, classifications, drift, and findings that have not yet been materialized into canonical artifacts like BACKLOG, NOTES.md, ADRs, and CLAUDE.md.