memorix-reasoning

# 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`.