# Knowledge base in docs

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/knowledge-base

Keep decisions, gotchas and data models in a docs directory with an index, so the assistant reads reasons and not just code.

Usually comes after: [Project CLAUDE.md](https://gradus.kazet.blog/tree/claude-dev-environment/step/project-claude-md).

Leads to: [Decision records](https://gradus.kazet.blog/tree/claude-dev-environment/step/decision-records).

## Prompt for your AI assistant

```
Set up a docs/ directory with an index.md that lists its documents and explains how to add one. Seed it with three documents: the architecture overview, the data model and a dated log of decisions. Add a line to CLAUDE.md telling the assistant to read docs/index.md before changing behaviour.
```

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