defprod-fix-discrepancies

Applies discrepancy report recommendations to align product definitions with codebase implementation.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/defprod1/defprod-skills --skill defprod-fix-discrepancies-defprod1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: defprod-fix-discrepancies
Source: https://github.com/defprod1/defprod-skills/tree/main/skills/defprod-fix-discrepancies
Command: npx skills add https://github.com/defprod1/defprod-skills --skill defprod-fix-discrepancies-defprod1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a discrepancy analysis reveals drift between your product definition (user stories and acceptance criteria) and the actual codebase, manually reconciling each finding is slow and error-prone. This Skill reads the discrepancy report and applies the recommended fixes to both the definition and the code. ## Core Features & Use Cases - Definition updates via MCP: Creates, patches, or deletes user stories through the DefProd MCP server based on report recommendations. - Codebase fixes: Implements missing features or corrects code that diverges from acceptance criteria, verifying compilation after every change. - Test verification: Updates or creates e2e tests covering changed acceptance criteria and runs them until green. - Use Case: After running a discrepancy analysis on your authentication area, invoke this Skill with the report path to update stale stories, create stories for undocumented features, and fix code that diverges from the definition. ## Quick Start Run /defprod-fix-discrepancies with the path to your discrepancy report, for example docs/defprod-discrepancy-AUTH-2026-04-05.md, and confirm the proposed fixes when prompted.

Frequently Asked Questions about defprod-fix-discrepancies

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

FAQPage Schema
How do I fix discrepancies between user stories and code?

Run the discrepancy analysis first to generate a report, then invoke this Skill with the report path. It parses the findings, asks for your confirmation, and applies definition updates via the DefProd MCP server plus any required code changes.

What does the defprod-fix-discrepancies skill change in my project?

It updates, creates, or deletes user stories through the DefProd MCP server, modifies production code to satisfy acceptance criteria, and updates or creates e2e tests. Every code change is followed by a compilation check.

Can I cherry-pick which discrepancy fixes to apply?

Yes. After loading the report, the Skill presents a summary of all findings and waits for your go-ahead. You can choose to proceed with all fixes or select specific items before any changes are made.

Does this skill work without the DefProd MCP server connected?

No. It requires the DefProd MCP server to list areas, load user stories, and apply definition changes via tools like listUserStories and patchUserStory. Codebase fixes alone cannot restore definition-to-code alignment.

What happens if stories changed after the report was generated?

The Skill reloads current stories from the MCP server before applying fixes and flags any report items that may be outdated, so stale recommendations are surfaced rather than blindly applied.