AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

diagnosing-superpowers

Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.

Original source
obra
License
MIT
Pinned revision
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read obra--diagnosing-superpowers at revision 2ce8aa15d05bd57213e6f746f953aafb7ded7a8b, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 20

references/context-safety.md

Context safety for session transcripts

One transcript record can exceed a megabyte or embed a whole history. Printing one whole record can overflow the context of the session doing the diagnosis. Every reader of a session file, controller or subagent, follows these rules for every file, every time.

  1. Measure before reading.

    wc -lc "$F"
    awk '{ if (length($0) > 100000) print NR, length($0) }' "$F"   # long lines
    
  2. Never cat or grep for content. Get line numbers and counts first (grep -n … | cut -d: -f1, jq -r '.type' | sort | uniq -c), then small fields from specific lines (sed -n Np | jq -c '{…}' or | cut -c1-500). Use the field-extraction commands established during discovery for the source in front of you.

  3. Narrow anything over 500 characters. If a command returns more than 500 characters for one record, tighten the field or the slice.

  4. Read-only. Never modify, move, or delete a session file.