Skip to content

feat(skills): replace curated systematic-debugging with native cross-cutting discipline#108

Merged
pentaxis93 merged 2 commits intomainfrom
issue-93/replace-systematic-debugging
Mar 9, 2026
Merged

feat(skills): replace curated systematic-debugging with native cross-cutting discipline#108
pentaxis93 merged 2 commits intomainfrom
issue-93/replace-systematic-debugging

Conversation

@pentaxis93
Copy link
Owner

Summary

  • Replaces the curated systematic-debugging skill from obra/superpowers with a groundwork-native cross-cutting discipline
  • Reframes debugging from a Stage 4 pipeline skill to a cross-cutting discipline alongside ground (first-principles on creation) and third-force (structural resolution on friction)
  • Preserves load-bearing patterns (Iron Law, 5-step Investigation Move, 3-fix escalation rule) while removing overlap with test-first and verification-before-completion

Changes

New files:

  • skills/systematic-debugging/SKILL.md — native skill with 5-step Investigation Move (Stop, Read, Reproduce, Trace, Hypothesize), 3-fix escalation rule, recognition patterns, corruption modes, bidirectional cross-references
  • skills/systematic-debugging/references/defense-in-depth.md — migrated companion file, generalized to language-agnostic
  • skills/systematic-debugging/LICENSE-UPSTREAM — upstream attribution for obra/superpowers

Pipeline integration:

  • skills/using-groundwork/SKILL.md — new "Root cause before fixes" integration principle; systematic-debugging removed from Stage 4 inline listing
  • WORKFLOW.md — Root-Cause Investigation Thread with 3 handoff rules (→ test-first, → ground, → third-force); Stage 4 entry annotated as cross-cutting
  • docs/architecture/pipeline-contract.md — 2 handoff contracts, anti-divergence rule Regenerate issue-craft skill around its fundamental exigence #9, compliance checklist item

Dependency management:

  • agents.toml — pointed to pentaxis93/groundwork
  • skills/skills.toml — pointed to pentaxis93/groundwork

Issue(s)

Closes #93

Test plan

  • Read new skill and confirm no overlap with test-first fix-bug or verification-before-completion
  • Verify cross-references are bidirectional (systematic-debugging ↔ test-first)
  • Verify using-groundwork lists it as an integration principle, not a Stage 4 skill
  • Verify WORKFLOW.md has Root-Cause Investigation Thread with handoff rules
  • Verify pipeline-contract.md has new handoff contracts and anti-divergence rule
  • Run sk sync --skill-target name --non-interactive after merge — skill installs from GitHub

…cutting discipline

Reframe systematic-debugging from a Stage 4 pipeline skill to a cross-cutting
discipline alongside ground and third-force. All three share the same cognitive
shape: interrupt the default impulse with structured investigation before acting.

The native skill preserves the load-bearing patterns from obra/superpowers
(Iron Law, 5-step Investigation Move, 3-fix escalation rule, anti-rationalization
patterns) while removing overlap with test-first (test creation) and
verification-before-completion (fix verification).

Pipeline integration:
- using-groundwork: new "Root cause before fixes" integration principle
- WORKFLOW.md: Root-Cause Investigation Thread with handoff rules
- pipeline-contract.md: handoff contracts, anti-divergence rule, checklist item
- agents.toml/skills.toml: point to pentaxis93/groundwork

Refs #93

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions
Copy link

github-actions bot commented Mar 9, 2026

I did not identify any actionable correctness, reliability, or maintainability defects introduced by this diff. The changes are consistent documentation and dependency-source updates for systematic-debugging, with the new local skill content present in-repo.

Raw outputs: codex-review.md, codex-review.jsonl

README.md: systematic-debugging is now cross-cutting, not Execution stage.
ARCHITECTURE.md: only subagent orchestration remains upstream from superpowers.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@pentaxis93 pentaxis93 merged commit cfa6853 into main Mar 9, 2026
1 check passed
@pentaxis93 pentaxis93 deleted the issue-93/replace-systematic-debugging branch March 9, 2026 13:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

task(skills): replace curated systematic-debugging with groundwork-native original

1 participant