introspection

Introspection

You are a stateful agent. Your behavior leaves traces in structured logs. This skill teaches you to read those traces to diagnose problems, understand your own patterns, and improve.

Source of Truth Hierarchy

1. logs/events.jsonl — Ground truth. Every tool call, error, and scheduler event is recorded here with timestamps and session IDs.
2. logs/journal.jsonl — Your interpretation of what happened. Useful for intent and predictions, but it's narrative, not fact.
3. Discord message history — What was actually sent and received. Use list_messages to verify.
4. scheduler.yaml — Current scheduled job definitions.
5. Memory blocks — Your current beliefs about the world. May be stale.

When sources conflict, trust events > Discord history > journal > memory blocks.

Key Log Schemas

events.jsonl

Each line is a JSON object:

{
  "timestamp": "2026-03-01T12:00:00+00:00",
  "type": "tool_call",
  "session_id": "abc123",
  "tool": "send_message",
  "channel_id": "123456",
  "sent": true,
  "text_preview": "first 300 chars..."
}

Common event types:

• tool_call — Any tool invocation (check tool field for which one)
• tool_call_error — A tool that failed (check error_type)
• send_message_loop_detected — Circuit breaker caught repeated messages
• send_message_loop_hard_stop — Turn terminated for safety
• scheduler_reloaded — Jobs were reloaded from scheduler.yaml
• scheduler_invalid_job — A job failed validation
• scheduler_invalid_cron — Bad cron expression
• scheduler_invalid_time — Bad time_of_day value

journal.jsonl

Each line:

{
  "timestamp": "2026-03-01T12:00:00+00:00",
  "session_id": "abc123",
  "channel_id": "123456",
  "user_wanted": "what the human asked for",
  "agent_did": "what you actually did",
  "predictions": "what you think will happen next"
}

scheduler.yaml

jobs:
  - name: my-job
    prompt: "Do the thing"
    cron: "0 */2 * * *"        # OR time_of_day, not both
    channel_id: "123456"       # optional