Skip to main content
New aislop v0.9.4: four new Python rules from the SlopCodeBench paper, plus a CLI star prompt and GitHub Discussions. Read more →
ai-slop/todo-stub manual fix

Orphan TODO stub.

A `// TODO` without an owner, ticket, or completion plan. The kind that survives years.

Bad — what an agent ships
// TODO: handle the retry case
return result
Good — what aislop hands back
// TODO(#1234): retry on 503 with exponential backoff — currently fail-fast
return result

// or just finish it now:
return retry(() => fetch(url), { retries: 3, backoff: 'exp' })

Agents punt hard cases under a comment and move on. Ungated TODOs accumulate forever; nobody knows whether they're still relevant or already irrelevant.

How this rule is justified.

Rule id

ai-slop/todo-stub

Enforcing engine

ai-slop

Detector strategy

Deterministic regex match: flags TODO/FIXME comments with no owner, ticket reference, or completion plan.

Legitimate code that is NOT flagged

A TODO that carries an owner or ticket reference (e.g. `TODO(#1234)`) is not flagged.

Evidence

Provenance: repeated across public scans as accumulated, ungated deferrals.