Sfoglia il codice sorgente

diagnosing-superpowers: say 'plan step', not 'commitment'

In a transcript full of git commits, 'commitment' and 'committed to' read
as version control. The plan-adherence and quality-evidence prompts now
say 'agreed plan' and 'plan step'.
Jesse Vincent 2 giorni fa
parent
commit
e951a39b46

+ 2 - 2
docs/superpowers/specs/2026-08-27-diagnosing-superpowers-design.md

@@ -31,8 +31,8 @@ job, and the skill says so if asked.
 - **Problem intake first.** The skill opens by asking what the user is
 - **Problem intake first.** The skill opens by asking what the user is
   trying to diagnose and works with them until there is a concrete problem
   trying to diagnose and works with them until there is a concrete problem
   statement. Sweeps run in service of that statement.
   statement. Sweeps run in service of that statement.
-- **Quality is judged as process evidence**, against the session's own
-  commitments (design, plan, acceptance criteria, spec/plan files) and
+- **Quality is judged as process evidence**, against the plan the session
+  agreed to (design, plan, acceptance criteria, spec/plan files) and
   against what the transcript proves (tests run, verification behind
   against what the transcript proves (tests run, verification behind
   claims, commits matching claims, review feedback handled). It is not a
   claims, commits matching claims, review feedback handled). It is not a
   code review of the resulting diff.
   code review of the resulting diff.

+ 10 - 10
skills/diagnosing-superpowers/prompts/plan-adherence.md

@@ -3,28 +3,28 @@ context-safety rules, and the return format. This file adds the dimension.
 
 
 Dimension: Plan adherence
 Dimension: Plan adherence
 
 
-Recover what the session committed to, then map each commitment to what
-happened.
+Recover the plan the session agreed to, then map each plan step to what
+happened. "Plan" here means any agreed course of action, not git commits.
 
 
-1. Find the commitments: a design or plan agreed in chat (look for the
+1. Find the agreed plan: a design or plan agreed in chat (look for the
    assistant text preceding a human "yes/ok/go ahead"), a spec or plan file
    assistant text preceding a human "yes/ok/go ahead"), a spec or plan file
    written during the session (tool calls that write under `docs/`,
    written during the session (tool calls that write under `docs/`,
    `plans/`, `specs/`, or any file the human named), a todo list
    `plans/`, `specs/`, or any file the human named), a todo list
    (Claude Code `TodoWrite` tool_use inputs; Codex `update_plan` calls;
    (Claude Code `TodoWrite` tool_use inputs; Codex `update_plan` calls;
-   any numbered checklist in assistant text). Quote each commitment with
+   any numbered checklist in assistant text). Quote each plan step with
    its `path:line`.
    its `path:line`.
-2. Mark structural events between commitment and execution: compaction
+2. Mark structural events between the plan and its execution: compaction
    (Claude Code `compact_boundary`; Codex `compacted` / `context_compacted`),
    (Claude Code `compact_boundary`; Codex `compacted` / `context_compacted`),
    resumes, aborted turns, and subagent dispatches. Note their line
    resumes, aborted turns, and subagent dispatches. Note their line
    numbers; plan drift right after one of these is a distinct finding.
    numbers; plan drift right after one of these is a distinct finding.
-3. For each committed step, find the tool calls and assistant text that
+3. For each plan step, find the tool calls and assistant text that
    executed it, or establish that none did. Report:
    executed it, or establish that none did. Report:
-   - steps skipped (no execution found; quote the commitment);
+   - steps skipped (no execution found; quote the plan step);
    - steps executed out of order (line numbers show the order);
    - steps executed out of order (line numbers show the order);
-   - steps silently changed (execution differs from the commitment in a
+   - steps silently changed (execution differs from the plan step in a
      way the assistant never announced; quote both);
      way the assistant never announced; quote both);
-   - steps invented (work done that no commitment covers);
+   - steps invented (work done that no plan step covers);
    - drift immediately after a structural event (cite the event line and
    - drift immediately after a structural event (cite the event line and
      the first divergent action).
      the first divergent action).
-4. If there is no recoverable commitment, say so as the only finding, with
+4. If there is no recoverable plan, say so as the only finding, with
    the lines you checked.
    the lines you checked.

+ 2 - 2
skills/diagnosing-superpowers/prompts/quality-evidence.md

@@ -17,10 +17,10 @@ not evaluate the code the session produced.
 3. Commits: every `git commit` with its message; compare each message to
 3. Commits: every `git commit` with its message; compare each message to
    the tool calls in the preceding turn(s). Report commits whose message
    the tool calls in the preceding turn(s). Report commits whose message
    claims work that no tool call performed, and work performed that was
    claims work that no tool call performed, and work performed that was
-   never committed when the session's commitments said it would be.
+   never committed when the agreed plan said it would be.
 4. Review feedback: where a reviewer (human or subagent) raised points,
 4. Review feedback: where a reviewer (human or subagent) raised points,
    find the response. Report points acknowledged but not acted on, and
    find the response. Report points acknowledged but not acted on, and
    points dismissed without a stated reason.
    points dismissed without a stated reason.
 5. Acceptance criteria: if the case file's problem statement or the
 5. Acceptance criteria: if the case file's problem statement or the
-   session's commitments state criteria, report each as met / not met /
+   agreed plan states criteria, report each as met / not met /
    not checked with the evidence line.
    not checked with the evidence line.