---
name: avids2/memorix-reasoning
source: https://app.decimal.ai/s/avids2-memorix-reasoning@1/SKILL.md
source_sha256: 90ecdbe4bad1
---

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