automazeio/mental-model-skill / mental-model
mental-model
VerifiedMaintains a living mental model of the codebase. Read mental-model.md before making changes, update it when discovering new patterns or behaviors.
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |