session-retrospective

session-retrospective is an agent for Claude Code from sliamh11/Deus. It costs 0 tokens per session (2,970 once invoked), scanned B, original, MIT.

A cross-session analysis role that reads recent development logs and creates a dated review of recurring patterns. It records possible causes, deferred work, behaviour changes, and recommendations with confidence levels.

In plain words
What is it for?
Use it to study development sessions over time, track unfinished tasks, and test whether suggested process changes improve future work.
Why use it?
It helps reveal problems or habits that are difficult to notice in one session and turns them into recommendations that can be checked later.

Agent for Claude Code

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.

agentmods
npx agentmods add agents/sliamh11/deus/session-retrospective
Clone the repo
git clone --depth 1 https://github.com/sliamh11/Deus

Made for: Claude Code.

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 session-retrospective

README.md
[![agentmods](https://agentmods.dev/badge/agents/sliamh11/deus/session-retrospective.svg)](https://agentmods.dev/agents/sliamh11/deus/session-retrospective)
Your own site
<a href="https://agentmods.dev/agents/sliamh11/deus/session-retrospective"><img src="https://agentmods.dev/badge/agents/sliamh11/deus/session-retrospective.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,970 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
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 $0.00000 $0.02970
Opus 5 $0.00000 $0.01485
Sonnet 5 $0.00000 $0.00594
Haiku 4.5 $0.00000 $0.00297

Measured 4d ago against content hash a5ac3ce5bb00, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

session-retrospective scanned grade B with 1 finding 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 4d ago.

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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

3. **Schema config** -- find repo root (walk up from `$PWD` to `.git/`). Read `$REPO_ROOT/.claude/wardens/retrospective-schema.md`, extract `vault_path:` field.
.claude/agents/session-retrospective.md · 222 lines

How it starts

The opening of the file, as written. The whole thing — 222 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the session-retrospective Warden -- a pattern analyst for development sessions. You read structured session logs, compare them against saved behavioral rules, and produce a concrete retrospective with verifiable recommendations. You do NOT review code. You do NOT give verdicts. You generate an artifact.

Signal > coverage. A precise retrospective on 80% of sessions beats a vague one on 100%.

At invocation

Step 1: Locate the session log root

Resolve in order, stopping at the first that works:

  1. Invocation-arg path -- if the prompt contains SESSION_LOG_ROOT=<path>, use it.
  2. Env var -- $SESSION_LOG_ROOT if set.
  3. Schema config -- find repo root (walk up from $PWD to .git/). Read $REPO_ROOT/.claude/wardens/retrospective-schema.md, extract vault_path: field.
  4. In-repo fallback -- if $REPO_ROOT/Session-Logs/ exists, use it.
  5. Fail loud -- print: "Cannot locate session logs. Set SESSION_LOG_ROOT or add vault_path: to retrospective-schema.md" and stop.

Also read the schema for session_window (default: 20) and project_filter (default: basename of $REPO_ROOT).

Step 2: Collect session files

find "<SESSION_LOG_ROOT>/Session-Logs" -name "*.md" -not -path "*/\.*" | \
  xargs ls -t 2>/dev/null | head -<session_window>

Use file count, not day count -- a single busy day may produce 15+ files.

Step 3: First pass -- frontmatter scan

For each file, read ONLY the YAML frontmatter block (between first --- and second ---). Extract: date, topics, tldr, decisions, project_path. This costs ~150-200 tokens/file.

If project_path: is present and doesn't match $REPO_ROOT, mark the file as [off-project] -- include in counts but de-weight for pattern detection.

Step 4: Second pass -- full body read

Select the 8-10 files most likely to yield pattern signal:

  • Files whose topics appear in 3+ other files in the set
  • Files whose tldr or decisions mention bugs, failures, deferrals, reversals, or rework
  • The oldest 1-2 files in the window (for temporal range)

Read the full file on GitHub · 222 lines

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. 4d ago First seen · 222 lines · 0 tokens per session scan B a5ac3ce5bb00

Subscribe to this mod's changes

session-retrospective is an agent published in the GitHub repository sliamh11/Deus (51 stars, last pushed today), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 2,970 tokens. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

gtd-research-processor

Autonomous research agent that fetches URLs, analyzes content, creates literature notes with progressive summarization, and generates atomic zettels. Invoked by ai-task-executor for :AI:research: tagged tasks.

datacore-one/datacore · 0 tokens

ai-task-executor

Core 24/7 autonomous task execution hub that scans nextactions.org for :AI: tagged tasks, routes them to specialized GTD agents based on task type, handles execution outcomes, logs to journal, and updates org-mode task states. Returns JSON responses with detailed success/failure reporting.

datacore-one/datacore · 0 tokens

create-module

Create or convert code into a spec-aligned Datacore module. Use cases: Create a new module from scratch Convert existing code to a module Audit an existing module for spec alignment This agent ensures modules follow best practices: Conversational commands (not CLI wrappers) Proper settings in module.yaml Layered…

datacore-one/datacore · 90 tokens

gtd-content-writer

Autonomous content generation agent that creates blog posts, emails, social media content, documentation, and marketing materials. Generates drafts ready for human review. Invoked by ai-task-executor for :AI:content: tagged tasks.

datacore-one/datacore · 0 tokens

gtd-inbox-processor

Use this agent when you need to process individual entries from inbox.org in a GTD (Getting Things Done) system. This agent should be invoked:\n\n- After capturing new items to inbox.org and wanting to process them into the appropriate action lists\n- When conducting a GTD review and need to clear the inbox…

datacore-one/datacore · 0 tokens

gtd-project-manager

Autonomous project coordination agent that tracks project status, identifies blockers and dependencies, calculates completion percentages, flags timeline risks, and suggests follow-up tasks. Proactively escalates blockers older than 7 days. Invoked by ai-task-executor for :AI:pm: tagged tasks.

datacore-one/datacore · 0 tokens