orch-fix-defect

Actor · action · target: orch · fix · defect. Thin wrapper over the shared
engine in orch-pipeline.

When to Use

• Something is broken: wrong output, an error, a crash, a regression.
• Distinguish from siblings:
• behavior is correct but you want it different → orch-change-feature.
• the capability does not exist yet → orch-add-feature.

Operation settings

• Default size floor: small (often trivial).
• Phase mask: 0 → (light 2 only if root cause is non-obvious or standard+) →

4 → 5 → 6. Research (1) is usually skipped.

• First move (phase 4): reproduce the bug as a new failing test

(regression test), then fix until it goes green. Proving the bug exists first
is what separates a fix from a tweak.

How It Works

1. Run the orch-pipeline engine with the settings above.
2. If the root cause is unclear, scope it with code-explorer before the red

test; escalate build breaks to build-error-resolver / /build-fix.

1. Stop at Gate 1 (only if a plan was produced) and Gate 2 (pre-commit).
2. Add security-reviewer if the defect sits in a security-sensitive path.

Example

orch-fix-defect: poller crashes on empty NWS response
→ write failing test reproducing the crash → fix to green
→ code-review → commit  [GATE 2: confirm]   (commit: fix:)