bugflow

Bugflow Plugin for Claude Code

Automated Bugzilla bug workflow that orchestrates a multi-agent pipeline: scrape bug data, analyze root cause, plan the fix, execute code changes, and verify with browser tests.

Prerequisites

• Claude Code CLI
• A Bugzilla instance (any version with standard web UI)
• Playwright MCP server (bundled via .mcp.json)
• (Optional) Slack MCP server for notifications

Installation

# Add the marketplace
/plugin marketplace add Konstantilieris/Bugfow_Plugin

# Install the plugin
/plugin install bugflow@Konstantilieris

Or for local development:

claude --plugin-dir /path/to/bugflow-plugin

First-Time Setup

Run the setup wizard to configure the plugin for your project:

/bugflow:bug-setup

This will ask for:

• Bugzilla URL and credentials
• Application URL(s) (production and development)
• Application credentials and login form selectors
• Slack channel ID (optional, for notifications)
• File paths for state and dossier directories

Configuration is saved to your project's .claude/bugflow/config/ directory (auto-added to .gitignore).

Commands

Command	Description
/bugflow:bug-start <id>	Start full pipeline: scrape, analyze, plan (stops for approval)
/bugflow:bug-accept <id>	Execute approved plan, verify, notify
/bugflow:bug-plan <id>	Re-generate implementation plan
/bugflow:bug-verify <id>	Re-run verification tests
/bugflow:bug-status <id>	Check current workflow state
/bugflow:bug-reset <id>	Reset workflow state for a bug
/bugflow:bug-resume <id>	Resume interrupted workflow from last checkpoint
/bugflow:bug-verdict <id>	Get FE/BE/MIXED/FEATURE verdict

Workflow

/bug-start <id>
  -> Scout: Scrape Bugzilla
  -> Dossier: Create analysis doc + git branch
  -> Analysis: Determine verdict (FE/BE/MIXED/FEATURE)
  -> Plan: Generate implementation plan
  -> Validate: Score plan quality (loop if < 70)
  -> [STOP] Display plan for user approval

/bug-accept <id>
  -> Pre-flight: Validate prerequisites
  -> Execute: Apply code changes
  -> Verify: Run browser tests
  -> Notify: Slack + Bugzilla comment
  -> Extract: Learn patterns for future bugs

Verdict Types

Verdict	Meaning	Action
FE	Frontend bug fix	FE Implementer Planner agent
BE	Backend bug	Creates handoff document
MIXED	Both FE and BE	FE plan + BE handoff doc
FEATURE	New feature request	Feature Designer agent

Agents (19)

The plugin ships with 19 specialized agents that handle different stages of the workflow. See infrastructure/ARCHITECTURE.md for the full agent reference.

Configuration

After running /bugflow:bug-setup, two config files are generated:

• environment.json — URLs, Slack channel, paths, workflow settings
• playwright.json — Browser config, credentials, selectors

These live in your project's .claude/bugflow/config/ and should NOT be committed to git (they contain credentials).

Customization

App-Specific Selectors

Edit .claude/bugflow/config/playwright.json to add selectors for your app:

{
    "selectors": {
        "loginForm": {
            "username": "#your-username-field",
            "password": "#your-password-field",
            "submitButton": "#your-login-button"
        },
        "app": {
            "mainContent": ".your-main-content",
            "navigation": ".your-nav"
        }
    }
}

Workflow Tuning

Edit environment.json to adjust:

• workflow.maxPlanRevisions — how many times to retry plan generation (default: 3)
• workflow.maxVerifyRetries — how many times to retry verification (default: 2)
• workflow.lockExpiryHours — how long a workflow lock lasts (default: 4)

License

MIT