utils/dopamine-ux
Krzysztof kuhy Rudnicki a10d190b65
Some checks failed
file length / file-length (push) Waiting to run
md-naming / markdown naming convention (push) Waiting to run
palette drift / palette (push) Waiting to run
design_system tests / test (push) Has been cancelled
gatelock pre-commit / pre-commit (push) Has been cancelled
gatelock tests / test (3.10) (push) Has been cancelled
gatelock tests / test (3.11) (push) Has been cancelled
gatelock tests / test (3.12) (push) Has been cancelled
web_ui tests / test (push) Has been cancelled
Add the shared markdown-naming gate and migrate utils' own docs
Markdown across every repo had accumulated a dozen ad-hoc names
(refactor_claude_todo.md x23, DESIGN_AUDIT_TODO.md, NEXT_SESSION,
HANDOFF, PLAN, SPEC) with nothing distinguishing a live task from a
finished record. An audit found docs asserting work was pending that
shipped months earlier, and one asserting completion while the work
was open.

Four namespaces now: README.md, CLAUDE*.md, DOCS*.md, TODO*.md. Task
files carry the literal "REMOVE ME AFTER FINISH" and are deleted when
the work lands.

Enforced bidirectionally -- a TODO without the marker fails, AND any
file carrying the marker that is not named TODO*.md fails. Without the
reverse rule a task can be renamed into the permanent namespace and
quietly live forever, which is the failure being fixed.

md_naming/ mirrors the file_length topology and imports its tables
(EXCLUDED_DIRS, THIRD_PARTY_REPOS, VENDORED_ANYWHERE, GENERATED_PATTERN)
rather than restating them, so the two gates cannot disagree about the
same file. 71 tests, 100% branch coverage.

stale.py warns on TODOs past 90 days but never fails: no machine can
prove a task is finished, so the honest mechanism is a nudge.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01A47aX5DJwmA3QFn3pkEWi7
2026-08-24 15:53:12 +02:00
..
DOCS-dopamine-ux-index.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
TODO-01-motion-tokens.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
TODO-02-structural-check.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
TODO-03-diet-guard.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
TODO-04-screen-locker.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
TODO-05-workout-app.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
TODO-06-todo.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
TODO-07-dufs-theme.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
TODO-08-dufs-motion.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
TODO-09-wake-alarm.md Add the shared markdown-naming gate and migrate utils' own docs 2026-08-24 15:53:12 +02:00
verify_prompts.py Keep verify_prompts honest about a deleted prompt copy 2026-08-22 17:31:03 +02:00