# Decision records

A step of the [Claude Code development environment](https://gradus.kazet.blog/tree/claude-dev-environment) tree on Gradus, in the Project memory area: CLAUDE.md, docs, conventions.

Page: https://gradus.kazet.blog/tree/claude-dev-environment/step/decision-records

Record each non-obvious decision as a short dated note with the alternatives rejected, so later sessions do not relitigate it.

Usually comes after: [Knowledge base in docs](https://gradus.kazet.blog/tree/claude-dev-environment/step/knowledge-base).

## Prompt for your AI assistant

```
Add a docs/decisions/ directory with a numbered Markdown template (context, decision, alternatives considered, consequences). Write the first record for the most important decision already baked into the codebase and link the directory from docs/index.md.
```

Every step of the tree: https://gradus.kazet.blog/tree/claude-dev-environment/llms.txt