Does this skill update my project documentation?

Yes, after a fix is implemented, it initiates a 'trace' phase that records the fix in your changelog and prepares code mapping changes for your architectural documents.

Can I use the debug skill without design documents?

Yes, the skill includes a 'General Debug' mode for when spec.md or arch.md are unavailable, though it is most effective when it can cross-reference your intended design.

Which Claude model is recommended for debugging?

Claude 3.5 Sonnet is the default choice for most bugs, but Claude 3 Opus is highly recommended for complex issues involving multi-file analysis and deep flow logic.

How does the skill verify that a bug is actually fixed?

It uses the Shell tool to execute your project's specific run commands (like npm run dev or uvicorn), performing a live verification check in the E2E environment.

What is the difference between /test and /debug in this skill?

Use /test for fixing specific unit test failures. Use /debug for E2E issues where functionality is broken even if unit tests are passing, such as integration or environment-specific bugs.

Systematic Bug Fixer

Name: Systematic Bug Fixer
Author: samdae

bysamdae

0•

セキュリティとテスト

Resolves complex end-to-end bugs by cross-referencing real-time code execution with architectural design documents.

The Systematic Bug Fixer is a specialized Claude Code skill designed for resolving intricate E2E issues where unit tests pass but functionality fails. By leveraging the ArchFlow methodology, it analyzes requirements and design flows to identify root causes that traditional debuggers might miss. The skill guides Claude through a structured multi-phase workflow—from initial document analysis and hypothesis testing to direct shell-based verification and automated changelog generation—ensuring that every fix is architecturally sound and properly documented.

主な機能

01Cross-references stack traces with design flows (arch.md) and requirements (spec.md)

02Integrated code mapping updates to maintain architectural synchronization

03Automates E2E verification using direct Shell execution for backend and frontend services

040 GitHub stars

05Intelligent fallback mechanisms for environments with missing documentation

06Structured four-phase debugging workflow: Entry, Analysis, Fix, and Trace

ユースケース

01Resolving API contract violations and integration mismatches between microservices

02Debugging complex frontend-backend timing issues and race conditions

03Investigating environment-specific bugs that require live code execution and log analysis

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add samdae/archflow debug

For use in Claude.ai and ChatGPT