ledgerwerk

Overview

Repairledger is a Python CLI and agent skill for durable repair observations. A repair observation records an agent-discovered tool failure, validation false positive, unclear command contract, missing documentation, skill gap, workflow pain point, or concrete improvement opportunity.

The primary user is a coding agent working on another task. The agent can log an observation quickly, continue the primary task, then export a maintainer-facing Markdown report from the workspace root.

Key concepts

  • Repair observation: A structured record describing a failure, gap, or improvement.

  • Component: A modular Markdown file within a repair (e.g., summary, reproduction, suggested fix).

  • Version snapshot: A complete copy of a repair after every mutation.

  • Rendered artifact: A standalone Markdown document with YAML front matter.

  • Aggregate report: A workspace-root Markdown report covering all active observations.