observability-report

The single skill for reading Shannon-produced logs, Claude Code session JSONLs, and active run-state files. Cross-references with python-agent-sdk (the producer of hooks.jsonl), the loop/autopilot state files, session-handoff outputs, and goal-orchestration state.

Modes

trace — post-hoc timeline (/shannon:trace)

1. Read ~/.claude/projects/<project>/<session-id>.jsonl.
2. Stream-parse (some sessions are >100MB).
3. Filter to Shannon-relevant events using the schema in references/event-schemas.md:
   • hook fires (PreToolUse, PostToolUse, etc.)
   • skill triggers (Skill(<name>) invocations)
   • tool calls (Read/Write/Edit/Bash/Glob/Grep/Skill)
   • agent spawns (Task / Subagent)
   • banner emissions ([SHANNON:LOOP ...], [RALPH + ULTRAWORK ...])
4. Render chronological timeline with line citations.

--replay <session-id> walks events one at a time (or --step N) — critical for debugging stuck loops.