← Back to the catalog

Workflow · Version 1.0.0

Bug fix

Find the root cause, plan and implement the fix, then verify the regression and document the result.

Why add it?

Details… Show less

Bug fix

Find the root cause, plan and implement the fix, then verify the regression and document the result.

Members: Atlas, Cleo, Focus, Leo, Nova, Orion, and Repro. Includes their exact Orqestria profiles, portraits and 60 supporting skills. Leads and independent reviewers are assigned to each agent-led step.

  • Diagnosis — Lead: Atlas. Review: Repro and Orion.
  • Fix plan — Lead: Orion. Review: Nova and Atlas.
  • Fix — Lead: Leo. Review: Nova and Atlas.
  • Regression tests — Orqestria runs the configured verification commands; this step has no separate lead agent.
  • Documentation — Lead: Cleo. Review: Nova and Focus.

Install the package, review and trust the skill sources, then enable the included agents and relevant skills in your project. Select this workflow for a work item. The configured leads and reviewers must be available in the project; model providers must be signed in. You can adjust assignments in the workflow editor. Installation does not replace your existing default workflows.

What is included

Agents 7

Skills in this workflow 60

Explore the skills assigned to the workflow steps and their agents. Open a card for a clear explanation, a practical example and the agents who can use it.

Systematic debugging

Finds the earliest demonstrated cause of a reproducible failure through explicit hypotheses and focused verification.

systematic-debugging

Included files 2
  • LICENSE.txt
  • SKILL.md

Actionable bug reports

Writes precise defect reports that help another person reproduce the problem, understand its impact and verify the eventual repair.

bug-reporting

Included files 2
  • LICENSE.txt
  • SKILL.md

Codebase discovery

Helps you navigate an existing project by locating important files, system connections and the right place for a scoped change.

codebase-discovery

Included files 2
  • LICENSE.txt
  • SKILL.md

Implementation task breakdown

Converts a specification into ordered, reviewable delivery tasks with working user outcomes and explicit acceptance evidence.

task-breakdown

Included files 2
  • LICENSE.txt
  • SKILL.md

Testing and reliability

Builds tests for individual functions and complete workflows, helping catch errors and prevent previously fixed problems from returning.

testing-discipline

Included files 1
  • SKILL.md

Focused code changes

Keeps a code change complete but reviewable by following local conventions and limiting edits and dependencies to the requested outcome.

clean-changes

Included files 1
  • SKILL.md

Maintain documentation

Updates canonical project documents alongside code changes and resolves contradictions using the actual implementation.

documentation-maintenance

Included files 2
  • LICENSE.txt
  • SKILL.md

Verify documentation examples

Checks that documented commands and examples are consistent, safe to share and accurately labeled as tested or untested.

doc-verification

Included files 2
  • LICENSE.txt
  • SKILL.md

Code review

Finds actionable defects in a change by comparing requirements, surrounding code and concrete user consequences.

code-review

Included files 2
  • LICENSE.txt
  • SKILL.md

Risk-based test planning

Allocates test effort according to the impact and likelihood of what a change could break.

risk-based-testing

Included files 2
  • LICENSE.txt
  • SKILL.md

End-to-end user flow tests

Verifies critical journeys in a real browser against a controlled test system with observable outcomes.

e2e-testing

Included files 2
  • LICENSE.txt
  • SKILL.md

API contract testing

Verifies the request, response and side-effect contracts that API callers rely on, including authorization and webhook replay behavior.

api-testing

Included files 2
  • LICENSE.txt
  • SKILL.md

Authorization testing

Proves forbidden operations fail through direct requests, indirect data paths and realistic multi-user permission scenarios.

authorization-testing

Included files 2
  • LICENSE.txt
  • SKILL.md

Debug concurrent data changes

Finds why concurrent requests lose updates, create duplicates or violate business invariants.

data-concurrency-debugging

Included files 2
  • LICENSE.txt
  • SKILL.md

Operational observability

Connects logs, metrics and traces to concrete questions about failures, performance and user impact.

observability

Included files 2
  • LICENSE.txt
  • SKILL.md

Accessible interfaces

Helps people use your interface with a keyboard or screen reader, with readable contrast, clear labels and understandable error messages.

web-accessibility

Included files 1
  • SKILL.md

Bug evidence intake

Organizes incoming bug evidence into reported claims, observations and testable hypotheses before asking for missing context.

bug-intake-evidence-analysis

Included files 1
  • SKILL.md

Discover hidden environment state

Finds the missing preconditions behind failures that differ between machines, accounts, builds or persisted states.

environment-state-discovery

Included files 1
  • SKILL.md

Minimal failure reproduction

Isolates the smallest faithful cause of a failure by systematically reducing the data, steps and configuration that trigger it.

minimal-reproduction-delta-debugging

Included files 1
  • SKILL.md

Executable bug reproductions

Turns a bug report into a self-contained test that fails for the real defect and can protect its fix afterward.

executable-reproduction-tests

Included files 1
  • SKILL.md

Reproduction handoff

Packages a minimal executable failure case with enough context for another specialist to continue without repeating intake.

reproduction-reporting-handoff

Included files 1
  • SKILL.md

Reproduce browser and network bugs

Recreates frontend failures through controlled navigation, storage state and network ordering rather than unreliable manual repetition.

browser-network-reproduction

Included files 1
  • SKILL.md

Minimal API reproductions

Turns a complex backend failure into a small reproducible request and synthetic dataset without exposing real customer information.

api-data-fixture-reproduction

Included files 1
  • SKILL.md

Reproducing race conditions

Makes timing-sensitive failures repeatable by controlling the moments where requests, transactions or asynchronous results overlap.

concurrency-timing-reproduction

Included files 1
  • SKILL.md

Isolate version regressions

Locates the first code revision that reproduces a specific failure using verified good and bad endpoints.

version-regression-isolation

Included files 1
  • SKILL.md

Reproduce desktop and mobile bugs

Isolates native-app failures caused by lifecycle transitions, packaging differences and changing OS permissions.

desktop-mobile-reproduction

Included files 1
  • SKILL.md

Business project foundations

Helps choose a reusable application foundation by comparing actual workflow fit, ownership effort and alternatives to building from scratch.

business-project-foundations

Included files 4
  • SKILL.md
  • references/README.md
  • references/adoption-checklist.md
  • references/repositories.json

Architecture planning

Shapes the smallest viable architecture around measurable requirements, explicit data ownership and the operational trade-offs your team faces.

architecture-planning

Included files 2
  • LICENSE.txt
  • SKILL.md

Backend implementation

Implements server behavior in tested, coherent increments that preserve business rules, transaction integrity and visible failure states.

backend-implementation

Included files 2
  • LICENSE.txt
  • SKILL.md

Recoverable database migrations

Plans schema changes that preserve data and allow old and new application versions to coexist during transition.

database-migrations

Included files 2
  • LICENSE.txt
  • SKILL.md

Connect systems and services

Connects your application to other systems. Defines how they exchange data, handle errors and recover when a service is temporarily unavailable.

api-integration

Included files 2
  • LICENSE.txt
  • SKILL.md

Reliable background jobs

Makes queued work safe to repeat and recover by treating duplicate delivery and partial completion as normal operational cases.

background-jobs

Included files 2
  • LICENSE.txt
  • SKILL.md

Safe legacy refactoring

Restructures legacy code in focused steps while recording current behavior and keeping intentional changes distinct from accidental regressions.

legacy-refactoring

Included files 2
  • LICENSE.txt
  • SKILL.md

Secure application development

Checks how your application handles sign-ins, forms, uploads and sensitive data. Helps prevent malicious input and unintended data exposure.

secure-coding

Included files 2
  • LICENSE.txt
  • SKILL.md

Requirements and acceptance review

Checks whether a complete user journey has clear, consistent and testable expected behavior.

requirements-acceptance-review

Included files 1
  • SKILL.md

Risk-based exploratory testing

Explores high-impact workflows with targeted questions and adapts testing when unexpected behavior appears.

risk-based-exploratory-testing

Included files 1
  • SKILL.md

Edge cases and transitions

Finds behavior gaps at input boundaries, interruptions and interactions between otherwise working features.

edge-cases-state-transitions

Included files 1
  • SKILL.md

Evidence-based QA reports

Produces release-relevant QA findings that separate verified defects, uncertain requirements and coverage limitations with evidence and appropriate severity.

bug-evidence-qa-reporting

Included files 1
  • SKILL.md

Verify fixes and nearby regressions

Replays the original failure and checks directly related cases to confirm a fix addresses its cause.

fix-verification-targeted-regression

Included files 1
  • SKILL.md

Browser and device QA

Verifies responsive layouts and real interactions across specified browser sizes, input methods and navigation states.

browser-cross-device-qa

Included files 1
  • SKILL.md

API integration checks

Tests service boundaries with invalid input, overlapping requests and partial outages to reveal inconsistent or duplicated outcomes.

api-integration-qa

Included files 1
  • SKILL.md

Role and permission scenarios

Tests permissions across personas, record ownership and membership changes, including indirect data surfaces.

roles-permission-scenarios

Included files 1
  • SKILL.md

Workflow data consistency

Checks that lifecycle changes agree across lists, details, events and persistent state, including partial failures.

data-workflow-consistency

Included files 1
  • SKILL.md

Technical research for QA

Checks version-matched primary sources so tests distinguish application defects from documented platform behavior.

technical-research-for-qa

Included files 1
  • SKILL.md

Fact-check documentation

Aligns documentation claims with current repository behavior while separating plans and historical decisions.

doc-fact-checking

Included files 2
  • LICENSE.txt
  • SKILL.md

Developer documentation

Explains software in the document form readers need, connecting accurate technical facts to executable tasks and verification.

developer-documentation

Included files 2
  • LICENSE.txt
  • SKILL.md

API documentation

Explains how to call real endpoints and handle their permissions, responses, side effects and integration failures correctly.

api-documentation

Included files 2
  • LICENSE.txt
  • SKILL.md

Architecture and decision records

Explains real system boundaries and the reasons behind consequential technical choices in maintainable documentation.

documentation-and-adrs

Included files 2
  • LICENSE.txt
  • SKILL.md

Developer onboarding

Creates a repository-grounded path from a fresh development machine to the first successful application run and test.

developer-onboarding

Included files 2
  • LICENSE.txt
  • SKILL.md

Runbooks and troubleshooting

Writes symptom-led operational guidance with safe diagnosis, explicit recovery scope and observable verification.

runbooks-troubleshooting

Included files 2
  • LICENSE.txt
  • SKILL.md

Migration and release notes

Explains user-visible changes and exact upgrade steps with examples, compatibility limits and recovery consequences.

migration-release-notes

Included files 2
  • LICENSE.txt
  • SKILL.md

Documentation blueprint

Assigns verified project knowledge a clear home while preserving an existing documentation structure.

documentation-blueprint

Included files 1
  • SKILL.md

Business goal alignment

Checks whether proposed work serves a documented user outcome and suggests a proportionate alternative when technical scope grows beyond it.

business-goal-alignment

Included files 1
  • SKILL.md

Scope and acceptance criteria

Defines a finite complete task and keeps optional enhancements from silently expanding implementation.

scope-control-acceptance-criteria

Included files 1
  • SKILL.md

Engineering simplicity review

Finds unnecessary layers and speculative generalization while preserving essential correctness, security and recovery behavior.

engineering-simplicity-review

Included files 1
  • SKILL.md

Smallest complete solution

Finds a narrow end-to-end solution that reuses existing capabilities while retaining the quality needed for everyday operation.

minimal-complete-solution-design

Included files 1
  • SKILL.md

Compare engineering options

Helps choose between realistic solutions by considering development effort, ongoing maintenance and the consequences of changing course later.

trade-off-lifecycle-cost-analysis

Included files 1
  • SKILL.md

Scope technical experiments

Defines a small time-bounded experiment when an important decision depends on a genuinely unknown technical fact.

technical-spike-scoping

Included files 1
  • SKILL.md

Refactoring value review

Evaluates whether restructuring removes a real obstacle to current work and keeps justified cleanup separate from speculative churn.

refactoring-value-review

Included files 1
  • SKILL.md

Delivery completion review

Determines whether delivery meets the accepted goal and distinguishes genuine completion blockers from optional future polish.

delivery-closure-review

Included files 1
  • SKILL.md

Workflows 1

  • Bug fix

Requirements

  • Orqestria installed on your computer.
  • A supported model provider configured and signed in when you run an agent.