Workspace Memory & Rules
Give December your project rules and notes that it reads in every session.
This page helps you give December rules and notes that it reads in every session.
Overview
December reads two types of files when a session starts:
- Rules: files that you write, such as
AGENTS.md. Rules tell December your coding standards and team conventions. - Memory: a short list of notes in
.december/memory.md. Memory holds facts about your project, such as the test command.
December adds both to its instructions for the session. You do not need to repeat them in each prompt.
Workspace memory (.december/memory.md)
Memory is a Markdown file with one section for each category. Each entry is one bullet:
## build_and_test
- Run unit tests with `bun test`
- Run `bun db:migrate:test` before integration tests
## conventions
- Put custom hooks in the feature folder that uses them
The categories are conventions, build_and_test, architecture, quirks, rules, and general.
December can also add and remove entries itself with the manage_memory tool, in the terminal and in December Cloud.
Memory size limit (2 KB)
December adds at most 2,048 bytes of memory to its instructions. If your memory files are larger, December cuts the text at 2 KB. Keep each entry short, and remove entries that are out of date.
The /memory view shows a warning when memory is at 85% of the limit or more.
Manage memory with /memory
Type /memory to open the memory view. The view has two tabs: memory and rules. Press Tab to switch between them.
On the memory tab:
- Press
ato add an entry. Type the text, press Tab to select a category, then press Enter. - Press
dto remove the selected entry. Pressyto confirm. - Press
↑and↓to select an entry.
On the rules tab:
- Press
↑and↓to scroll the rule file. - Press
[and]to switch between rule files, if you have more than one. - Press
cto make a starterAGENTS.mdfile. This key shows only when December finds no rule files.
Press Esc to close the view.
Where December looks for rules
December looks for rule files in your current folder. Then it looks in each parent folder, up to the root of your file system. In each folder, it reads these files:
AGENTS.override.mdAGENTS.mdCLAUDE.md.december/rules.md.december/AGENTS.md
December also reads global rules from ~/.december/rules.md or ~/.december/AGENTS.md. Global rules apply to every project on your computer.
December adds the files in this order: global rules first, then rules from the top folder down to your current folder. December reads rule files when the CLI starts. If you change a rule file, exit and start december again.