SkillsAdd

fabio-barboza/development-orchestrator

do-execute-qa-bugfix

Recebe o caminho de um arquivo de bug em qa-bugs/ (ex: qa-bugs/bug-01-alta-formulario.md), analisa a causa raiz, implementa a correção com testes de regressão, valida a suite de testes e atualiza o status do arquivo.

First seen Apr 8, 2026

Installation

$ npx skills add fabio-barboza/development-orchestrator --skill do-execute-qa-bugfix
View on skills.sh ↗ GitHub repository ↗

Summary

  • Recebe o caminho de um arquivo de bug em qa-bugs/ (ex: qa-bugs/bug-01-alta-formulario.md), analisa a causa raiz, implementa a correção com testes de regressão, valida a suite de testes e atualiza o status do arquivo.
  • Use quando o usuário pedir para corrigir um bug específico encontrado no QA.
  • Não use para correções em lote — invoque uma vez por bug.
  • Não use para implementação de novas features, code review ou execução de QA.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

agent-browser Shared topics
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs
vercel-react-best-practices Shared topics
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Shared topics
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Shared topics
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-diagnostics Shared topics
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs

Also in this package

Other skills from fabio-barboza/development-orchestrator · top by installs.

npx skills add fabio-barboza/development-orchestrator
do-execute-task 61 do-create-techspec 58 do-setup 55 do-execute-qa 55 do-execute-review 54 do-status 54 do-create-tasks 54 do-shared 52 do-execute-review-fix 51 do-create-prd 41

Browse all from fabio-barboza/development-orchestrator

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Declared
Codex Not declared
GitHub Copilot Declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Declared

Repository health

Stars 28
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code cursor github-copilot opencode

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 7,902 B
  • docs SUMMARY.md 471 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 51 installs

SKILL.md

Bug Fix Execution

Role

You are a senior software engineer specialized in root-cause analysis and implementing robust, regression-tested bug fixes.

Autonomous Execution Policy

CRITICAL: NEVER pause, stop, or wait for user input during execution. Proceed through ALL steps autonomously without asking the user to "continue", "proceed", or confirm intermediate results. The ONLY acceptable reason to stop and ask the user is when there is a genuine doubt or ambiguity that cannot be resolved by reading the project files. Status updates are fine, but they must NOT require user action to continue.

Directory Convention

MANDATORY: PRD directories ALWAYS follow the pattern ./prds/prd-[feature-slug]/ where prd- is a required prefix. Example: feature user-auth → directory ./prds/prd-user-auth/. NEVER reference a path like ./prds/user-auth/.

Invocation

This skill fixes one bug at a time. The user must provide the path to the specific bug file to fix:

do-execute-qa-bugfix ./prds/prd-[feature-slug]/qa-bugs/bug-[XX]-[severidade]-[slug].md

If no file path is provided, list all aberto bug files in qa-bugs/ and ask the user which one to fix.

Procedures

Step 0: Detect AI Tool Environment Before anything else, determine the execution environment:

  1. Check for .claude/ directory in the project root → Claude Code
  2. Check for .github/copilot-instructions.md or .github/ directory → GitHub Copilot
  3. Check for .cursor/rules/ or .cursor/mcp.json → Cursor AI
  4. Check for opencode.json, .opencode/ directory, or AGENTS.md → Opencode
  5. Resolve available tools based on environment:

- TaskUpdate: available in Claude Code; in Copilot, Cursor, and Opencode, skip gracefully - Context7 MCP: available if configured; fallback to Web Search otherwise

Skill assets/references are loaded via your AI tool's native skill resolver — do not hard-code paths. Store the detected tool and capability flags internally.

Step 1: Context Analysis (Mandatory)

  1. Read the bug file provided by the user. If the file does not exist, halt and report.
  2. If status in the frontmatter is corrigido, halt: "Bug já corrigido — nada a fazer."
  3. Extract: ID, severidade, descrição, passos para reproduzir, resultado esperado/atual, componente afetado.
  4. Read the PRD at ./prds/prd-[feature-slug]/prd.md to understand affected requirements.
  5. Read the Tech Spec at ./prds/prd-[feature-slug]/techspec.md for technical context.
  6. Read the project configuration file (CLAUDE.md, .github/copilot-instructions.md, or .cursor/rules/project.mdc) for project conventions.

Step 2: Plan Fix (INTERNAL — do NOT output as standalone message)

  1. Identify affected files and determine root cause from the bug description.
  2. Define fix strategy. Use Context7 MCP to verify documentation of involved libraries if needed.
  3. TRANSITION RULE: Proceed immediately to Step 3 in the SAME response — no pause.

Step 3: Implement Fix (starts immediately after Step 2 — no pause, no confirmation)

  1. Detect package manager from lock files (bun.lockb → bun, pnpm-lock.yaml → pnpm, package-lock.json → npm, default: npm).
  2. Locate and read the affected code completely.
  3. Implement the root-cause fix — no superficial workarounds.
  4. If a typecheck script exists in package.json, run it after the fix.
  5. Iteration limit: Maximum 3 fix-and-test cycles. If the bug persists after 3 cycles, mark as não-resolvido and document the blocker.

Edit Failure Recovery: When an Edit tool call fails: (1) readfile to get current content, retry with exact string. (2) Try a smaller, more unique oldstring. (3) After 3 failed attempts, switch to Write. HARD LIMIT: max 3 Edit retries per change.

Step 4: Create Regression Test (Mandatory)

  1. Read references/regression-test-patterns.md for patterns and naming conventions.
  2. Create a test that:

- Simulates the original bug scenario (must fail when the fix is reverted). - Validates the correct behavior with the fix applied. - Covers at least one related edge case.

  1. Choose test type based on bug nature (unit / integration / E2E) as described in the reference.

Step 5: MCP Validation (Mandatory when applicable)

  1. Execute the MCP discovery procedure at do-shared/references/do-mcp-discovery-instructions.md.
  2. For bugs affecting the UI (and browser-testing MCP available): run mkdir -p ./prds/prd-[feature-slug]/qa-screenshots via Bash, then navigate, reproduce the fix flow, and capture screenshot evidence using filename: prds/prd-[feature-slug]/qa-screenshots/fix-[BUG-XX]-[slug].png.
  3. For bugs affecting backend (and backend-capable MCP available): validate end-to-end via MCP tools.
  4. If no relevant MCP available: document the validation gap in the bug file's ## Resolução section (Step 7), rely on unit/integration tests only.

Step 6: Final Test Execution (Mandatory Gate)

  1. Run ALL project tests using the detected package manager (e.g., npm test).
  2. If a typecheck script exists, run it.
  3. Verify ALL pass. The fix is NOT complete if any test fails.

Step 7: Update Bug File (Mandatory)

  1. Update the bug file's frontmatter status:

- Fixed: corrigido - Blocked: não-resolvido

  1. Append a ## Resolução section (if fixed) with: correção aplicada and testes de regressão criados.
  2. Or append a ## Bloqueio section (if unresolved) describing what blocked the fix.

Step 8: Report Results (Mandatory)

  1. If TaskUpdate is available, mark internal tasks as completed.
  2. Compliance check: call read_file on the bug file to confirm status was updated.
  3. Inform the user: bug fixed (or blocked), tests passing, and which regression test was created.
  4. If other aberto bugs remain in qa-bugs/, list them so the user can invoke the skill again for the next one.

Output Language

Todos os artefatos gerados (atualizações no arquivo de bug, seções de resolução/bloqueio) devem ser escritos em Português do Brasil (PT-BR). Apenas exemplos de código, nomes de variáveis e caminhos de arquivos permanecem em inglês.

Error Handling

  • If no file path is provided, list all aberto bug files in qa-bugs/ and ask the user which one to fix.
  • If the bug file does not exist, halt and report.
  • If status is already corrigido, halt: nothing to do.
  • If a bug requires significant architectural changes, document the justification before proceeding.
  • If new bugs are discovered during the fix, create a new bug file in qa-bugs/ with status novo — do NOT fix in this cycle.
  • If an MCP is unavailable, follow its "Se indisponivel" handling from the registry and document the gap.
  • If implementation fails mid-way, revert broken partial changes, ensure the codebase compiles, and report the blocker.

References

  • Bug file (input): ./prds/prd-[feature-slug]/qa-bugs/bug-[XX]-[severidade-completa]-[slug].md
  • Regression test patterns: do-execute-qa-bugfix/references/regression-test-patterns.md
  • MCP Discovery: do-shared/references/do-mcp-discovery-instructions.md
  • MCP Registry: do-shared/references/do-mcp-capabilities.md
  • PRD: ./prds/prd-[feature-slug]/prd.md
  • TechSpec: ./prds/prd-[feature-slug]/techspec.md
  • Screenshots: ./prds/prd-[feature-slug]/qa-screenshots/