implement-change

Implement ADR and Gherkin spec changes into production code with smoke tests.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/0xdeafcafe/skills --skill implement-change
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implement-change
Source: https://github.com/0xdeafcafe/skills/tree/main/skills/implement-change
Command: npx skills add https://github.com/0xdeafcafe/skills --skill implement-change

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you move from planning to implementation without losing the intent of the change. It turns an ADR and Gherkin spec into code changes, keeps the work aligned with architectural decisions, and stops at the point where the specified scenarios pass.

Core Features & Use Cases

  • Contract-driven implementation: Reads the ADR and spec first so code follows agreed decisions and acceptance criteria.
  • Structured delivery workflow: Maps touched files and symbols, proposes a diff plan, asks for confirmation, then writes code in logical commits.
  • Scenario-based validation: Runs the spec's scenarios as smoke tests and reports any manual checks still needed.
  • Use Case: After /plan-change produces an ADR and feature spec for a new export flow, use this Skill to implement the feature across service, UI, and tests while preserving repo conventions and validating the promised behavior.

Quick Start

Ask the assistant to use implement-change on your ADR and spec so it can plan the diff, confirm the approach, write the code, and run the planned scenarios as smoke tests.

Frequently Asked Questions about implement-change

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

FAQPage Schema
How do I implement code changes from a Gherkin spec and ADR?

To implement code changes from a Gherkin spec and ADR, the Skill reads your architecture decisions and acceptance criteria, proposes a diff plan, and writes production code in logical commits until the specified scenarios pass as smoke tests.

What is the workflow for turning feature specs into production code?

The feature delivery workflow maps touched files and symbol seams from your spec, asks you to confirm the proposed diff plan, writes the code changes, and validates the implementation by running executable scenarios as smoke tests.

Do I need an ADR to generate code from Gherkin acceptance criteria?

You do not strictly need an ADR to generate code from Gherkin acceptance criteria, as a feature spec is mandatory, but an Architecture Decision Record is highly preferred to ensure the generated code follows agreed architectural decisions.

Can I run smoke tests based on Gherkin scenarios without executing the full audit suite?

Yes, you can run smoke tests based on Gherkin scenarios without executing the full audit suite. The Skill stops implementation once the planned executable scenarios pass and reports any manual checks still needed.

What's the best way to align code generation with architectural decisions?

The best way to align code generation with architectural decisions is to supply an ADR alongside your feature spec. The Skill reads both first, ensuring code follows agreed decisions and maps touched files accordingly before writing logical commits.

Why does code generation stop before running the full test suite?

Code generation stops before running the full test suite to validate implementation quickly. It runs your spec's executable scenarios as smoke tests to confirm the promised behavior, leaving the comprehensive audit suite for later pipeline execution.