Menu
Lightweight workflow for bug fixes and small issues (Codex skill for /ensemble:fix-issue)
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | ensemble-fix-issue |
| description | Lightweight workflow for bug fixes and small issues (Codex skill for /ensemble:fix-issue) |
| user-invocable | true |
| model | gpt-5.1-codex |
This Codex skill mirrors the Ensemble slash command /ensemble:fix-issue.
Follow the workflow below, adapt to the current repository, and keep outputs structured.
Orchestrate a complete bug fix workflow from analysis to PR creation, assembling a virtual team of specialized agents (Product Manager, Tech Lead, Architect, QA Lead) to ensure high-quality fixes with minimal user intervention.
1. Codebase Analysis Explore codebase to identify affected files, patterns, and scope. Use Grep, Glob, and Read tools to understand context.
2. Collaborative Planning Assemble virtual team of 4 specialized agents to create comprehensive fix plan with multiple perspectives.
3. User Interview (Conditional) If issue description is ambiguous or --interactive flag is set, ask clarifying questions ONE AT A TIME (max 5) -- never batch questions. Use AskUserQuestion for each. Wait for each answer before asking the next.
1. Branch Creation Create git branch with conventional naming
2. Task List Generation Break down plan into actionable tasks
3. Task Execution Execute all tasks with appropriate agent delegation and real-time progress tracking.
1. Test Validation Run test suite with auto-fix retry logic. Ensure all tests pass before creating PR.
2. PR Creation Create comprehensive pull request with GitHub CLI
Format: Pull Request
Structure:
/ensemble:fix-issue
Generate a normalized executable workstream TRD from multiple source TRDs (Codex skill for /ensemble:create-workstream-trd)
Implement TRD with beads project management โ persistent bead hierarchy, dependency-aware execution via br/bv, and cross-session resumability (Codex skill for /ensemble:implement-trd-beads)
Approval-gated Beads graph refinement before execution (Codex skill for /ensemble:refine-beads)
Create Foreman-native structured Technical Requirements Document from PRD โ omits adversarial review phase, outputs parser-compatible tables (Codex skill for /ensemble:create-trd-foreman)
Create Technical Requirements Document from PRD with architecture design and adversarial review (Codex skill for /ensemble:create-trd)
Create comprehensive Product Requirements Document with structured elicitation and adversarial review (Codex skill for /ensemble:create-prd)