Skip to content

davepoon/buildwithclaude / plugins/all-skills/skills/agenttrace-session-audit

agenttrace-session-audit

Verified

Audit local AI coding-agent sessions with agenttrace for cost, tokens, tool failures, latency, anomalies, health, diffs, and CI gates.

agenttrace Session Audit

Use this skill when session logs need an operational read: spend, token burn, cache use, tool failures, retry loops, latency, health, anomalies, and CI gate readiness.

Workflow

  1. Prefer the installed agenttrace binary when it is available on PATH.
  2. If the binary is not available and the current directory is the luoyuctl/agenttrace repository, use cargo run -q -p agenttrace --.
  3. Start with discovery unless the user gave a specific file or directory:
agenttrace --doctor
agenttrace --overview
  1. For a fast human report, use Markdown:
agenttrace --overview -f markdown -o agenttrace-overview.md
  1. For automation or CI, use JSON or health gates:
agenttrace --overview -f json -o agenttrace-overview.json
agenttrace --overview --fail-under-health 80 --fail-on-critical --max-tool-fail-rate 15
  1. For a single recent session:
agenttrace --latest
agenttrace --latest -f json
  1. For a specific export or session directory:
agenttrace path/to/session-or-export.json
agenttrace --overview -d path/to/session-dir

Report Focus

  • Lead with the highest-risk sessions and the reason they matter.
  • Call out token/cost waste, repeated tool failures, retry loops, long gaps, and low health scores.
  • When proposing a CI gate, include the exact agenttrace command and threshold.
  • If no sessions are detected, run agenttrace --doctor and report the detected agent directories and next step.
  • Report the session capability level (Detailed, Aggregate, or Limited) before relying on latency or step evidence.
  • Treat Tool Steps as metadata-only evidence. Do not imply that Aggregate or Limited sources have a complete execution trace.

Guardrails

  • Treat prompts, code, and session contents as local/private data. Do not upload logs to external services.
  • Do not invent metrics. If a parser cannot infer cost, model, or latency, say which field is missing.
  • Do not compare missing event-level evidence as zero latency or zero failures; mark it unavailable.
  • Do not overwrite user reports unless the user asked for that output path.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 193kUpdated Claude CodeCodexVerifiedInstall