القائمة
Use when the user says "razorback debt", "harvesting-debt", "debt ledger", "what did we defer", "list the shortcuts", or "what did we mark to do later" — any request to account for deliberate shortcuts marked with `razorback:` comments.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Use when the user says "ask grok", "get grok's take", "grok review", "have grok look at this", "delegate to grok", or any variation naming Grok/xAI as the perspective they want.
Use when starting any creative work - creating a feature, building a component, adding functionality, or changing designed behavior - before writing code or invoking any implementation skill. Small defect repairs and tweaks triage through razorback:fixing-small-issues first.
Use when a design question resists discussion — a state model with more edge cases than fit in your head, a UI the user keeps flip-flopping on because nobody can picture it, or behavior only knowable by running it — before writing a design doc or implementation plan for that question.
Use when the user says "ask claude", "fresh claude review", "second opinion from another claude", "have another claude look at this", "delegate to a fresh claude", or any variation naming Claude as the second perspective they want.
Use when the user says "ask codex", "get codex's take", "codex review", "have codex look at this", "delegate to codex", or any variation naming Codex/OpenAI as the perspective they want. Also use for a generic "second opinion from a different model" when no other model is named.
Use when planning or reviewing non-trivial code changes, refactoring architecture, evaluating module boundaries, repeated findings reveal coupling, tests are hard to write because interfaces are unclear, or the user asks for codebase design improvements, complexity reduction, deduplication, or cleanup of existing code.
استنادا إلى تصنيف SOC المهني
| name | harvesting-debt |
| description | Use when the user says "razorback debt", "harvesting-debt", "debt ledger", "what did we defer", "list the shortcuts", or "what did we mark to do later" — any request to account for deliberate shortcuts marked with `razorback:` comments. |
A deliberate shortcut is fine. An unmarked deliberate shortcut is how a known ceiling turns into an unknown outage. Every deliberate corner cut — most often on the razorback:fixing-small-issues quick-fix tier — is marked with a comment naming its ceiling and the trigger to revisit it. This skill collects those markers into one ledger so a deferral can't quietly become permanent.
The convention:
# razorback: <ceiling>, <upgrade trigger>
Use // instead of # in C-family languages (JS/TS, C, C++, C#, Java, Go, Rust,
Swift). Example: # razorback: global lock, per-account locks if throughput matters.
Announce at start: "I'm using the harvesting-debt skill to build the debt ledger."
Search the indexed workspace with Miller first:
search(query='razorback:', regions=comment)
regions=comment restricts hits to comment regions, which is where the markers
live — it does the "keep only real markers" filtering for you. Note that
mode=markers does not apply here: it audits a fixed vocabulary (TODO, FIXME,
HACK, XXX) and rejects any other query, including razorback:.
Text fallback — search(query='razorback:', mode=text) searches every region.
Use it when a marker sits somewhere regions=comment cannot see it (the marker
string in prose or docs, or a language whose comments the index does not region-tag).
It returns razorback's own skill cross-references (razorback:<skill-name> in prose)
too, so keep only hits that are comment markers (# razorback: / // razorback:).
Miller's index already excludes vendored, generated, and tool-state content, and returns ranked hits with file:line — no exclusion flags needed.
Grep fallback (Miller unavailable or index stale after workspace refresh):
grep -rnIE '(#|//) ?razorback:' .
-I skips binary files — without it, any binary whose bytes happen to match
(including Miller's own index) prints a useless Binary file … matches row.
Full form with exclusions:
grep -rnIE '(#|//) ?razorback:' . \
--exclude-dir=node_modules --exclude-dir=.git \
--exclude-dir=dist --exclude-dir=build --exclude-dir=target --exclude-dir=out \
--exclude-dir=skills --exclude-dir=docs --exclude-dir=commands \
--exclude-dir=agents --exclude-dir=.memories \
--exclude-dir=.miller --exclude-dir=.razorback --exclude-dir=.claude
The skills//docs//commands//agents//.memories/ exclusions matter only
in the razorback repo itself, where prose skill cross-references
(razorback:<skill-name>) would flood the ledger; the rest cut vendored, build,
and tool-state noise (.miller/, .razorback/, .claude/ quote markers in
reports or index the marker bytes).
Add comment prefixes your stack uses (--, ;, %) if the codebase needs them.
Each surviving hit is one ledger row.
One row per marker, grouped by file:
<file>:<line>, <what was simplified>. ceiling: <the limit named>. upgrade: <the trigger to revisit>.
The convention is # razorback: <ceiling>, <upgrade trigger>, so pull the ceiling
and the trigger straight from the comment — do not invent either. Want an owner per
row? add git blame -L<line>,<line> -- <file>.
Flag the rot risk: any marker that names no upgrade trigger gets a no-trigger
tag. Those are the ones that silently rot — a ceiling with no trigger to revisit it
is a permanent decision that nobody agreed to make.
End with <N> markers, <M> with no trigger.
Nothing found: No razorback: debt markers. Clean ledger.
RAZORBACK-DEBT.md).Paying a marker down is a separate change: it re-enters razorback:fixing-small-issues triage (or the standard flow) on its own merits.