skills.rest
MartinoPolo
MartinoPoloCOMMUNITY
Explore all skills by this author →
GitHub

mp-harvest-decisions

Extract design decisions from Claude Code JSONL transcripts and update .mpx documentation.

1|Updated Feb 7, 2026
Search Tags:#context management#Claude Code#conflict resolution#design rationale#documentation sync#GitHub workflow#decision harvesting
One-click install
npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-harvest-decisions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mp-harvest-decisions
Source: https://github.com/MartinoPolo/mpx-claude-code/tree/main/skills/mp-harvest-decisions
Command: npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-harvest-decisions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces the effort of manually reviewing Claude Code sessions by automatically harvesting design and grilling decisions and keeping your project documentation up to date.

Core Features & Use Cases

  • Session scanning: Finds relevant Claude Code session transcripts by project directory and a days-back window.
  • Decision extraction: Locates design/grill Q&A segments and extracts topic, question, answer, rationale, and category.
  • Doc synchronization: Merges, deduplicates, and updates .mpx/CONTEXT.md and .mpx/DECISIONS.md, including conflict detection and user confirmation.

Quick Start

Ask your AI to run mp-harvest-decisions with the default lookback window to scan recent sessions and update your CONTEXT.md and DECISIONS.md with the newly found decisions.

Frequently Asked Questions about mp-harvest-decisions

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

FAQPage Schema
How do I extract design decisions from Claude Code session transcripts?▼

You can extract design decisions from Claude Code sessions by scanning JSONL session files to locate grilling Q&A pairs, then pulling the topic, rationale, and category from the conversation history.

What is the best way to sync project documentation with recent Claude Code decisions?▼

Syncing project documentation with recent Claude Code decisions involves harvesting extracted Q&A pairs and merging them into .mpx/CONTEXT.md and .mpx/DECISIONS.md with user confirmation.

How does conflict resolution work when updating project context from session transcripts?▼

Conflict resolution during project context updates detects duplicate or contradicting decisions from session transcripts, prompting user confirmation before merging the changes into your documentation.

Can I scan Claude Code sessions from a specific project directory and time window?▼

Yes, you can scan Claude Code sessions from a specific project directory by setting a days-back window, which filters the JSONL session transcripts to locate relevant design conversations.

Do I need GitHub workflow integration to harvest decisions from session discussions?▼

No, you do not need GitHub workflow integration to harvest decisions from session discussions; the Skill locates JSONL session files directly to extract design rationale and update project documentation.

Related Skills

Explore More Product & Management Skills→
brandon-frysliebrandon-fryslie
4

find-session

Search JSONL transcript files for keyword matches and retrieve message context.

Community
Intermediate
MartinoPoloMartinoPolo
1

mp-grill

Clarify plans and requirements by interrogating assumptions until decisions are settled.

Community
Intermediate
javiarmestojaviarmesto

add-decision-record

Record architectural decisions as timestamped markdown files in project directories.

Community
Advanced
brandon-frysliebrandon-fryslie
4

copy-session-to-zai

Copy Claude Code session JSONL files between config directories with conflict handling.

Community
Intermediate