bcanfield/agentic-tech-debt

6 stars · Last commit 2026-06-07

AI Plugin & Agent Skills to catch tech debt as it's written. Works with any agent. Any codebase. Backed by two decades of research.

README preview

# debt-ops

**Catches AI-introduced tech debt at write-time**

*Works with [any coding agent](#install). Any stack.*

*Two decades of tech-debt research, distilled into a plugin and validated across dozens of codebases.*

<img src="./demo/debt-ops.gif" width="720" alt="debt-ops in Claude Code: the agent edits api/checkout.ts and casts a value to `as any` to clear a type error; debt-ops catches the loosened type at write-time and logs +1 entry: as-any-checkout-payload (A)" />

[![MIT License](https://img.shields.io/github/license/bcanfield/agentic-tech-debt?color=blue)](./LICENSE)
[![Claude Code plugin](https://img.shields.io/badge/Claude%20Code-plugin-d97757?logo=claude&logoColor=white)](#install)

## What it does

- **Tracks the debt** — every "I'll fix this later," shortcut, and punt your agent writes lands in a folder in your repo.
- **Records the decisions** — a short ADR when your agent makes an architectural call.
- **Works quietly in the loop** — reads what's already logged, ranks cleanup by hotspot, and surfaces failures before they hit your diff.

---

View full repository on GitHub →