Skill

Reconciling Changes

Analyse what changed in docs/technical/, map impact to code and tests, and define frozen scope before edits.

// workflow;

Behaviour

What it does

  • Establishes a baseline from the last plan, git tag, or CHANGELOG.md entries
  • Classifies each doc change as ADD, MODIFY, REMOVE, or CLARIFY
  • Maps affected REQ-IDs to files, modules, and existing tests
  • Defines frozen scope: areas that must not change in the delta
  • Writes an impact report to docs/plans/ for your approval
  • Hands off to planning in delta mode only after you approve the report

When to use

Good fits

After updating requirements or technical docs on an existing app

Before planning a brownfield delta

When you need to know what a spec change will touch before code changes

Skip on greenfield work; go straight to planning instead

Development harness

Step 4 of 8 · Change control

Part of the design-to-ship pipeline: brainstorming → technical-documentation → conformance-check → reconciling-changes → planning → project-setup → executing-plans → shipping. Install the full set for structured feature work.

Install

Get this skill

Uses Agent Kit via npx; no global install required.

Quick install

sh
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill reconciling-changes

Global (Cursor)

sh
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill reconciling-changes --global --agent cursor

Global (Claude)

sh
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill reconciling-changes --global --agent claude

Project install

sh
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill reconciling-changes --project

Interactive install

sh
npx @levi-putna/agent-kit@latest add levi-putna/skills

Uninstall

sh
npx @levi-putna/agent-kit@latest remove reconciling-changes

Example

Example prompt

Reconciling Changes

/reconciling-changes Requirements changed since last release. Produce an impact report before we touch code.

Flow

How the skill works

  1. Establish the doc baseline and load current docs/technical/
  2. Classify each change by type using stable REQ-IDs
  3. Map impact to files, tests, and ripple effects
  4. List frozen scope explicitly
  5. Write the impact report and wait for approval before planning