Every decision behind your code, written down. Your agents write the code. Now they write down why, and anyone can read it without cloning the repository.
Read flie.sh/use-cases/code-decisions.md and set it up for this repository .Copy
Paste into Claude Code, Codex or Cursor, in your repository. See what it sets up
flie · Code decisions Example
Code decisions/
README.md
architecture.md
where things are.md
decisions/
0010 IDs, not paths.md
0011 keep every version.md
fil_2C2R30H2KP85XS46A37D64FW6V · written by your agent
Every item is named by an ID, never by a path
Why Agents rename and move things all the time. A path breaks the moment they do; an ID never changes, so every link keeps working.
Instead of Paths as names, with a redirect table for moves. Two agents moving one folder would race. fil_2C2R30H2KP85XS46A37D64FW6V · written by your agent
A write never overwrites; it adds a version
Why An agent can be wrong. Keeping every version lets a person see what changed and put it back.
Instead of Undo for the last write only. Mistakes are often found days later. Saved · every version kept
An example: your agent writes “Every item is named by an ID, never by a path” in the folder Code decisions.