Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From code-coherence
Tracks and queries decision history from code coherence checks: view session audits, trace decisions backward/forward, search critic rejections and patterns.
npx claudepluginhub reggiechan74/cc-plugins --plugin code-coherenceHow this skill is triggered — by the user, by Claude, or both
Slash command
/code-coherence:audit-trailThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Provide bidirectional traversal of decision history, enabling users to understand why decisions were made, what happened after them, and search for specific patterns across verification sessions.
View audit logs, decision traces, and session history for AI transparency. Supports log, trace, summary, and search subcommands.
Traces design decisions through CASS sessions, handoffs, git, and artifacts to understand how architectural decisions evolved.
Queries AI decision trails for code reviews (CRs), gates, analysis (intent/change/risk/autonomy), architecture decisions (ADR), and timelines. Audits judgments with confidence scores, processes, and context navigation.
Share bugs, ideas, or general feedback.
Provide bidirectional traversal of decision history, enabling users to understand why decisions were made, what happened after them, and search for specific patterns across verification sessions.
Forward: "What happened after this decision?" Backward: "Why did we make this decision?" Search: "Show all security critic rejections"
.claude/coherence-audit/ directory/audit-trail show session-abc123
Returns complete decision history for verification session.
/audit-trail search security critic rejections
Finds all sessions where security critic vetoed.
/audit-trail why was token storage changed to httpOnly
Traces decision back through critic evaluations to original requirement.
/audit-trail what files depend on auth/middleware.ts
Shows downstream impacts of changes (exposure analysis).
{
"session_id": "session-abc123",
"timestamp": "2026-02-03T14:30:00Z",
"user": "reggie",
"operation": "coherence-check",
"scope": {
"files": ["src/auth/login.ts"],
"operation": "refactor to JWT"
},
"plan": {
"acceptance_criteria": [
"All tests pass",
"No OWASP violations",
"httpOnly cookies used"
],
"critics": ["code", "security", "domain"]
},
"iterations": [
{
"iteration": 1,
"code_critic": {"verdict": "approve", "reason": "..."},
"security_critic": {"verdict": "veto", "reason": "XSS in error msgs"},
"domain_critic": {"verdict": "approve", "reason": "..."}
},
{
"iteration": 2,
"code_critic": {"verdict": "approve", "reason": "..."},
"security_critic": {"verdict": "approve", "reason": "Fixed XSS"},
"domain_critic": {"verdict": "veto", "reason": "Missing audit log"}
},
{
"iteration": 3,
"all_critics": "approve"
}
],
"final_status": "approved",
"cost": {"tokens": 15420, "overhead_pct": 38.6},
"files_changed": ["src/auth/login.ts", "src/auth/middleware.ts"]
}
Path: .claude/coherence-audit/{session_id}.json
Created after each verification session with complete decision history.
Format:
feat(auth): refactor to JWT tokens
Verified by Code Coherence (session-abc123)
- 3 iterations required
- Security critic caught XSS vulnerability
- Domain critic ensured audit trail present
Critics: code✓ security✓ domain✓
Files: src/auth/login.ts src/auth/middleware.ts
Path: .claude/coherence-audit/index.json
Maintains searchable index of all sessions for fast querying.
/audit-trail search "security critic rejections"
/audit-trail search "changes to src/auth/**"
/audit-trail search "sessions from 2026-02-01 to 2026-02-03"
/audit-trail search "sessions with >4 iterations"
When cited facts are corrected, identify downstream impacts:
/audit-trail exposure analyze "token storage decision"
Returns all sessions that depend on the token storage approach, enabling impact assessment of changes.
references/traversal-examples.md - Detailed query examplesreferences/audit-schema.md - Complete audit log JSON schema