mental-model
Maintains a living mental model of the codebase. Read mental-model.md before making changes, update it when discovering new patterns or behaviors.
Source facts
- Repository
- automazeio/mental-model-skill
- Last source activity
- January 28, 2026 at 15:29
- Detected SKILL.md language
- English
- Stars
- 5
- Forks
- 3
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- mental-model
- description
- Maintains a living mental model of the codebase. Read mental-model.md before making changes, update it when discovering new patterns or behaviors.
- license
- Apache-2.0
- metadata
- {"author":"Ran Aroussi <github.com/ranaroussi>"}
# Mental Model
When working on this codebase, first check for `mental-model.md` in the project root.
## If it exists
Read it to understand the codebase architecture, patterns, conventions, and relationships before making changes, when exploring unfamiliar parts of the code, or debugging failed tests or unexpected behavior.
Update it whenever you discover something new — from running tests, hitting unexpected behavior, or exploring unfamiliar parts of the code.
## If it doesn't exist
Ask the user if they'd like you to create one. If confirmed:
Create a new file named `mental-model.md` at the repo root, that builds and maintains a full mental model of the codebase.
Scan the entire codebase and document how the system works end-to-end (architecture, key modules, data flow, relationships, testing approach, Docker/setup, etc).
Treat this as a living document. Update it whenever you learn something new from running tests or hitting unexpected behavior.
View on GitHub