avids2 Memorix Reasoning
Use reasoning memory for why a decision was made. Use ordinary memory for what happened.
Tool Router
| Situation | Prefer | CLI fallback |
|---|---|---|
| Store why a decision was made | memorix_store_reasoning |
memorix reasoning store --entity <name> --decision "<decision>" --rationale "<why>" |
| Find earlier rationale | memorix_search_reasoning |
memorix reasoning search --query "<topic>" |
| Need a stable evolving topic key | memorix_suggest_topic_key |
memorix memory suggest-topic-key --type decision --title "<title>" |
| Link rationale to commit evidence | relatedCommits on reasoning store |
memorix reasoning store ... --relatedCommits <sha> |
Use Reasoning When
- The answer depends on alternatives considered, constraints, expected outcomes, or accepted risks.
- A future agent may otherwise reopen the same debate.
- The user chose a direction and the reason matters more than the implementation details.
- A Git Memory entry says what changed, but not why it changed.
Do Not Use Reasoning For
- Simple progress notes.
- Mechanical refactors with no decision.
- Facts that belong in
memorix_storeashow-it-works,what-changed, orproblem-solution.