Back to Skills

verifybug

verified

Output format (human or json)

View on GitHub

Marketplace

brockhoff-tools

kbrockhoff/brockhoff-tools-claude

Plugin

bkff

Repository

kbrockhoff/brockhoff-tools-claude

plugins/bkff/skills/verifybug/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/kbrockhoff/brockhoff-tools-claude/blob/main/plugins/bkff/skills/verifybug/SKILL.md -a claude-code --skill verifybug

Installation paths:

Claude
.claude/skills/verifybug/
Powered by add-skill CLI

Instructions

# Verify Bug Fix

Verifies that a beads bug is fixed by:
1. Checking acceptance criteria (reproduction steps and fix verification)
2. Executing the build system `validate` target
3. Confirming the bug no longer reproduces

## Usage

```bash
# Verify bug fix
/bkff:verifybug --issue=beads-abc123

# Output as JSON
/bkff:verifybug --issue=beads-abc123 --format=json
```

## Verification Process

1. **Acceptance Criteria Check**: Bug must have:
   - Reproduction steps (how to trigger the bug)
   - Fix verification steps (how to confirm the fix)

2. **Validate Target**: Runs tests to ensure:
   - The bug no longer reproduces
   - No regression in existing functionality
   - Code quality standards maintained

## What Gets Checked

The `validate` target for bugs should verify:

| Check Type | Description |
|------------|-------------|
| Regression Tests | Bug-specific regression test passes |
| Unit Tests | All related unit tests pass |
| Quality | No new quality issues introduced |
| Standards | Fix follows coding standards |

## Output

### Verification Passed

```
Info: Verifying bug fix: beads-abc123

Verification Result
─────────────────────────────────────
  Issue:          beads-abc123
  Target:         validate

✓ Verification passed
```

### Verification Failed

```
Info: Verifying bug fix: beads-abc123

Verification Result
─────────────────────────────────────
  Issue:          beads-abc123
  Target:         validate

✗ Verification failed

Summary:
  • Tests failed: 1

Failures:
  tests/test-regression.sh:-: [test] Test failed: test_bug_123_does_not_reproduce
```

## Bug Issue Best Practices

For effective bug verification, ensure your bug issue includes:

```markdown
## Description
Clear description of the bug behavior.

## Reproduction Steps
1. Step to reproduce
2. Step to reproduce
3. Observe the bug

## Expected Behavior
What should happen instead.

## Fix Verification
1. Step to verify fix
2. Confirm expected behavior
3. Check no regression
```

## Requiremen

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
3269 chars