← Back to workflows

WORKFLOW 02 / 05

Diagnose

Reproduce a failure, find its root cause, then repair when authorized.

READ-ONLY → REPAIR

Core idea

Reproduce first, locate second, repair last. Every step is backed by command-observed evidence — never guesswork.

How it runs

Human approval required
  1. 01
    Pin the symptom

    State the expected versus actual behavior, then build the fastest, most deterministic reproduction signal.

  2. 02
    Minimize & locate

    Observe the failure with your own eyes first, then strip it down — test one falsifiable hypothesis at a time.

  3. 03
    Repair when authorizedHuman approval required

    After authorization, the first write must be a regression test. Watch it fail (red) before any production code may change (green).

  4. 04
    Harden the root cause

    Add only the adjacent cases that prevent the same class of regression — never grow a fix into a redesign.

  5. 05
    Complete

    Re-verify the original symptom and report the root cause, evidence, fix, and remaining uncertainty.

Key mechanisms

Read-only until authorized

No file changes before explicit repair authorization. If you reject the conclusion, it stays read-only and tests a new hypothesis.

Red before green

The first write after authorization is the regression test, and its failure must be observed. No probe or workaround can bypass this gate.

One hypothesis at a time

Each observation is chosen to distinguish between hypotheses — never change two variables at once.