Agent memory
Agent memory
The Anima AI agent maintains three files in your workspace/ folder to track tasks, remember code patterns, and log changes as it works.
Every playground includes a workspace/ folder with three markdown files. These files act as the Anima agent's memory, helping it stay focused, consistent, and aware of what's happened so far.
You can open and read these files anytime in the Code tab. The agent updates them automatically, but you can also edit them directly to steer its behavior.
TODO.md
A living list of tasks the Anima agent thinks your project needs next.
After generating your initial app, the agent reviews the result and writes a set of suggested improvements into TODO.md. Each task is wrapped in a <todo> tag with a short title and description.
How the Anima agent maintains it:
- Proactively reviews and updates the file after each response
- Suggests ambitious features, UX improvements, and polish items
- Removes tasks when completed or no longer relevant
- Re-ranks by impact and user value
How tasks become suggestion chips:
TODO.md items appear as clickable chips below the chat input. Each chip shows a short label with a category icon.
- Click a chip to place its full task description into the input field. It won't send automatically, so you can review or edit before submitting.
- After the agent responds, the next set of unused chips rotates in.
- Used chips don't reappear.
Task categories:
- Interaction: Hover states, click effects, active states
- Animation: Transitions, fade-ins, scroll animations
- Responsive: Mobile and tablet layout fixes
- Polish: Loading states, skeletons, visual refinements
- Functionality: Search, validation, toggles, new features
CODER.md
A reference file the Anima agent builds as it learns your codebase.
This file is automatically included in the agent's context on every request. As it works, it saves notes about patterns it discovers so it doesn't have to re-learn them.
What it stores:
- Frequently used tools and file paths
- Code style preferences (naming conventions, preferred libraries)
- Codebase structure and organization
- Tricky quirks and coupled dependencies
When it updates:
The Anima agent adds to CODER.md whenever it spends time searching for a configuration file, discovers a non-obvious dependency, or identifies a pattern worth remembering.
CHANGELOG.md
A running log of every change the Anima agent makes to your project.
The agent updates this file at the end of every response. Entries are sorted by date with the most recent first.
Format:
- Max 5 lines per entry
- Includes file paths of modified files
- Notes patterns and conventions discovered in the codebase
The file is kept under 300 lines. When it grows too long, the agent summarizes older entries to stay within the limit.
Related
Updated 18 days ago