Andon

Andon is a Lean operating kit for AI-assisted work. The repo PrimeFoldTools/andon is MIT, created 2026-06-24. On 2026-09-09 GitHub listed 59 stars and 4 forks. r/ClaudeAI posted it as a port of Toyota's quality system so the same agent mistakes stop coming back. It is Markdown templates plus a few stdlib Python hooks, not a SKILL.md marketplace pack and not Andon Labs.

Compare Verification Before Completion if you only wanted a "do not claim done" skill, Claude Hooks if you needed the Stop-hook mechanism, or Claude Style Patch if the defect was prose tics.

Key Features

• Four climbable layers: README says start with MEMORY.md (5 minutes), then CLAUDE.md plus a mistakes log, then two hooks, then lanes and a starter agent team. Nothing past layer 1 is mandatory.
• Claim-check cord: hooks/claim_check_hook.py is a Stop hook. It reads the agent's "done" phrases and asks for a fresh log_claim.py entry before the turn can end. Default is warn; block is opt-in.
• Defect Ledger: DEFECT_LEDGER.md logs defect, root cause, countermeasure, result. The countermeasure is a hook or test, not a note that asks you to remember.
• No account, no deps: README says plain Markdown and stdlib Python. Slash commands /wrap, /orient, /log-mistake live in commands/.
• AGENTS.md self-install: point an agent at AGENTS.md and it is supposed to install the kit into the project.

Limitation: the hook confirms a recent log line exists. It does not prove that line matches the claim. The agent writes its own log, so this is a forcing function plus an audit trail, not a cryptographic guarantee. Detection is regex and conservative. 59 stars is a heat signal, not an audit.

Use Cases

• Claude Code users who keep re-explaining the same stack after a weekend off.
• People tired of false "done" who already know Claude Hooks and want a ready Stop hook.
• Operators running parallel sessions who need lanes so two agents do not stomp one file.

Pricing

Getting Started

1. Clone github.com/PrimeFoldTools/andon.
2. Copy templates/MEMORY.md.template into memory/MEMORY.md and add two durable facts.
3. Point CLAUDE.md at that file at session start.
4. When you want the cord, follow HOOK_INSTALL.md in warn mode first.

First-party resource: QUICKSTART.md.

Frequently Asked Questions

Is this a SKILL.md pack?

No. It is templates, hooks, and doctrine. There is no npx skills add installer.

Does the hook prove the tests ran?

No. README says any log entry inside the 15-minute window satisfies any done-claim in that window.

Is it affiliated with Andon Labs?

No. README says same Lean word, different project.

Alternatives

• Verification Before Completion: a Superpowers skill that bans unverified "done".
• Claude Hooks: the official Stop / PreToolUse mechanism Andon hangs on.
• Eigenwise Toolshed: six Claude Code plugins if you wanted maps and tickets, not a factory cord.

Tips

1. Stay in warn mode until the regex matches your team's closing phrases.
2. Close a defect with a hook or test, not another paragraph in MEMORY.md.
3. Read THEOPERATORSCODE.md after the 5-minute win, not before.

Conclusion

Andon is the Lean kit r/ClaudeAI was pointing at: memory, a mistakes log, and a Stop hook that makes a false "done" a deliberate act. Start at the GitHub repo. If you only needed one sentence of doctrine, open Verification Before Completion instead.