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
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill reconciling-changesGlobal (Cursor)
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill reconciling-changes --global --agent cursorGlobal (Claude)
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill reconciling-changes --global --agent claudeProject install
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill reconciling-changes --projectInteractive install
npx @levi-putna/agent-kit@latest add levi-putna/skillsUninstall
npx @levi-putna/agent-kit@latest remove reconciling-changesExample
Example prompt
Requirements changed since last release. Produce an impact report before we touch code.
Flow
How the skill works
- Establish the doc baseline and load current docs/technical/
- Classify each change by type using stable REQ-IDs
- Map impact to files, tests, and ripple effects
- List frozen scope explicitly
- Write the impact report and wait for approval before planning