k(no)w-code

Your agents don't push until you know exactly what's changed.

Cross-harness Agent Skill + CLI that blocks git commit, git push, and PR creation until you pass a comprehension quiz about the diff. The agent writes the quiz and proposes your grade — you answer in the browser and seal the gate. Not self-scored.

Docs: kc.chtnnhfoundation.org

Who does what

	Agent	You (human)
Teach	Explains the change	taught (seal)
Quiz	Writes quiz.json, runs ask	Answer in browser
Grade	grade-proposal.json	grade --review → pass
Stage	— (denied in agent hooks)	git add
Commit	know-code commit	Or you, after pass
Ship	—	range seal, git push

Install

npm i -g @chtnnh/know-code
know-code init --level standard --agents claude,cursor,codex --workflow
know-code attest-init
know-code skills
know-code range begin

Every command is also available as kc (kc status, kc taught, kc commit -m "…").

The loop

range begin → [agent teaches] → taught → [agent: quiz] → ask → [you: browser]
  → [agent: grade proposal] → grade --review → pass → [agent: commit(s)] → range seal → push

Phase	Command	Who
Debug	status --json · doctor --strict	either
Start range	range begin	you
Teach receipt	taught	you
Quiz authoring	questions · quiz.json · quiz validate	agent
Quiz answers	ask	you (browser)
Grade	grade-proposal.json → grade --review · pass	agent → you
Commit	know-code commit -m "…"	agent
Finish	range seal · ship · git push	you

Walkthrough: tutorial · Mechanics: how it works

Author

Built by chtnnh.

• Repository: github.com/chtnnh/know-code
• npm: @chtnnh/know-code
• Documentation: kc.chtnnhfoundation.org
• Issues: github.com/chtnnh/know-code/issues

Development

npm install
npm run build
npm test
npm run know-code -- status

Dogfood: see AGENTS.md.