Agent skill

workflow-bug-fix

Systematic approach to identifying, fixing, and validating bug fixes. Use when fixing bugs, resolving issues, or addressing errors.

Stars 13
Forks 6

Install this agent skill to your Project

npx add-skill https://github.com/NickCrew/Claude-Cortex/tree/main/skills/workflow-bug-fix

SKILL.md

Bug Fix Workflow

Systematic process for fixing bugs properly.

Phase 1: Root Cause Analysis

Agents: root-cause-analyst

Methods:

  • Error trace analysis
  • Log investigation
  • State inspection
  • Reproduce the bug consistently

Output: Root cause, affected components, impact assessment

Phase 2: Fix Implementation

Constraints:

  • Minimal scope (fix the bug, nothing more)
  • Backward compatible
  • Well tested

Phase 3: Code Review

Agents: code-reviewer

Focus:

  • Fix correctness
  • Side effects
  • Edge cases

Phase 4: Regression Testing

Agents: test-automator

Create tests:

  • Regression test (prevents this bug from returning)
  • Edge case tests
  • Integration tests if affected

Phase 5: Security Check

Agents: security-auditor

Blocking: Ensure fix doesn't introduce vulnerabilities

Phase 6: Validation

Agents: quality-engineer

Checklist:

  • Original issue resolved
  • No new issues introduced
  • All tests pass

Phase 7: Documentation

Agents: technical-writer

  • Changelog entry
  • Incident report (for significant bugs)
  • Prevention guide (what caused it, how to avoid)

Phase 8: Deployment

Agents: deployment-engineer

Strategy: Hotfix if critical, normal release otherwise

Monitor for 24h:

  • Error rate
  • Performance metrics
  • User reports

Success Criteria

  • Bug verified fixed
  • Regression tests added
  • No side effects
  • Documentation updated

Anti-patterns

  • ❌ Fixing symptoms instead of root cause
  • ❌ Large scope changes mixed with bug fix
  • ❌ Skipping regression tests
  • ❌ No documentation of what caused it

Expand your agent's capabilities with these related and highly-rated skills.

NickCrew/Claude-Cortex

claude-consult

Consult Claude specialist agents during implementation for codebase understanding, pattern checking, security review, debugging help, and more. Use this skill whenever you're unsure about conventions, stuck on a failure, or need expert input before writing code. Does not replace the formal review gates in agent-loops — this is for mid-implementation consultation.

13 6
Explore
NickCrew/Claude-Cortex

doc-quality-review

Assess documentation quality across readability, consistency, audience fit, and prose clarity. Produces a scored review with actionable findings. This skill should be used before releases, during doc reviews, or when documentation feels unclear or inconsistent.

13 6
Explore
NickCrew/Claude-Cortex

event-driven-architecture

Event-driven architecture patterns with event sourcing, CQRS, and message-driven communication. Use when designing distributed systems, microservices communication, or systems requiring eventual consistency and scalability.

13 6
Explore
NickCrew/Claude-Cortex

prompt-engineering

Optimize prompts for LLMs and AI systems with structured techniques, evaluation patterns, and synthetic test data generation. Use when building AI features, improving agent performance, or crafting system prompts.

13 6
Explore
NickCrew/Claude-Cortex

compliance-audit

Regulatory compliance auditing across GDPR, HIPAA, PCI DSS, SOC 2, and ISO frameworks with automated evidence collection and gap analysis. Use when conducting compliance assessments, preparing for certifications, or implementing regulatory controls.

13 6
Explore
NickCrew/Claude-Cortex

react-performance-optimization

React performance optimization patterns using memoization, code splitting, and efficient rendering strategies. Use when optimizing slow React applications, reducing bundle size, or improving user experience with large datasets.

13 6
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results