Use cases / Code decisions

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.

Paste into Claude Code, Codex or Cursor, in your repository. See what it sets up

An example: your agent writes “Every item is named by an ID, never by a path” in the folder Code decisions.

The problem

The code says what. Nobody wrote down why.

46%

of developers distrust the accuracy of what AI tools give them.

Stack Overflow Developer Survey, 2025
50,000+

public repositories DeepWiki indexed at launch, to answer questions about code people didn’t write.

Cognition, DeepWiki launch, May 2025
Stale

Documentation vendors sell checks that flag docs the code has already left behind.

Swimm, enterprise documentation platform

What your agent sets up

Plain files, nothing hidden. Change any of them.

1

A recipe you can read first

# flie.sh/use-cases/code-decisions.md
Make a folder "Code decisions" with
  architecture.md
  where things are.md
  decisions/
A decision says what, why, and what else
was considered.

Plain Markdown on flie’s site. Read the whole recipe.

2

A folder that explains itself

Code decisions/
  README.md             the rules
  architecture.md       how it fits together
  where things are.md   what lives where
  decisions/            one file per decision

Every agent reads the README first. Edit it and you change the rules for all of them.

3

One line in your repository

# AGENTS.md or CLAUDE.md
+ Before and after your work, read and
  update the flie folder "Code
  decisions" (fld_…), following its
  README.

So every future session keeps it current, not just this one.

Who reads it

Everyone who wasn’t there when it was decided.

The reviewer

Sees why a change was made, not just the diff.

The new teammate

Understands the codebase on day one.

On call at 3 a.m.

Finds why it works this way before changing it.

The next agent

Starts with the context instead of guessing.

Start with your repository.

Read flie.sh/use-cases/code-decisions.md and set it up for this repository.

Free · Every version kept · Install it yourself