Agent skill
workflow-bug-fix
Systematic approach to identifying, fixing, and validating bug fixes. Use when fixing bugs, resolving issues, or addressing errors.
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
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.
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.
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.
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.
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.
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.
Didn't find tool you were looking for?