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_store as how-it-works, what-changed, or problem-solution.