Tadado: Instructions file for Claude Code

CLAUDE.md

Tadado CLAUDE.md is an instructions file for Claude Code from HananxR/Tadado. It costs 2,989 tokens per session, scanned A, original, MIT.

A project instruction file for Tadado, a Windows task-management application written in Python with a graphical interface, Markdown tasks, a SQLite database, full-text search, and a calendar heatmap.

In plain words
What is it for?
Use it when developing, documenting, versioning, or testing Tadado.
Why use it?
It tells coding agents how to change the application while keeping its design documents, help manual, version data, and release rules consistent.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions Claude Code.

This is HananxR/Tadado's own configuration. It tells Claude Code how to work on Tadado itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything Tadado configures →

Reuse

Borrowing it

Nothing to install: this file belongs to HananxR/Tadado. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/HananxR/Tadado/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/HananxR/Tadado

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for Tadado CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/hananxr/tadado/claude-md/github.svg)](https://agentmods.dev/instructions/hananxr/tadado/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/hananxr/tadado/claude-md"><img src="https://agentmods.dev/badge/instructions/hananxr/tadado/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for Tadado CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/hananxr/tadado/claude-md"><img src="https://agentmods.dev/badge/instructions/hananxr/tadado/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,989 This file is loaded in full into every session.
When invoked 2,989 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.02989 $0.02989
Opus 5.5 $0.01196 $0.01196
Sonnet 5.5 $0.00598 $0.00598
Haiku 4.5 $0.00299 $0.00299

Measured 6d ago against content hash 8af6f4687ff9, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

Tadado CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 155 lines

How it starts

The opening of the file, as written. The whole thing — 155 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

Tadado 项目指导文件。详细设计文档见 DESIGN.md,更新日志见 CHANGELOG.md。

2026-09-15 分支分家:本工作目录只保留 Tauri 桌面端(desktop/)。 PySide6 版(src/ tests/ pyproject.toml …)已归档到 archive/pyversion 分支, 本分支下已不存在。取回旧代码:git checkout archive/pyversion -- <路径>。 因此本文件里涉及 Python 工具链(uv / pytest / ruff)的段落只对归档分支有效。

项目概览

Tadado2(v1.x,desktop/)—— Windows 桌面任务管理工具,任务写成 Markdown 一行、 每次推进落在它自己的时间线上。当前主线实现是 Tauri + TypeScript(Windows WebView2), 版本自 v1.0.0 起;PySide6 版(Tadado,v0.x,最后 v0.2.7)是上一代实现,已归档。 面向用户的功能介绍、安装与升级说明在 README.md。

工作流程

功能优化 → 文档同步

软件功能优化/新增/修改后,必须同步更新以下关联文档,确保与软件实际功能一致、术语使用一致:

文件 说明
DESIGN.md 详细设计说明,记录功能模块需求与实现方案(权威源:行为为什么是这样)
CLAUDE.md 项目指导文件(本文件),运行时 AI 指令
desktop/README.md 桌面端结构、设计权威源、数据层现状(权威源:代码在哪、现状是什么)
README.md 面向用户的功能介绍、安装与升级口径(版本号、安装包体积、截图会随发布变)
TODO.md 剩余工作与流水,其中「桌面版工作线」一节是主线在追的

提交流程:文档更新完成后自动执行 git add + git commit(commit message 以 docs: 开头)。

验证 → 什么时候跑 e2e

npm run e2e(在 desktop/)是唯一的验证闸门:它先 tsc + vite build(构建不过就直接停), 再真开一个 Chromium 把主流程点一遍 —— 一轮约 2–3 分钟。所以:

  • 攒批跑:一轮改动全部写完再跑一次。动手之前先 npx tsc --noEmit(几秒)把编译错误挡在前面 —— 否则可能白等两分钟,才发现卡在第一行。
  • 由用户发指令再跑(2026-09-21 定的):用户没让跑就不跑。之前的做法是每改一小处就全量跑一遍, 还常常「改 → 跑 → 还原证伪 → 恢复 → 再跑」,一行改动里 90% 的时间都在等测试。
  • 证伪只针对可疑的绿:新写的断言如果有可能「空跑」(前提不成立也照样绿),才单独去证伪一次 (改坏被测代码,确认它真的会红);不是每条都要走一遍。
  • 红的第一件事是分类:先看这条失败是「被测行为真的变了」还是「断言自己的前提没设对」 (时间、分页、当前筛选、焦点窗口都会让断言的前提不成立)。别急着改被测代码。

version.py 动态修改判定(仅 archive/pyversion 分支)

本分支没有 src/,这一节只在归档分支上有效。

src/version.py 是公开 API,数据已拆到 src/_version_data.py:

  • 数据文件 _version_data.py:__version__ 值、_RELEASE_HIGHLIGHTS 字典 — 发版时由 generate_db.bat 更新
  • 逻辑文件 version.py:get_version()、parse_version()、get_release_highlights() 等函数 — 不再因发版而被修改

规则:

  • 仅数据变更(如改版本号、增删 highlights 条目)→ 不自动 commit,留给发版流程统一提交
  • 逻辑变更(如新增/修改函数、调整解析规则)→ 自动 commit

Read the full file on GitHub · 155 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago Changed · +7 lines · +188 tokens per session 8af6f4687ff9
  2. 1mo ago Changed · +54 lines · +1,420 tokens per session e61daeca01af
  3. 1mo ago Changed · +10 lines · +226 tokens per session 7af81e8153ae
  4. 1mo ago First seen · 84 lines · 1,155 tokens per session scan A fad2f171e250

Subscribe to this mod's changes

Tadado CLAUDE.md is an instructions file published in the GitHub repository HananxR/Tadado (34 stars, last pushed 7d ago), licensed MIT. It adds 2,989 tokens to every session, about $0.0120 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,581 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 4,261 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens