mine-session-decisions

Extracts decisions, interpretations, and Git commits from Claude Code session logs into documents.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/sadie100/claude-dotfiles --skill mine-session-decisions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mine-session-decisions
Source: https://github.com/sadie100/claude-dotfiles/tree/main/skills/mine-session-decisions
Command: npx skills add https://github.com/sadie100/claude-dotfiles --skill mine-session-decisions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill helps users recover past Claude Code session decisions, interpretations, and assumptions for documentation in target documents like READMEs, ADRs, or retrospectives.

Core Features & Use Cases

  • Session Analysis: Extracts user-only messages from Claude Code session logs.
  • Decision Categorization: Anchors decisions to Git commits and presents a categorized list for user selection.
  • Documentation Integration: Writes selected decisions into the target document in the existing tone.

Quick Start

Use the mine-session-decisions skill with the command: /mine-session-decisions

Frequently Asked Questions about mine-session-decisions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract past decisions from Claude Code session logs for documentation?

To extract past decisions from Claude Code session logs, you analyze the logs to isolate user messages, identify interpretations and assumptions, and anchor them to Git commits for structured documentation.

Can I link Claude Code session decisions directly to Git commits?

Yes, linking Claude Code session decisions to Git commits is supported. The process anchors extracted decisions and assumptions to specific commits, presenting a categorized list for selection before writing them into a target document.

What is the best way to document assumptions from Claude Code sessions in a README?

The best way to document assumptions from Claude Code sessions is to extract them from session logs, categorize them with Git commit anchors, and write the selected items into the existing README tone.

Do I need Python and Git to analyze Claude Code session logs?

Yes, you need Python and Git to analyze Claude Code session logs for decision recovery. The environment requires both tools to parse session data and anchor the extracted decisions to specific repository commits.

How does session log analysis recover interpretations made during Claude Code interactions?

Session log analysis recovers interpretations by extracting user-only messages from Claude Code logs, categorizing the decisions and assumptions found, and presenting them for user selection before documentation integration.