Agent Plugins Marketplace
← All plugins

debt-ops

v0.10.0

Every shortcut your coding agent takes, saved to your repo as it happens. Fix them when you're ready.

Codex4 Skills

By Brandin CanfieldLicense: MIT1.1k GitHub starsUpdated 12 hours ago

Directory evidence

Runtimes
Codex
Parsed components
4 skill or MCP entries
Source updated
Sep 23, 2026
Manifest status
Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install debt-ops for Codex

Installs for the current user
codex plugin marketplace add hashgraph-online/awesome-codex-plugins
codex plugin marketplace upgrade awesome-codex-plugins
codex plugin add debt-ops@awesome-codex-plugins

Paste and run these commands in a terminal with Codex. They add and refresh the awesome-codex-plugins catalog, then install this plugin.

Compatibility: the page URL and API slug “debt-ops” remain stable.

  • Codex: debt-ops@agent-plugin-marketplace → debt-ops@awesome-codex-plugins

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually
git clone https://github.com/hashgraph-online/awesome-codex-plugins

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/bcanfield/agentic-tech-debt/.

Plugin files

plugins/bcanfield/agentic-tech-debt/
├── .codex-plugin/plugin.json
├── skills/add/SKILL.md
├── skills/init/SKILL.md
├── skills/metrics/SKILL.md
└── skills/review/SKILL.md

Included Skills4

addskills/add/SKILL.md

Register a deferred decision in the debt registry. Trigger by judgment, not a marker scan, whenever a future reader would ask "why this way?": an unmade decision, stub, loosened type, bypassed check, swallowed error, a default picked "for now", or a TODO/FIXME/HACK/XXX marker. Trigger immediately whenever you defer work, or when the user invokes $add. Over-register freely; the developer drops with "drop A", "drop A,C", or "drop all".

initskills/init/SKILL.md

Write or refresh the "## Tech debt operations" section in AGENTS.md so a team shares one source of truth for debt-ops disciplines and cached quality commands. Idempotent. Only the managed section changes; other sections are untouched. Invoke explicitly via $init (solo users get the same content from the SessionStart inject).

metricsskills/metrics/SKILL.md

Print a debt-ops health summary from the metrics log, covering registration rate, hook feedback action rate, ADR creation, and AI-authored share. Use when the user asks for "debt-ops metrics", "debt health", "registry stats", or invokes $metrics. Read-only, never writes the log.

reviewskills/review/SKILL.md

Audit the debt registry, rank survivors by churn × Fowler quadrant, surface a top-N list, then walk paydown on user follow-up. Use when the user asks to review debt, see what to pay down, work through entries, or invokes $review. Stale entries drop with "drop A,B,C".

Plugin manifests1

plugins/bcanfield/agentic-tech-debt/.codex-plugin/plugin.json
{
  "name": "debt-ops",
  "version": "0.10.0",
  "description": "Every shortcut your coding agent takes, saved to your repo as it happens. Fix them when you're ready.",
  "author": {
    "name": "Brandin Canfield",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/bcanfield/agentic-tech-debt",
  "repository": "https://github.com/bcanfield/agentic-tech-debt",
  "license": "MIT",
  "keywords": [
    "tech-debt",
    "code-health",
    "hotspots",
    "adr",
    "productivity"
  ],
  "skills": "./skills/",
  "hooks": "./hooks/hooks.json",
  "interface": {
    "displayName": "debt-ops",
    "shortDescription": "Catches AI-introduced tech debt at write-time",
    "longDescription": "Every \"I'll fix this later,\" shortcut, and punt your AI agent writes lands in a folder in your repo. Architectural calls get a short ADR. When you're ready to clean up, a review skill ranks the backlog by how often each file changes, so you pay down the debt that actually hurts first. Plain Python, fully local, no network calls.",
    "developerName": "Brandin Canfield",
    "category": "Coding",
    "composerIcon": "./assets/icon.svg",
    "brandColor": "#d97757"
  }
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[debt-ops on Agent Plugins Marketplace](https://pluginsmp.com/plugins/debt-ops)