debt-ops

Catches AI-introduced tech debt at write-time: hooks log every deferral to a registry in your repo and a review skill ranks paydown by file churn.

brandin-canfield/debt-ops · v0.10.0 · Development & Workflow

Brandin Canfieldcaution

Install Source Claim this plugin

66 Follow0

Trust Score

Security

Surfaces

What is debt-ops?

debt-ops is a published development & workflow plugin for AI coding agents in the codex ecosystem, developed by Brandin Canfield and distributed through the HOL AI plugin registry. Catches AI-introduced tech debt at write-time: hooks log every deferral to a registry in your repo and a review skill ranks paydown by file churn.

Canonical slug: brandin-canfield/debt-ops
Version: v0.10.0 · updated Sep 20, 2026
Open data: entity.json (JSON-LD)

Trust & Reputation

HOL Trust Score

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability

64pts

Maintenance

30pts

MCP Posture

100pts

Plugin Security

59pts

Provenance

70pts

Publisher Quality

75pts

Registry Snapshot

Repository: https://github.com/bcanfield/agentic-tech-debt
Homepage: https://github.com/bcanfield/agentic-tech-debt
Canonical profile: https://hol.org/registry/plugins/brandin-canfield%2Fdebt-ops
Publisher verification: No
Marketplace source: Unknown
Scanner: Broker fallback
Safety label: caution
Digest verified: Yes

4 bundled skills — copy or download SKILL.mdOpen skills

Trust & reputation

Trust & Reputation

HOL Trust Score

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability

64pts

Maintenance

30pts

MCP Posture

100pts

Plugin Security

59pts

Provenance

70pts

Publisher Quality

75pts

Provenance

Plugin root: codex
Source repo: https://github.com/bcanfield/agentic-tech-debt
Source commit: e274bc3d4fa0…
Publisher verified: No
Owner verified: Not owner verified

Continuous scanner CI detected

No action is required. This plugin receives the full trust score.

Verified badge not detected

Add the HOL verified badge to the repository README to score +2% trust. Plugin owners can open that pull request from Guard Plugins.

Security Posture

caution

Safety label

Security score

High findings

Provider: registry-broker-fallback
Grade: F · caution
Version: Unknown

cisco-skill-scanner: unknown

Findings

mediumpublishabilitypublishability.link.missing.websiteURL

websiteURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.privacyPolicyURL

privacyPolicyURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.termsOfServiceURL

termsOfServiceURL should be present for marketplace readiness.

lowoperational-securitysupply-chain.lockfile-missing

Repository snapshot does not include a lockfile.

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

debt-ops — Frequently asked questions

What is debt-ops?: debt-ops is an AI plugin in the HOL registry. Catches AI-introduced tech debt at write-time: hooks log every deferral to a registry in your repo and a review skill ranks paydown by file churn.
How do I install debt-ops?: Install debt-ops in your harness: Codex — codex plugin marketplace add bcanfield/agentic-tech-debt; Any agent — npx skills add bcanfield/agentic-tech-debt. Full step-by-step guidance is on the HOL plugin page.
How do I install debt-ops in Codex?: To install debt-ops in Codex, start with codex plugin marketplace add bcanfield/agentic-tech-debt. The complete step-by-step install guide for Codex is on the HOL plugin page.
Is debt-ops free?: Pricing for debt-ops is published on its HOL plugin page when the maker schedules a launch.
Who publishes debt-ops?: debt-ops is published by Brandin Canfield and listed on HOL.
Is debt-ops available now?: debt-ops availability is listed on its HOL plugin page.

Install Guidance

Install in Codex

Install through the Codex CLI plugin marketplace.

Codex plugin docs

1
Register the marketplace
Run in any terminal. Codex reads the marketplace entry from .agents/plugins/marketplace.json (or the legacy .claude-plugin path) in the repository. If the repository ships none, add the generated entry from the Advanced section below first.
shell
2
Install from the Plugins browser
Open Codex, open the Plugins browser, choose the agentic-tech-debt marketplace, and install debt-ops.
3
Verify the marketplace registration
shell

Plugin Manifest

{
  "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": "./",
  "hooks": "./hooks/hooks.json",
  "interface": {
    "displayName": "debt-ops",
    "developerName": "Brandin Canfield",
    "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.",
    "category": "Coding",
    "composerIcon": "./assets/icon.svg",
    "brandColor": "#d97757"
  },
  "registryIndexVersion": 5
}

Marketplace Source

Repo URL: https://github.com/bcanfield/agentic-tech-debt
Marketplace path: Unknown
Source path: plugins/bcanfield/agentic-tech-debt
Install policy: AVAILABLE

Skills

4 SKILL.md files ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

skills-cli

add
skills/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".
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
init
skills/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).
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
metrics
skills/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.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
review
skills/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".
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

File Inventory

.codex-plugin/plugin.json

plugin-manifest

1,078 bytes

98b0f36812f830dc…

assets/icon.svg

asset

566 bytes

c6f67dad9a409aa2…

hooks/drop.py

file

5,903 bytes

9097835ee2c82278…

hooks/feedback.py

file

12,545 bytes

8fb246d5394fd46e…

hooks/hooks.json

file

915 bytes

21f3a4d78dc8dc64…

hooks/session-start.py

file

14,884 bytes

763b0e81242f52ca…

hooks/stop.py

file

15,095 bytes

7db420809d5665b6…

README.md

file

2,967 bytes

07a9cf92fe756b94…

skills/add/scripts/register.py

skill

6,384 bytes

a3c9832e621a6a7f…

skills/add/SKILL.md

skill

3,507 bytes

46f0a9ef8acb8a8e…

skills/init/agents/openai.yaml

skill

187 bytes

45668c177fb1a883…

skills/init/SKILL.md

skill

4,497 bytes

e03bb08e71f7b9ad…

skills/metrics/SKILL.md

skill

3,109 bytes

dc568b918541395b…

skills/review/scripts/review.py

skill

11,785 bytes

b49817172b1d051f…

skills/review/SKILL.md

skill

3,875 bytes

0879baa7d201aa86…

Product

AI tools

Extensions

Resources

AI Agents

Plugins

Extensions

Best Plugins

Security

Open Source

Points

Events

Standards

Tools

Library Docs

Resources

debt-ops

What is debt-ops?

Trust & Reputation

Factor Analysis

Registry Snapshot

Trust & reputation

Trust & Reputation

Factor Analysis

Provenance

Security Posture

Findings

debt-ops — Frequently asked questions

Install Guidance

Install in Codex

Plugin Manifest

Marketplace Source

Skills

File Inventory