memory-debugger

Diagnose TraitorSim memory inconsistencies in profiles, diaries, and trust matrices.

Updated Dec 21, 2025
One-click install
npx skills add https://github.com/rickoslyder/TraitorSim --skill memory-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-debugger
Source: https://github.com/rickoslyder/TraitorSim/tree/main/.claude/skills/memory-debugger
Command: npx skills add https://github.com/rickoslyder/TraitorSim --skill memory-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Debug and inspect TraitorSim's memory architecture, including profile.md, diary entries, trusts matrix, and skill definitions.

Core Features & Use Cases

  • Memory inspection: Read profile.md, suspects.csv, diary entries.
  • Memory validation: Verify diary content and trust matrix updates align with events.
  • Use Case: Troubleshoot a faithful whose trust updates stall.

Quick Start

Inspect memory: ls -la data/memories/player_03/; read profile: cat data/memories/player_03/profile.md

Frequently Asked Questions about memory-debugger

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

FAQPage Schema
How do I debug memory inconsistencies in TraitorSim agent profiles and diaries?

Debug memory by inspecting profile.md, diary entries, and trust matrices to identify inconsistencies between recorded events and agent state. Use file-system access to read memory contents, validate updates align with actual events, and diagnose where trust or profile data diverged from expected behavior.

What files make up a TraitorSim agent's memory system?

Agent memory consists of profile.md (agent identity and metadata), suspects.csv (trust matrix tracking confidence in other agents), and diary entries (timestamped event logs). These files must stay synchronized; misalignment between them signals memory corruption or stalled updates.

How do I validate that diary entries match trust matrix updates in TraitorSim?

Validate memory by cross-checking diary timestamps and events against corresponding trust matrix changes. Read both files to confirm each diary entry has a corresponding trust update, and verify the chronological sequence is consistent across both records.

Can I use this to troubleshoot when an agent stops updating its trust scores?

Yes. Inspect the agent's profile.md, diary, and suspects.csv to identify where updates stalled. Check for corrupted entries, missing diary records, or trust matrix inconsistencies that prevent the agent from processing new information and updating confidence scores.

What's the best way to inspect a specific agent's memory contents?

Navigate to the agent's memory directory (data/memories/player_ID/), list all files to verify structure, then read profile.md and diary entries sequentially. Examine suspects.csv to inspect the trust matrix, checking for gaps or anomalies that explain memory behavior.

Do I need file-system access to debug TraitorSim memory?

Yes. Memory debugging requires direct file-system access to read and validate profile.md, suspects.csv, and diary entries stored on disk. This allows precise inspection of memory state and history without relying on agent APIs.