explain-change

Link code diffs to problems, requirements, decisions, tests, and verification evidence.

3|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/xiongxianfei/rigorloop --skill explain-change
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: explain-change
Source: https://github.com/xiongxianfei/rigorloop/tree/main/.codex/skills/explain-change
Command: npx skills add https://github.com/xiongxianfei/rigorloop --skill explain-change

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Explain why an agent changed code by linking the actual diff to the problem, proposal, requirements, architecture decisions, plan milestones, tests, and verification evidence.

Core Features & Use Cases

  • Document the rationale behind code changes to ensure future maintainers understand the decision trail.
  • Provide end-to-end traceability from the diff to the problem, proposal, requirements, and verification findings for audits, PRs, and post-implementation reviews.
  • Support comprehensive review-resolution summaries when material findings exist, including alternatives considered and risk considerations.

Quick Start

Provide a durable explain-change artifact that captures the summary, problem, decision trail, diff rationale, tests, verification evidence, and review outcomes.

Frequently Asked Questions about explain-change

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

FAQPage Schema
How do I document the rationale behind AI-assisted code changes for a PR review?

To document code change rationale, link the actual diff to the problem, proposal, requirements, architecture decisions, and tests. This creates a durable artifact for PR handoffs, ensuring future maintainers understand the complete decision trail and verification evidence.

What is code change traceability and how does it work for post-implementation audits?

Code change traceability provides end-to-end linkage from the diff back to the problem, proposal, and verification findings. For post-implementation audits, it captures the decision trail and review resolutions, proving exactly why specific code modifications were made.

How do I create a decision trail for code modifications that includes alternatives and risks?

Create a decision trail by recording an explicit scope and risk discussion alongside the diff rationale. When material findings exist, include a comprehensive review-resolution summary that documents the alternatives considered, ensuring full architectural context.

Can I link code diffs to plan milestones and requirements for an AI-assisted workflow?

Yes, you can link code diffs to plan milestones and requirements. This workflow integration maps the actual code modifications directly to the proposal and architecture decisions, verifying that the AI-assisted changes meet the original project specifications.

What's the best way to resolve material findings during a code review of agent-changed code?

The best way to resolve material findings is to generate a review-resolution summary within the change artifact. This summary captures the alternatives considered, risk considerations, and the final verification evidence, closing the loop on the audit.