deja-reflect

deja-reflect is a skill for Claude Code from vshulcz/deja-vu. It costs 49 tokens per session (322 once invoked), scanned A, original, MIT.

An end-of-session review skill that records lasting project decisions and lessons in deja-vu, a project memory store. It first checks existing notes, proposes a small set of facts, and asks for confirmation before saving them.

In plain words
What is it for?
Use it after a coding session to review what worked or failed, identify durable project rules, and save confirmed decisions for future sessions.
Why use it?
It prevents important fixes, rules, and rejected approaches from being forgotten while avoiding notes about temporary debugging steps or facts already recorded.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the deja-vu plugin — 2 skills, 1 command, 1 hook shipped together

Good fit Use it after a coding session to review what worked or failed, identify durable project rules, and save confirmed decisions for future sessions.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/vshulcz/deja-vu/deja-reflect
About the project

deja-vu is a local memory system that indexes coding-agent session histories and makes relevant past work available to other agents. It helps users share fixes and context across Claude Code, Codex, Cursor, Copilot CLI, and other coding agents without using a language model or embeddings. The catalogue contains hooks, commands, MCP components, skills, plugins, and instructions for connecting agents to that memory.

vshulcz/deja-vu · 1,386 stars · on GitHub · vshulcz.github.io

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add vshulcz/deja-vu --skill deja-reflect
Clone the repo
git clone --depth 1 https://github.com/vshulcz/deja-vu

Made for: Claude Code.

Or install deja-vu, the plugin that ships this one along with the rest of its 2 skills, 1 command, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for deja-reflect

README.md
[![agentmods](https://agentmods.dev/badge/skills/vshulcz/deja-vu/deja-reflect/github.svg)](https://agentmods.dev/skills/vshulcz/deja-vu/deja-reflect)
Your own site
<a href="https://agentmods.dev/skills/vshulcz/deja-vu/deja-reflect"><img src="https://agentmods.dev/badge/skills/vshulcz/deja-vu/deja-reflect/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for deja-reflect

Your own site · 80×15
<a href="https://agentmods.dev/skills/vshulcz/deja-vu/deja-reflect"><img src="https://agentmods.dev/badge/skills/vshulcz/deja-vu/deja-reflect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 322 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00049 $0.00322
Opus 5.5 $0.00020 $0.00129
Sonnet 5.5 $0.00010 $0.00064
Haiku 4.5 $0.00005 $0.00032

Measured yesterday against content hash 261a2885fd87, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

deja-reflect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

claude-plugin/skills/deja-reflect/SKILL.md · 19 lines

What it actually says

Run an end-of-session reflection over the current task and record only durable, non-obvious project facts in deja-vu.

Workflow

  1. Inspect what was already recorded or hit in this project:
    • Call the deja tool with mode: "orient" (or run deja notes and deja friction in the shell) to see existing promoted decisions and recurring walls so you do not duplicate an active note.
  2. Distill durable findings from this session:
    • Keep: architectural invariants, required flags/commands that were non-obvious, rejected approaches and why they failed, user-stated project rules.
    • Skip: anything already obvious from reading the code, temporary debugging steps, or one-off typos.
  3. Confirm with the user before writing:
    • Present the 1–3 concise one-line facts you propose to store.
    • Once confirmed, call the deja tool with mode: "remember" and query: "<concise self-contained decision and why>" (or run deja remember "<fact>" in the shell).
    • If an older note was superseded by today's work, run deja promote <id> --state superseded --note "<what replaced it>".
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 19 lines · 49 tokens per session scan A 261a2885fd87

Subscribe to this mod's changes

deja-reflect is a skill published in the GitHub repository vshulcz/deja-vu (1,386 stars, last pushed yesterday), licensed MIT. It adds 49 tokens to every session and 322 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-03.