querylisted
Install: claude install-skill KKenny0/Tracework
# Decision Replay Query
This skill answers targeted project-history questions from Tracework's local decision
memory. It is a thin wrapper around the deterministic decision replay helper:
the script narrows evidence, and the host agent writes the final answer.
Use `query` when the current task touches an existing decision, architecture
boundary, rejected option, long-running risk, or product tradeoff. Use `recall`
for session-start orientation; use `query` for a specific follow-up question.
Git-only report fallback is not decision evidence here. If the raw record does
not support the question, return the evidence gap and suggest targeted capture
after the user clarifies the decision.
## Scope
- Intra-project by default.
- Raw entries remain the source of truth.
- `{vault}/raw/decisions/{project-slug}.json` is a derived retrieval index.
- The helper may rebuild an in-memory index from raw entries when no saved index
exists, but this skill does not write new memory.
- Do not use git history, external docs, or model assumptions to fill missing
decision evidence.
## Workflow
1. Identify the user's decision question.
2. Pick the mode:
| Mode | Use when the user asks |
|------|------------------------|
| `why` | why a path was chosen, why something works this way |
| `alternatives` | what was rejected, abandoned, deferred, or not chosen |
| `revisit` | what open questions or deferred choices should be reconsidered |
| `impact` | what downstream effects a decision had |
|