implementation-review

Assess post-implementation changes against the original plan for merge readiness.

Updated Jan 17, 2026
One-click install
npx skills add https://github.com/brmatola/gremlins --skill implementation-review-brmatola
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implementation-review
Source: https://github.com/brmatola/gremlins/tree/main/skills/implementation-review
Command: npx skills add https://github.com/brmatola/gremlins --skill implementation-review-brmatola

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, plan-aware review to ensure implementation is complete, correct, and safe to merge, reducing risk of regressions and safety issues.

Core Features & Use Cases

  • Plan-aware audit: loads the original plan, checks branch status, and compares against the plan.
  • Evidence-driven verdict: runs checks, tests, and quality signals to determine merge readiness.
  • Governance & compliance: identifies drift, incomplete tasks, and potential safety issues before merging.

Quick Start

Start an implementation review against a finished plan by invoking the workflow with the plan name and target branch, for example: gremlins:implementation-review --plan my-plan --target feature/session-auth

Frequently Asked Questions about implementation-review

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

FAQPage Schema
How do I verify merge readiness before merging a feature branch?

To verify merge readiness, run a post-implementation review that compares branch changes against the original plan, runs tests, and checks for drift. It requires access to the active plan directory and current branch information to validate correctness.

What is plan drift detection in a post-implementation review?

Plan drift detection is the process of comparing finished implementation changes against the original plan to identify misalignment. It audits task completion and flags potential safety issues or regressions before merging the branch.

How do I check if my implementation matches the original plan?

You can check alignment by loading the original plan from the plans/active/ directory and comparing it against branch changes. The review audits task completion, detects drift, and runs quality checks to ensure safe merging.

Do I need a test suite to validate branch changes before merging?

Yes, a test suite is required to validate correctness during an implementation review. The review runs tests as part of its evidence-driven verdict to determine merge safety and identify potential regressions.

What's the best way to audit a finished feature for safety issues before merging?

The best way to audit a finished feature is to run a plan-aware review that executes checks, tests, and quality signals. This governance step identifies drift, incomplete tasks, and safety issues before merging.