Skip to content

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.

Concept study
Kido Brain: The working record that staysA git-tracked folder holds a plan, tasks and a handoff beside a separate project repository. It represents one unit of work, not an entire knowledge graph. A conceptual illustration, not a released architecture or deployment diagram.plan.mdtasks.mdhandoff.mdProjectrepo

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.