Git-backed working record
Kido Brain
Persistent Working Memory
The git-backed record of a unit of work: its plan, tasks, decisions, evidence and handoff.
The working record that stays
- Plan & decisions
- Git-backed record
- Resumable handoff
Conceptual illustration. See current scope & status below.
What is Kido Brain?
Kido Brain is the persistent working memory for one kido, a story-sized unit of work. It is a versioned Markdown folder that keeps the plan, tasks, implementation notes, decisions, handoff, change history and supporting artifacts together. Code belongs in the project repository; the Brain preserves the thinking and state needed to continue the work across conversations.
What it is designed to do
- Keep the work’s status, branch and lock in meta.md, alongside its plan, tasks, decisions and evidence.
- Make handoffs resumable: handoff.md records the current state, next steps and deferred work so the next conversation can continue from a durable checkpoint.
- Support git-managed work beyond source code, including knowledge proposals; the Kido Kind identifies the type of work.
Illustrative use case
How it could fit into your work
A coding conversation pauses before a story is finished. Its handoff records what changed, the remaining steps and the relevant evidence; the next conversation resumes from that Brain instead of reconstructing the work from chat history.
An example of the intended role, not a claim of a released workflow.