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

templates/bundle-README.md

Superpowers session diagnosis bundle

Session: Harness: () Superpowers: (<sha or "not a checkout">; ) Redaction level: skeleton | evidence | full Built:

Qualify header version fields as historical evidence, unverified snapshot, current observation, or unknown. environment.json carries the same provenance distinctions for every environment field and its supporting location.

What this is

A scrubbed record of a coding-agent session that had superpowers installed and went wrong. It lets an agent or person who was not present decide whether superpowers contributed and, if so, what to change. The report inside states what happened with path:line evidence. By design it contains no diagnosis of superpowers and no proposed fix; that is the reader's job.

Files

  • report.md — the diagnosis report (problem statement, verdict, environment, sessions, timeline, findings, involvement, coverage notes).

  • case.md — the case file the analysts worked from.

  • environment.json — machine-readable copy of the environment section.

  • timeline.md — the per-turn timeline.

  • findings/<dimension>.md — raw analyst findings per dimension.

  • transcripts/<session-id>.md — condensed per-turn rendering of each examined session (never the raw JSONL). Tool-result bodies by level:

    | Level | Tool-result bodies | |---|---| | skeleton | intentionally limited; replaced by [tool result: <tool>, <bytes> bytes, exit <code>] | | evidence | kept for cited events, including the commands and results needed to support findings | | full | all kept |

  • scrub-log.md — every placeholder used and its category (never the original value).

How to read it

Start with report.md §1–2, then §7 (involvement) and the evidence lines it cites, then the matching turns in transcripts/. path:line references point at the original files on the reporter's machine; the same line numbers are preserved in the condensed transcripts as [L<n>] markers.

Redaction

Placeholders look like <EMAIL-1>, <PERSON-2>, <SECRET-3>, <HOST-4>, <REPO-5>, <ORG-6>, <PROPRIETARY-7>; home paths are rewritten to ~/…. The same placeholder always refers to the same original value within this bundle.

Producer instructions

Completed bundles replace these instructions with actual results.

After scrubbing, check every material exported finding using only this bundle: resolve its citation to an included transcript/source marker, read the cited command/result or quotation, and verify that it supports the claim. Path and line existence alone are insufficient. Record specific limitations when the redaction level or necessary withholding removes support.

Reconcile report, case, environment, findings, README and any local issue draft. Refresh scrub-log counts against final files excluding the log itself. Remove stale export statements; distinguish bundle preparation from archive delivery. Retain a mapping from historical anchors to included evidence.

Record the independent privacy audit separately from evidence usefulness:

  • Privacy audit: CLEAN or unresolved misses.
  • Evidence support: supported or limited, with affected findings and reasons.

If content changes after checking, repeat the affected checks. Present the final log, file list and both outcomes for the existing archive approval. Archive the reviewed files and verify the delivered archive matches them. Record archive delivery outside the reviewed bundle rather than changing its contents after approval. Scrubbing is not exhaustive privacy certification.