---
title: Healer
slug: healer
type: system
created: 2026-06-17
updated: 2026-06-17
status: active
tags:
  - diagnosis
  - repair-loop
  - observability
sources:
  - dan-shapiro-you-dont-write-code-2026-02-13
  - jleechanorg-dark-factory-repo
related:
  - cxdb
  - dark-factory
  - agentic-pipeline-runner
confidence: medium-high
contradictions:
  - Repair loops reduce human debugging burden, but a wrong diagnosis can send agents into repeated ineffective fixes.
bead_refs:
  - dark-factory-rr4
---

# Healer

Healer is the diagnosis and repair-support system layered on top of [[cxdb]]. In the dark-factory repository, `df-healer` clusters failures from the event log into actionable diagnoses.

## Role

- Inspect failed runs after gates or execution errors.
- Cluster similar failures so repeated breakages are visible.
- Produce a diagnosis artifact that can feed the next fix loop.

## Design Implication

`inference:` Automated repair requires structured failure memory. A healer is the factory equivalent of an engineer reading CI logs across many attempts.