implement-changes

Implement approved code, documentation, and configuration changes in small verified work units.

Updated May 12, 2026
One-click install
npx skills add https://github.com/mtk177a/skills --skill implement-changes-mtk177a
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: implement-changes
Source: https://github.com/mtk177a/skills/tree/main/skills/implement-changes
Command: npx skills add https://github.com/mtk177a/skills --skill implement-changes-mtk177a

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Applying an approved change often goes wrong when an agent edits before confirming scope and authority, forces TDD onto work that has no meaningful failing test, repeats the same failed fix, or reports unrun checks as passing. This Skill structures implementation into small, reviewable work units with explicit verification choices and honest completion reporting. ## Core Features & Use Cases - Verification-mode selection: Chooses TDD (Red-Green-Refactor) only when a meaningful failing test can express the expected behavior, and selects deterministic or inspection-based checks for documentation, static configuration, and behavior-preserving refactoring. - Scope and risk gates: Stops as Blocked before high-risk edits lacking authorized scope, controls, or residual-risk acceptance, and halts when a discovered shared cause exceeds the authorized boundary instead of adding workarounds. - Failure-loop control: Distinguishes repeated test observation from repeated failed implementation attempts and stops before a third equivalent edit without new evidence. - Use Case: After a design is approved to fix a config parser bug, use this Skill to write a failing focused test, make the minimal fix, run the regression suite, and report actual files changed, commands run, unverified scope, and residual risk. ## Quick Start Implement the approved bug fix in small units, confirm a failing test before editing, run the focused and regression checks, and report what remains unverified.

Frequently Asked Questions about implement-changes

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

FAQPage Schema
How do I implement an approved change with TDD?▼

Split the change into small work units, write one focused failing test, confirm it fails for the intended reason, then make the simplest change that passes it. Run focused checks per unit and broader regression checks before reporting completion.

When should TDD not be used for a code change?▼

Skip TDD when no meaningful failing test can express the expected outcome, such as documentation edits, static metadata, schema-only configuration, generated output, or behavior-preserving refactoring. Use parser validation, lint, dry-run, or deterministic diff checks instead.

Does a configuration change ever need a failing test first?▼

Yes. If a configuration value changes observable application behavior and a focused automated test can express the expectation, TDD applies regardless of file type. The decision is based on observable behavior, not the file extension.

What happens when the same fix attempt keeps failing?▼

After two materially equivalent implementation attempts fail under the same unchanged hypothesis with no new evidence, the workflow stops before a third equivalent edit. It records the failed hypothesis and one structurally different branch or missing input.

When does implementation stop as Blocked?▼

Implementation stops before editing when scope, authority, or high-risk controls are unresolved, or when inspection reveals the authorized local scope cannot fix a confirmed shared cause. The Blocked report lists missing decisions and leaves files unchanged.

What must a completion report include?▼

A Done report includes actual changed files, focused and regression commands with results, unperformed checks, unverified scope, residual correctness and safety risks, and relevant reviewer context. Unexecuted checks are never reported as passing.