Project instructions — Kandown docs

kandown work compiles Kandown's immutable core, the selected workflow, active skills, and live board context. What it cannot infer reliably is anything unique to your project.

That is what .kandown/kandown_work.md is for.

The file

.kandown/
└── kandown_work.md

Plain Markdown, optional and empty by default. Whatever you put in it is inserted after global instructions and before the final task or board context.

What belongs in it

Things an agent cannot infer from your code, and will otherwise get wrong:

## Stack
- pnpm, always. Never npm or yarn; the lockfile is pnpm's.
- Vitest for tests: `pnpm test`. There is no jest config despite the old comments.

## Conventions
- Conventional commits, imperative mood, English.
- No `any` in TypeScript. Use `unknown` plus a type guard.
- UI strings are authored in English and translated from there.

## Working style
- Update the task file as you go, not at the end. Check off subtasks with a
  `report:` line as each one lands.
- Be token-efficient: do not re-read files you have already read this session.

## Do not touch
- `bin/*.js` and `CODEMAP.md` are build output. Edit `src/` and regenerate.

What does not belong in it

The generic Kandown rules. They are already served by the CLI, and duplicating them means one copy will drift.
Anything derivable from the repository. File structure, dependency lists and past fixes are cheaper for the agent to read directly than for you to maintain in prose.
Secrets. This file is committed with the rest of .kandown/.

Why not just put it in AGENTS.md?

You can, and for a lot of projects that is fine. Two reasons to prefer kandown_work.md:

It reaches every interface. kandown work, the MCP server and the "launch an agent" flow all include it. An agent invoked from the board gets your rules whether or not it was told to read AGENTS.md.
It stays adjacent to the board. Instructions about how to work the board live next to the board, and travel with it.

Note

kandown init adds one line to your AGENTS.md / CLAUDE.md pointing at kandown work. Keep that line. It is what tells an agent the command exists in the first place.

Checking what an agent will see

kandown work

Run it yourself. It is the exact text your agent receives. Settings → Agent → Kandown Work shows the same compiler preview and lets you edit this file directly.