Track, categorize, and prioritize technical debt across the codebase. Scans for debt indicators, maintains a debt register, and recommends repayment scheduling.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
## Phase 1: Parse Subcommand
Determine the mode from the argument:
- `scan` — Scan the codebase for tech debt indicators
- `add` — Add a new tech debt entry manually
- `prioritize` — Re-prioritize the existing debt register
- `report` — Generate a summary report of current debt status
If no subcommand is provided, output usage and stop. Verdict: **FAIL** — missing required subcommand.
---
## Phase 2A: Scan Mode
Search the codebase for debt indicators:
- `TODO` comments (count and categorize)
- `FIXME` comments (these are bugs disguised as debt)
- `HACK` comments (workarounds that need proper solutions)
- `@deprecated` markers
- Duplicated code blocks (similar patterns in multiple files)
- Files over 500 lines (potential god objects)
- Functions over 50 lines (potential complexity)
Categorize each finding:
- **Architecture Debt**: Wrong abstractions, missing patterns, coupling issues
- **Code Quality Debt**: Duplication, complexity, naming, missing types
- **Test Debt**: Missing tests, flaky tests, untested edge cases
- **Documentation Debt**: Missing docs, outdated docs, undocumented APIs
- **Dependency Debt**: Outdated packages, deprecated APIs, version conflicts
…
The line at the top of this page pins the label git:20260621.096f040, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_qcarnghd2njk7yex
GET https://markdownregistry.com/api/v1/resolve?ref=striderza/opencodegamestudios/tech-debt
GET https://markdownregistry.com/api/v1/blob/e72e2f89b093e2f4842ebfb9b99a3f849f8671522f9f3ef3a03e5ae71cd66986
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
striderza/opencodegamestudios · .agents/modules/architecture/skills/architecture-review/SKILL.md · Validates completeness and consistency of the project architecture against all GDDs. Builds a traceability matrix…
striderza/opencodegamestudios · .agents/modules/architecture/skills/create-control-manifest/SKILL.md · After architecture is complete, produces a flat actionable rules sheet for programmers — what you must do, what you…
striderza/opencodegamestudios · .agents/modules/architecture/skills/propagate-design-change/SKILL.md · When a GDD is revised, scans all ADRs and the traceability index to identify which architectural decisions are now…
striderza/opencodegamestudios · .agents/modules/art/skills/art-bible/SKILL.md · Guided, section-by-section Art Bible authoring. Creates the visual identity specification that gates all asset…
striderza/opencodegamestudios · .agents/modules/art/skills/art-generate/SKILL.md · Generates placeholder .aseprite files from asset specs using the Aseprite MCP. Reads asset specs and art bible, creates…
striderza/opencodegamestudios · .agents/modules/art/skills/asset-audit/SKILL.md · Audits game assets for compliance with naming conventions, file size budgets, format standards, and pipeline…
striderza/opencodegamestudios · .agents/modules/art/skills/asset-spec/SKILL.md · Generate per-asset visual specifications and AI generation prompts from GDDs, level docs, or character profiles…
striderza/opencodegamestudios · .agents/modules/core/skills/architecture-decision/SKILL.md · Creates an Architecture Decision Record (ADR) documenting a significant technical decision, its context, alternatives…
striderza/opencodegamestudios · .agents/modules/core/skills/concept-brainstorm/SKILL.md · Guided game concept ideation — from zero idea to a structured game concept document. Uses professional studio ideation…
striderza/opencodegamestudios · .agents/modules/core/skills/create-architecture/SKILL.md · Guided, section-by-section authoring of the master architecture document for the game. Reads all GDDs, the systems…
striderza/opencodegamestudios · .agents/modules/core/skills/gate-check/SKILL.md · Validate readiness to advance between development phases. Produces a PASS/CONCERNS/FAIL verdict with specific blockers…
secondsky/claude-skills · plugins/tech-debt/skills/tech-debt/SKILL.md · Use when reworking a change to prevent tech debt, or auditing existing debt to categorize, score, and prioritize the…
striderza/opencodegamestudios · .agents/modules/stories/skills/tech-debt/SKILL.md · Track, categorize, and prioritize technical debt across the codebase. Scans for debt indicators, maintains a debt…
qa-aman/claude-skills · skills/by-role/engineer/tech-debt/SKILL.md · Document and prioritize technical debt. Use when the user says "tech debt", "legacy code", "this code is a mess"…
furkantokkan/agent-foundry · plugins/agent-foundry/skills/tech-debt/SKILL.md · Track, categorize, and prioritize technical debt across the codebase. Scans for debt indicators, maintains a debt…
pantheon-org/tekhne · skills/project-mgmt/tech-debt/SKILL.md · Maintain docs/TECH_DEBT.md, the living list of code-level cleanup that isn't a risk, a shortcut, or an open decision…
