Commit Graph

3 Commits

Author SHA1 Message Date
Milan 09ddb4a38e fix: diagnose anti-convergence guardrails — environment check, workflow map, narrative bias
Analyzed a real diagnostic session that wasted 500+ lines querying the wrong
database, skipped the workflow map, jumped between hypotheses without testing,
and declared confidence 8/10 without reproducing the issue.

New guardrails:
- "5 Deadly Sins" section: wrong database, skipping workflow map, narrative
  bias, premature confidence, sequential hypothesis testing
- Phase 0-env: mandatory environment verification before ANY database query
  (print host/db, verify it matches the reported environment)
- Phase 1f: "MANDATORY BEFORE ANY HYPOTHESIS" with explicit warning about
  the #1 failure mode (skipping the map → anchoring on first suspicious thing)
- Evidence Gate 1: now a printable checklist that must include workflow map
  completion; "print it with answers" instruction
- Anti-narrative rule in Phase 2: catch "so it must be..." reasoning
- Anti-premature-convergence rules: max confidence 7 without reproduction,
  "what ELSE could explain this?" prompt after every suspicious finding

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-08 19:27:22 -07:00
Milan 71e2244c29 fix: diagnose learnings persistence — full paths, explicit instructions, turn budget
Three root causes for env-profile learnings never being saved:

1. Bare `gstack-learnings-log` / `gstack-learnings-search` without full path —
   binary not on PATH in all environments. Fixed: use ~/.claude/skills/gstack/bin/

2. Phase 0j used angle-bracket template placeholders (<FULL INVENTORY...>) that
   the model treated as examples rather than fill-in-the-blank instructions.
   Fixed: explicit YOUR_ACTUAL_INVENTORY_HERE with format example and rules.

3. Model burned all turns retrying Phase 0-pre learnings search (empty output
   from gstack-learnings-search was ambiguous). Fixed: use Grep tool instead
   of Bash, single call with explicit "do not retry" instruction.

Also: added Phase 0 turn budget (≤5 tool calls) and $B quoting fix (line 232).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-07 18:19:20 -07:00
Milan 1c28068dcc feat: add /diagnose skill — deep diagnostic root cause analysis
Read-only evidence-gathering complement to /investigate. Overcomes the
model's bias towards action by enforcing evidence gates at each phase.
Produces a diagnostic report with certainty scores — no code changes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-06 15:42:37 -07:00