km:intent-review

Verify uncommitted git changes against reconstructed conversation requirements.

Updated Jan 24, 2026
One-click install
npx skills add https://github.com/koumatsumoto/agent-config --skill km-intent-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: km:intent-review
Source: https://github.com/koumatsumoto/agent-config/tree/main/templates/skills/intent-review
Command: npx skills add https://github.com/koumatsumoto/agent-config --skill km-intent-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures that uncommitted changes accurately implement the user's original request and previously agreed design decisions by reconstructing requirements from conversation history and comparing them to the actual diffs, preventing scope creep and unintended regressions.

Core Features & Use Cases

  • Requirement reconstruction: Recover explicit requests, agreed design decisions, and reasonable implicit expectations from conversation transcripts.
  • Diff-aware verification: Use git diff summaries and file change statistics to map implemented changes to reconstructed requirements and flag gaps by severity (HIGH/MEDIUM/LOW).
  • Use Case: Before committing work produced during an active conversation or pair-programming session, validate that the code matches the agreed design and report any omissions or scope violations.

Quick Start

Run an intent review on the current uncommitted changes using the conversation history and produce a structured report following report-format.md.

Frequently Asked Questions about km:intent-review

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

FAQPage Schema
How do I verify uncommitted changes match the original intent before committing?

To verify uncommitted changes match original intent, reconstruct explicit requests and agreed design decisions from conversation history, compare git diffs and change statistics, and produce a structured report with HIGH/MEDIUM/LOW findings and remediation guidance.

What is an intent review for code changes?

An intent review for code changes is a verification process that ensures uncommitted file changes satisfy the user's original request and agreed design decisions by reconstructing requirements from conversation history and comparing them to actual git diffs.

When do I need to validate code changes against conversation history?

You need to validate code changes against conversation history when an active context or review record exists and you want to prevent scope creep or unintended regressions before committing work produced during pair-programming sessions.

Can I check if my git diff satisfies agreed design decisions automatically?

Yes, you can check if your git diff satisfies agreed design decisions by mapping implemented changes to reconstructed requirements and flagging gaps by severity, producing a structured report with remediation guidance.

What's the best way to prevent scope creep before a git commit?

The best way to prevent scope creep before a git commit is to reconstruct explicit requests and reasonable implicit expectations from conversation transcripts, then compare file change statistics to flag any scope violations by severity.

Does intent review work without existing conversation context?

No, intent review requires a conversation context or review history to exist, because it must reconstruct explicit requests and agreements from conversation transcripts to validate changes made before committing.