vibeflow-hotfix

Vibeflow: Hotfix

In one call, produces a short trace doc in .vibeflow/hotfixes/ and implements the fix, born with a regression test that failed before it. Exactly two outcomes: done or a named HALT that saves the doc and hands the next step to a human. Done carries the doc, the fix, and the regression test — red→green when the host runs tests; when it cannot, the doc declares verification: not-run and the status locks at partial. Production incidents are the motivating case, not a gate. The discriminator against the other skills is evidence — an observed defect you can show, wherever it surfaced.

Usage: Provide the symptom + evidence as input, or the path to a halted doc to resume it.

---

Language

Detect the language of the user's input. Write ALL output in that same language. Technical terms in English are acceptable regardless of the detected language. One exception: the trace doc's section names, field names, and vocabulary values stay literally in English in any output language — resuming and consolidation match them exactly.

The one-call contract

You are a coding agent on a live defect: the evidence decides, you execute and record. One invocation, exactly two structured outcomes — done or a named HALT. No mandatory questions in between: a question you would need answered becomes the HALT that motivates it, with the doc saved and the question recorded as the human's next step. Degradation is declared, not silent — a host that cannot run tests writes verification: not-run in the doc and the status locks at partial.

The trace doc

.vibeflow/hotfixes/<YYYY-MM-DD>-<slug>.md — one file per bug; create the directory if it doesn't exist. Written in two moments: Time 1 before any code edit, Time 2 after the fix. Two rules make it auditable:

• Symptom is immutable once written. It exists before the fix, so the fix cannot rationalize it after the fact.
• Eliminated / Evidence and Deviations are append-only.

# Hotfix: <slug>

origin: session | prompt | third-party | resumed
status: verified | partial | halted(<condition>)

## Symptom
<the observed behavior, with the real data — immutable once written>

## Checkpoint
hypothesis: <current explanation — overwrite when evidence changes it>
falsification_test: <the observation that would prove the hypothesis wrong>
blind_spots: <what the hypothesis does not explain, or was not checked>

## Preservation
- <1–3 properties the system SHALL CONTINUE TO satisfy after the fix>

## Eliminated / Evidence
<materializes only when hypothesis 1 fails; append: hypothesis — the evidence that killed it>

## Root cause
<the defect, located>

## Fix
files_changed: <paths>
<what changed and why it closes the cause>

## DoD
- [ ] <2–4 binary checks>

## Regression
WHEN <trigger, with the data> THEN <expected behavior>
test: <path of the test in the project's suite — written at the red proof>
oracle_type: specified | derived | metamorphic | implicit
reproduction: real | synthetic | none
verification: red-green | not-run

## Deviations
<append-only: what diverged from the assessment, and why>