YuanyuanMa03/cot-lint

README excerpt

cot-lint English 中文 Lint your repo for chain-of-thought leakage — the session-transcript residue AI assistants leave in docs, comments, and JSDoc. Your coding agent writes great code and leaks its thinking everywhere around it: None of the left column is wrong about the code. It is wrong about its reader : it argues with a reviewer who has left, cites a design session nobody can open, and narrates a change instead of stating behavior. The one test Could a reader at HEAD — with no access to any session transcript, PR thread, or uncommitted draft — resolve every reference and verify every claim? If no, that passage is chain-of-thought leakage. cot-lint finds it. Quick start DeepSeek Harness — install the cot-trim fixing skill as a plugin: Any repo or CI — zero dependencies, Node ≥ 20: Exit codes: 0 clean · 1 findings · 2 usage error — drop it straight into CI. What it detects Class Example dead design-session citation (decision 7) , design §4.7 , phase tokens W3 / T4 , 设计稿 stack/PR vantage "this PR adds…", "a later PR in this stack" change narration / version stamps "used to", "no longer", "the old X", "the v1 refactor", "today", 旧版 / 不再 review choreography "Rejected in review:", "th…

Category