controller

Coordinate phase-based Bugfix workflow execution with user approval gates.

3|38|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/ambient-code/workflows --skill controller-ambient-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: controller
Source: https://github.com/ambient-code/workflows/tree/main/workflows/bugfix/.claude/skills/controller
Command: npx skills add https://github.com/ambient-code/workflows --skill controller-ambient-code

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Bugfix workflow controller coordinates multi-phase bug resolution, ensuring structured progress and explicit user gates between stages.

Core Features & Use Cases

  • Phase orchestration: maintains and transitions between assess, reproduce, diagnose, fix, test, review, document, pr, and summary.
  • Read-first enforcement: requires reading the SKILL.md before executing any phase to ensure up-to-date instructions.
  • Safe decision gating: uses AskUserQuestion to require explicit user input before advancing.

Quick Start

Provide the initial bug report and let the controller guide the phase flow from assess to the next steps.

Frequently Asked Questions about controller

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is phase-based bugfix workflow orchestration and how does it manage bug resolution?

Phase-based bugfix workflow orchestration coordinates multi-stage bug resolution across reproduction, diagnosis, fixing, testing, and documentation. It enforces structured progression by requiring explicit user approvals before advancing between phases, ensuring disciplined and safe execution.

How do I enforce a structured step-by-step workflow for fixing software bugs?

You enforce a structured bugfix workflow by using a controller that mandates reading instructions before executing any phase. It validates inputs, transitions between assess, reproduce, diagnose, fix, test, review, document, and pr phases, and requires explicit user approval via prompts before advancing.

Can I re-enter a previous phase during a bugfix workflow if user input requires it?

Yes, you can re-enter previous bugfix workflow phases based on user guidance. The controller supports optional phase re-entry, deferring the decision to the user via explicit questions, allowing you to loop back to reproduction or diagnosis if initial fixes fail.

What's the best way to gate user approvals safely between bug resolution stages?

The best way to gate approvals safely is to use interactive user questions before advancing any phase. This ensures explicit confirmation at each step from assessment to documentation, preventing automated transitions and keeping human oversight in the loop.

Do I need to provide a complete bug report to start an orchestrated bugfix workflow?

You only need to provide the initial bug report to start. The controller guides the phase flow from assess to subsequent steps, validating inputs and recommending next actions while deferring to your explicit decisions for phase progression.