Skip to content
Back to search

nofakedone

MarketplaceWorks with Claude CodeGitHub

Your coding agent said done. The diff says otherwise. A Claude Code Stop hook that blocks stubs, skipped tests, assert True and swallowed errors.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/07sharath03kumar-afk/nofakedone with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/07sharath03kumar-afk/nofakedone'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/07sharath03kumar-afk--nofakedone/badge.svg)](/listings/07sharath03kumar-afk--nofakedone)

HTML

<a href="/listings/07sharath03kumar-afk--nofakedone"><img src="/api/listings/07sharath03kumar-afk--nofakedone/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

As a Claude Code plugin (recommended)

/plugin marketplace add 07sharath03kumar-afk/nofakedone
/plugin install nofakedone@nofakedone

You get the Stop hook, the `nofakedone` skill and a `/nofakedone` command. Requires `python3` on your PATH.

As a CLI

curl -O https://raw.githubusercontent.com/07sharath03kumar-afk/nofakedone/main/scripts/nofakedone.py
python3 nofakedone.py                 # uncommitted changes
python3 nofakedone.py --base main     # whole branch
python3 nofakedone.py --json          # for scripts

Exit code `1` means blocking findings, so it drops straight into a pre-commit hook.

As a GitHub Action

- uses: actions/checkout@v4
  with: { fetch-depth: 0 }
- uses: 07sharath03kumar-afk/nofakedone@main
  with:
    base: origin/main

Agent-written pull requests get the same gate as agent sessions.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "nofakedone",
  3. "owner": { "name": "07sharath03kumar-afk" },
  4. "plugins": [
  5. {
  6. "name": "nofakedone",
  7. "source": "./",
  8. "description": "A Stop hook that blocks fake 'done': stubs, disabled tests, tautological asserts, swallowed errors, bypassed checks.",
  9. "version": "0.1.0"
  10. }
  11. ]
  12. }
README.md · README · 159 lines
  1. <div align="center">
  2. # nofakedone
  3. **Your coding agent said "done." The diff says otherwise.**
  4. A Claude Code plugin that audits every diff before the agent is allowed to stop, and sends it back to work
  5. when "finished" really means a stub, a skipped test, `assert True` or a swallowed error.
  6. [![ci](https://github.com/07sharath03kumar-afk/nofakedone/actions/workflows/ci.yml/badge.svg)](https://github.com/07sharath03kumar-afk/nofakedone/actions/workflows/ci.yml)
  7. [![release](https://img.shields.io/github/v/release/07sharath03kumar-afk/nofakedone)](https://github.com/07sharath03kumar-afk/nofakedone/releases)
  8. [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  9. ![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)
  10. Zero dependencies · one Python file · Python, JS/TS, Go, Rust, Java, Kotlin, C#, Ruby · also a CLI and a GitHub Action
  11. <img src="assets/demo.gif" alt="Claude claims all tests pass after stubbing a function and skipping a test; nofakedone blocks the stop with three findings; Claude then implements the function and restores the test" width="860">
  12. <sub>Staged session to show the flow; the rule names and checks are the real ones nofakedone runs.</sub>
  13. </div>
  14. ---
  15. ## The problem
  16. Coding agents are optimized to finish. When the real fix is hard, some of them make it *look* finished:
  17. ```diff
  18. def charge(user, amount):
  19. - return gateway.charge(user.card, amount)
  20. + raise NotImplementedError
  21. -def test_charge_declined():
  22. - assert charge(user, 0) is None
  23. +@pytest.mark.skip(reason="flaky")
  24. +def test_charge():
  25. + assert True
  26. ```
  27. The tests are green, the agent says **"All tests pass ✅"**, and you find out in production.
  28. Developers report this constantly: mocked tests that verify nothing, deleted assertions, `except: pass`,
  29. `--no-verify`, coverage thresholds quietly lowered.
  30. ## What nofakedone does
  31. It runs as a **Stop hook**. Each time Claude tries to end its turn, nofakedone reads `git diff` (plus new
  32. untracked files). If it finds fake-done patterns, the stop is **blocked** and Claude gets the list:
  33. ```
  34. nofakedone: the diff still contains work that only looks finished. Before you stop:
  35. - [STUB_NOT_IMPLEMENTED] Unimplemented stub at src/billing.py:10: `raise NotImplementedError`.
  36. - [TESTS_REMOVED] Tests removed at tests/test_billing.py:1: `def test_charge_declined():`.
  37. - [TAUTOLOGY_ASSERT] Assertion that cannot fail at tests/test_billing.py:3: `assert True`.
  38. For each item, either do the real work, or (only if it is truly intended) add an inline
  39. `nofakedone: ok <reason>` comment and tell the user why. Do not delete or weaken tests to get past this check.
  40. ```
  41. Claude then fixes the code, or tells you honestly what is left. The hook blocks once per turn at most, so it can
  42. never trap the agent in a loop.
  43. ## What it catches
  44. | Rule | Severity | Example |
  45. |---|---|---|
  46. | `STUB_NOT_IMPLEMENTED` | block | `raise NotImplementedError`, `todo!()`, `throw new Error("not implemented")` |
  47. | `STUB_ELIDED` | block | `// ... rest of the implementation` |
  48. | `SWALLOWED_ERROR` | block | `except Exception: pass`, `catch (e) {}`, `.catch(() => {})`, `_ = err` |
  49. | `TEST_SKIPPED` | block | `@pytest.mark.skip`, `it.skip`, `xit`, `@Disabled`, `t.Skip()`, `#[ignore]` |
  50. | `TEST_FOCUSED` | block | `it.only(...)` silently disables every other test |
  51. | `TAUTOLOGY_ASSERT` | block | `assert True`, `expect(true).toBe(true)`, `expect(x).toBe(x)` |
  52. | `TESTS_REMOVED` | block | more test functions removed than added |
  53. | `TEST_FILE_DELETED` | block | a whole test file deleted |
  54. | `ASSERTIONS_REMOVED` | block | a test kept but stripped of its assertions |
  55. | `TEST_GAMING` | block | `if "pytest" in sys.modules: return {...}`, `NODE_ENV === 'test'` |
  56. | `HOOK_BYPASS` | block | `git commit --no-verify`, `HUSKY=0` |
  57. | `CI_SOFT_FAIL` | block | `pytest \|\| true`, `continue-on-error: true` |
  58. | `COVERAGE_LOWERED` | block | `fail_under = 90` → `fail_under = 40` |
  59. | `FAKE_RETURN` | warn | `return True # placeholder` |
  60. | `TODO_ADDED` | warn | new `TODO` / `FIXME` / `HACK` |
  61. | `LINT_SUPPRESSED` | warn | `# type: ignore`, `@ts-ignore`, `eslint-disable`, `# noqa` |
  62. Full sample report: [`examples/report.txt`](examples/report.txt), produced from [`examples/fake.diff`](examples/fake.diff).
  63. ## Install
  64. ### As a Claude Code plugin (recommended)
  65. ```
  66. /plugin marketplace add 07sharath03kumar-afk/nofakedone
  67. /plugin install nofakedone@nofakedone
  68. ```
  69. You get the Stop hook, the `nofakedone` skill and a `/nofakedone` command. Requires `python3` on your PATH.
  70. ### As a CLI
  71. ```bash
  72. curl -O https://raw.githubusercontent.com/07sharath03kumar-afk/nofakedone/main/scripts/nofakedone.py
  73. python3 nofakedone.py # uncommitted changes
  74. python3 nofakedone.py --base main # whole branch
  75. python3 nofakedone.py --json # for scripts
  76. ```
  77. Exit code `1` means blocking findings, so it drops straight into a pre-commit hook.
  78. ### As a GitHub Action
  79. ```yaml
  80. - uses: actions/checkout@v4
  81. with: { fetch-depth: 0 }
  82. - uses: 07sharath03kumar-afk/nofakedone@main
  83. with:
  84. base: origin/main
  85. ```
  86. Agent-written pull requests get the same gate as agent sessions.
  87. ## Silencing a real exception
  88. Some code is genuinely meant to look like this (an abstract method, an optional import). Mark it inline:
  89. ```python
  90. raise NotImplementedError # nofakedone: ok abstract base class
  91. ```
  92. Skip whole paths with a `.nofakedoneignore` file (one glob per line). Set `NOFAKEDONE_DISABLE=1` to switch the
  93. hook off for a session.
  94. ## How it compares
  95. | | nofakedone | mutation testing (e.g. honest-tests) | linters |
  96. |---|---|---|---|
  97. | Runs automatically when the agent stops | ✅ | ❌ | ❌ |
  98. | Catches stubs, swallowed errors, bypassed CI | ✅ | ❌ | partly |
  99. | Catches deleted tests and assertions (diff-aware) | ✅ | ❌ | ❌ |
  100. | Proves a test *can* fail | ❌ | ✅ | ❌ |
  101. | Speed | milliseconds | minutes | seconds |
  102. They complement each other: nofakedone is the fast gate on every turn, and mutation testing is the deep check.
  103. ## Limits
  104. nofakedone reads patterns in the diff. It does not run your code, so a clever enough fake can still get past it,
  105. and a legitimate change can occasionally trip it (that is what `nofakedone: ok` is for).
  106. Treat it as a smoke alarm, not a proof of correctness.
  107. ## Development
  108. ```bash
  109. python -m unittest discover -s tests -v
  110. ```
  111. Rules live in one list at the top of [`scripts/nofakedone.py`](scripts/nofakedone.py). A new rule needs a regex,
  112. a severity and a test. PRs adding languages and patterns are very welcome.
  113. ## License
  114. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.