npx claudepluginhub konstantilieris/bugfow_pluginThis skill is limited to using the following tools:
**Configuration Required**: This skill requires project configuration. If `.claude/bugflow/config/environment.json` does not exist, prompt the user to run `/bugflow:bug-setup` first.
Current session: !`source "${CLAUDE_PLUGIN_ROOT}/scripts/state.sh" && get_current_session 2>/dev/null || echo "No active session"`
Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.
Share bugs, ideas, or general feedback.
Configuration Required: This skill requires project configuration. If .claude/bugflow/config/environment.json does not exist, prompt the user to run /bugflow:bug-setup first.
/bug-status <bug_id>bug status, bugstatusbug_id (required) - Bugzilla bug IDShows the current workflow state for a bug.
Parse bug ID from various formats.
Read <paths.stateDir> from project config (default: .bugflow) / <bugId>.json
If not found:
Bug <bugId> not found in workflow.
Run `/bug-start <bugId>` to begin.
Bug <bugId>: <title>
State: <STATE>
Branch: <branch>
Verdict: <FE|BE|MIXED|pending>
Progress:
[x] Scout complete
[x] Dossier created
[<check>] Analysis complete
[<check>] Verdict determined: <verdict>
[<check>] Implementation planned
[<check>] Changes applied
[<check>] Verification complete
Files:
- <paths.dossierDir> from project config (default: docs/bugflow) / bug-<bugId>.md
<if BE or MIXED>
- <paths.dossierDir> from project config (default: docs/bugflow) / bug-<bugId>-backend-doc.md
Last updated: <timestamp>
Execution Log:
<timestamp> - SCOUT - success
<timestamp> - DOSSIER - success
...
Next steps:
<context-appropriate next command>
| State | Description | Next Command |
|---|---|---|
| INIT | Just started | Automatic |
| SCOUT | Scraping Bugzilla | Automatic |
| DOSSIER | Dossier created | Automatic |
| ANALYZE | Analysis in progress | Wait |
| VERDICT | Analysis complete | /bug-plan (FE) or done (BE) |
| PLAN_FE | Plan generated | /bug-accept |
| FEATURE_DESIGN | Feature design in progress | Automatic |
| TEST_SPEC | Test spec being generated | Automatic |
| VALIDATE | Plan validation in progress | Automatic |
| DONE_BE | Backend bug | Coordinate with BE team |
| AWAITING_APPROVAL | Plan ready | /bug-accept |
| PRE_FLIGHT | Validating prerequisites | Automatic |
| CHECKPOINT | Creating rollback point | Automatic |
| EXECUTE | Changes applied | /bug-verify |
| VERIFY | Verification in progress | Wait |
| VERIFY_FAIL | Verification failed | /bug-plan (revise) or /bug-reset |
| CLEANUP | Removing instrumentation | Automatic |
| CLOSED | Complete | Done |
| STALLED | Workflow paused (error/timeout) | /bug-resume or /bug-reset |
| BLOCKED | Waiting on external dependency | Resolve blocker, then /bug-resume |
| ROLLBACK | Rolling back changes | Wait |
| ERROR | Fatal error occurred | /bug-reset |
States are grouped into phases for supervisor routing:
| Phase | States | Supervisor |
|---|---|---|
| INGEST | INIT, SCOUT, DOSSIER | ingest-supervisor |
| ANALYZE | ANALYZE, VERDICT | (direct execution) |
| PLAN | PLAN_FE, FEATURE_DESIGN, TEST_SPEC, VALIDATE | plan-supervisor |
| EXECUTE | AWAITING_APPROVAL, PRE_FLIGHT, CHECKPOINT, EXECUTE | exec-supervisor |
| VERIFY | VERIFY, VERIFY_FAIL, CLEANUP | exec-supervisor |
| COMPLETE | CLOSED, DONE_BE | (terminal) |
| STALLED | STALLED, BLOCKED, ERROR, ROLLBACK | (requires intervention) |
Ready for implementation planning.
Run: /bug-plan <bugId>
Backend bug - FE workflow complete.
See: <paths.dossierDir> from project config (default: docs/bugflow) / bug-<bugId>-backend-doc.md
Coordinate with backend team.
Plan ready for execution.
Review: <paths.dossierDir> from project config (default: docs/bugflow) / bug-<bugId>.md
Run: /bug-accept <bugId>
Plan validated and ready for execution.
Validation score: <score>/100
Risk level: <riskLevel>
Review the plan in: <paths.dossierDir> from project config (default: docs/bugflow) / bug-<bugId>.md
When ready, run: /bug-accept <bugId>
Changes applied. Ready for verification.
Run: /bug-verify <bugId>
Verification complete.
Create PR for branch: <branch>
Workflow stalled at: <phase>
Reason: <stall reason>
Stalled Context:
- Last agent: <agent>
- Last error: <error message>
- Recoverable: <yes/no>
Options:
1. Attempt resume: /bug-resume <bugId>
2. Reset to earlier state: /bug-reset <bugId> --to <state>
3. Hard reset: /bug-reset <bugId> --hard
Fatal error in workflow.
Error: <error message>
Agent: <agent that failed>
This error is not recoverable automatically.
Options:
1. Review error and fix manually
2. Hard reset: /bug-reset <bugId> --hard
3. Check logs: <paths.stateDir> from project config (default: .bugflow) / _logs/<bugId>.log.json
Rolling back changes...
Checkpoint: <checkpoint id>
Files being restored: <count>
Wait for rollback to complete, then:
- Status will change to PLAN_FE (re-plan needed)
- Or STALLED if rollback fails
Verification failed.
Attempts: <attempt count>
Last failure: <failure reason>
Changes have been rolled back.
Options:
1. Re-plan with lessons learned: /bug-plan <bugId>
2. Review and fix manually, then: /bug-verify <bugId>
3. Reset workflow: /bug-reset <bugId>
For quick reference:
<bugId>: <STATE> | <verdict> | <branch>
Example:
6231: PLAN_FE | FE | bug/6231-address-autocomplete