Technical Debt
Operations
research [scope]: inspect the requested scope, defaulting to turbo/, and
report verified findings. This operation is read-only.
issue [report]: create an English GitHub issue from current, verified
findings. If no report exists, research first. Create or comment on an issue
only when the caller requested that operation.
The tech-debt-research and tech-debt-issue commands remain aliases for these
operations. A report is evidence at its recorded revision, not a standing
instruction to change code.
Research
- Record the repository, HEAD, scope, and date. Read
code quality and use
the index for the affected surfaces.
- Use
rg to find candidates and inspect matching files and consumers. Exclude
dependencies, generated/vendor content, and historical migrations from
generic cleanup recommendations. Preserve permanent migration records.
- Check type/lint suppressions, dynamic imports, environment configuration,
error handling, fallback ownership, and unused dependencies against actual
contracts. Use testing guidance for tests and
ccstate guidance for signal/React code.
- Validate each candidate. File length, a relative import, a
catch, or an
ESLint off / Oxlint allow setting is not proof of a defect. Read override
scope, replacement enforcement, generated-code boundaries, and documented
exceptions. In particular, do not replace every floating promise with
detach() or assume every parentless resetSignal() leaks.
- Report the concrete consequence, file/line, applicable rule, evidence,
proposed remedy, and uncertainty. Use severity based on demonstrated impact.
Distinguish static inspection from executable or production verification.
Keep the report proportional to the findings: scope and revision, confirmed
issues, dismissed candidates when useful, and next actions. Save detailed
evidence when it is too long for the response. Do not invent schedules or effort
estimates from match counts.
Issue
Recheck the report against current source and existing issues before posting.
Use an English title describing the concrete problem; include affected paths,
evidence, impact, and actionable acceptance criteria in the body. Use only
existing relevant labels and include source links pinned to the inspected SHA.
Write the body to a temporary file and pass gh issue create --repo vm0-ai/vm0 --body-file <file> the exact Markdown. Keep the report focused enough to fit one
issue; add detailed comments only when needed for the requested tracking task.
Verify the created issue and return its URL. If posting fails, retain the report
and state which action failed.
1---2name: tech-debt3description: Research repository technical debt or create an issue from verified findings when requested4context: fork5metadata:6 source: https://skillmd.com/skills/vm0-ai/tech-debt7---89# Technical Debt1011## Operations1213- `research [scope]`: inspect the requested scope, defaulting to `turbo/`, and14 report verified findings. This operation is read-only.15- `issue [report]`: create an English GitHub issue from current, verified16 findings. If no report exists, research first. Create or comment on an issue17 only when the caller requested that operation.1819The `tech-debt-research` and `tech-debt-issue` commands remain aliases for these20operations. A report is evidence at its recorded revision, not a standing21instruction to change code.2223## Research24251. Record the repository, HEAD, scope, and date. Read26 [code quality](../../../docs/bad-smell.md) and use27 [the index](../../../docs/docs.md) for the affected surfaces.282. Use `rg` to find candidates and inspect matching files and consumers. Exclude29 dependencies, generated/vendor content, and historical migrations from30 generic cleanup recommendations. Preserve permanent migration records.313. Check type/lint suppressions, dynamic imports, environment configuration,32 error handling, fallback ownership, and unused dependencies against actual33 contracts. Use [testing guidance](../../../docs/testing.md) for tests and34 [ccstate guidance](../ccstate/SKILL.md) for signal/React code.354. Validate each candidate. File length, a relative import, a `catch`, or an36 ESLint `off` / Oxlint `allow` setting is not proof of a defect. Read override37 scope, replacement enforcement, generated-code boundaries, and documented38 exceptions. In particular, do not replace every floating promise with39 `detach()` or assume every parentless `resetSignal()` leaks.405. Report the concrete consequence, file/line, applicable rule, evidence,41 proposed remedy, and uncertainty. Use severity based on demonstrated impact.42 Distinguish static inspection from executable or production verification.4344Keep the report proportional to the findings: scope and revision, confirmed45issues, dismissed candidates when useful, and next actions. Save detailed46evidence when it is too long for the response. Do not invent schedules or effort47estimates from match counts.4849## Issue5051Recheck the report against current source and existing issues before posting.52Use an English title describing the concrete problem; include affected paths,53evidence, impact, and actionable acceptance criteria in the body. Use only54existing relevant labels and include source links pinned to the inspected SHA.5556Write the body to a temporary file and pass `gh issue create --repo vm0-ai/vm057--body-file <file>` the exact Markdown. Keep the report focused enough to fit one58issue; add detailed comments only when needed for the requested tracking task.59Verify the created issue and return its URL. If posting fails, retain the report60and state which action failed.