kintsugi

What problem does it solve?

It exposes and documents the missing “why” behind workarounds, defensive patterns, and other past repairs so future developers don’t repeat the same mistakes.

Core Features & Use Cases

• Scar discovery via git + code patterns: scans commit history and code to identify workaround, guard, magic-value, regression-test, pin, reverted-pattern, silent-migration, and config-override scars.
• Gold audit (🥇/🥈/⬜ visibility grading): evaluates how well each repair is documented, with evidence-based reconstruction when context is incomplete.
• Gilding backlog that prioritizes fixes: produces a capped, PR-sized set of documentation improvements (comments, ADRs, test annotations, changelog entries) to restore repair legibility.
• Health scoring and prevention compass: summarizes overall documentation health and highlights missing process hygiene (templates, incident links, naming conventions, pin discipline).

Quick Start

Run the kintsugi skill against your codebase to generate a repair-visibility report and a prioritized gilding backlog for the most bare or partially documented scars.