Tombstones: // removed X, "kept for backward compatibility", comments citing the task

Code nobody needs: one of the ways AI coding agents bloat software, from lessloc's pattern catalog. lessloc catches it as history.

What makes tombstones a bad practice?

The standard that calls it a bad practice: Clean Code C1 Inappropriate Information.

What does lessloc do about tombstones?

lessloc catches it as history.

• history (tier 3): Dates, change history or notes to the requester in comments.

Examples

Caught as history:

# Removed the old cache helper
x = 1
# no longer used, kept for backward compatibility
y = 2

Written well:

# The cache is per process: workers never share it
x = 1

Related patterns

The other patterns in Code nobody needs:

• Options, flags, parameters or config for needs nobody named: lessloc gives every session a rule against it and catches it as mode-flag.
• An interface or abstract class with one implementation: lessloc catches it as single-impl.
• Wrappers that only forward; barrel files that only re-export: lessloc catches it as wrapper.
• A new function or import that nothing calls or tests: lessloc catches it as unused (ruff adds unused variables).
• Obsolete code kept behind a guard or flag instead of deleted: lessloc gives every session the rule: delete what the change makes dead.
• Stubs and fake success: lessloc catches it as stub; it asks to finish the code or to tell the user what is not real yet.
• Placeholders: # ... existing code ..., "your code here": lessloc catches it as placeholder and refuses it before it lands.
• Commented-out code: lessloc catches it as commented-out and refuses it before it lands.
• Debug leftovers: lessloc catches it as debug-leftover.
• A demo __main__ block or demo folder nobody asked for: lessloc catches it as demo-code and new-folder.
• Hand-written boilerplate a language feature writes: lessloc catches it as simpler.
• A one-line helper used once: lessloc catches it as single-use.
• TODO and FIXME left behind: lessloc catches it as todo; it asks to finish the work, or to record known debt as shortcut: and tell the user.