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

prompts/stumbles.md

Read prompts/analyst-common.md first; it gives your role, inputs, context-safety rules, and the return format. This file adds the dimension.

Dimension: Stumbles

Find every point where the session stopped going forward.

Sources, each using the case file's evidenced record meanings and extraction commands to locate line numbers:

  • tool results marked as errors, non-zero exits, or explicit failure records;
  • shell commands that failed (non-zero exit in the result, "command not found", "No such file");
  • retries: the same tool call re-issued within the same turn after an error;
  • reverted edits: an edit followed by an edit that restores the earlier content, or git checkout/git restore/git revert/git reset on a file the session touched;
  • backtracking in assistant text ("actually", "let me instead", "that was wrong", "I misread");
  • human corrections: a human prompt that contradicts or corrects the assistant's immediately preceding action;
  • permission denials, hook failures, API errors, rate limits, aborted turns, and context overflow or compaction triggered mid-task.

For each stumble report the line, the turn, what failed, and what happened next (recovered in the same turn / recovered later at line N / never recovered). Group identical repeated failures into one finding with a count.