Skill Tracer
Skills › Superpowers › diagnosing-superpowers › bundle-README.md

bundle-README.md

77 lines · skills/diagnosing-superpowers/templates/bundle-README.md at 2ce8aa1

Open on GitHub
1# Superpowers session diagnosis bundle
2
3Session: <session-id>
4Harness: <name> <version> (<provenance label>) Superpowers: <version> (<sha or "not a checkout">; <provenance label>)
5Redaction level: skeleton | evidence | full
6Built: <ISO timestamp>
7
8Qualify header version fields as historical evidence, unverified snapshot,
9current observation, or unknown. `environment.json` carries the same
10provenance distinctions for every environment field and its supporting
11location.

Superpowers session diagnosis bundle

Session: <session-id> Harness: <name> <version> (<provenance label>) Superpowers: <version> (<sha or "not a checkout">; <provenance label>) Redaction level: skeleton | evidence | full Built: <ISO timestamp>

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.

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

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.

Raw lines 13 to 21
22## Files
24- `report.md` — the diagnosis report (problem statement, verdict,
25 environment, sessions, timeline, findings, involvement, coverage notes).
26- `case.md` — the case file the analysts worked from.
27- `environment.json` — machine-readable copy of the environment section.
28- `timeline.md` — the per-turn timeline.
29- `findings/<dimension>.md` — raw analyst findings per dimension.
30- `transcripts/<session-id>.md` — condensed per-turn rendering of each
31 examined session (never the raw JSONL). Tool-result bodies by level:
33 | Level | Tool-result bodies |
34 |---|---|
35 | skeleton | intentionally limited; replaced by `[tool result: <tool>, <bytes> bytes, exit <code>]` |
36 | evidence | kept for cited events, including the commands and results needed to support findings |
37 | full | all kept |
38- `scrub-log.md` — every placeholder used and its category (never the
39 original value).

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:
LevelTool-result bodies
skeletonintentionally limited; replaced by [tool result: <tool>, <bytes> bytes, exit <code>]
evidencekept for cited events, including the commands and results needed to support findings
fullall kept
  • scrub-log.md — every placeholder used and its category (never the original value).
Raw lines 22 to 40
41## How to read it
43Start with `report.md` §1–2, then §7 (involvement) and the evidence lines
44it cites, then the matching turns in `transcripts/`. `path:line` references
45point at the original files on the reporter's machine; the same line
46numbers are preserved in the condensed transcripts as `[L<n>]` markers.

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.

Raw lines 41 to 47
48## Redaction
50Placeholders look like `<EMAIL-1>`, `<PERSON-2>`, `<SECRET-3>`, `<HOST-4>`,
51`<REPO-5>`, `<ORG-6>`, `<PROPRIETARY-7>`; home paths are rewritten to `~/…`. The same placeholder
52always refers to the same original value within this bundle.

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.

Raw lines 48 to 53
54## Producer instructions
56Completed bundles replace these instructions with actual results.
58After scrubbing, check every material exported finding using only this bundle:
59resolve its citation to an included transcript/source marker, read the cited
60command/result or quotation, and verify that it supports the claim. Path and
61line existence alone are insufficient. Record specific limitations when the
62redaction level or necessary withholding removes support.
64Reconcile report, case, environment, findings, README and any local issue
65draft. Refresh scrub-log counts against final files excluding the log itself.
66Remove stale export statements; distinguish bundle preparation from archive
67delivery. Retain a mapping from historical anchors to included evidence.
69Record the independent privacy audit separately from evidence usefulness:
70- Privacy audit: CLEAN or unresolved misses.
71- Evidence support: supported or limited, with affected findings and reasons.
73If content changes after checking, repeat the affected checks. Present the
74final log, file list and both outcomes for the existing archive approval.
75Archive the reviewed files and verify the delivered archive matches them.
76Record archive delivery outside the reviewed bundle rather than changing its
77contents after approval. Scrubbing is not exhaustive privacy certification.

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.

Raw lines 54 to 77