implementation-review

Validate implemented code against the approved plan and spec.

2|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/bdemarzo/ai-workflows --skill implementation-review-bdemarzo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implementation-review
Source: https://github.com/bdemarzo/ai-workflows/tree/main/skills/implementation-review
Command: npx skills add https://github.com/bdemarzo/ai-workflows --skill implementation-review-bdemarzo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

It prevents weak, unsafe, or product-misaligned implementations from advancing by enforcing an evidence-based review against the approved idea, spec, and plan.

Core Features & Use Cases

  • Architecture validation: Checks the delivered shape against the plan’s approved design intent and boundaries.
  • Security and QA/product correctness lenses: Flags authz/authn issues, unsafe defaults, secrets handling risks, regressions, and insufficient validation or test realism.
  • Actionable review artifacts: Writes a concise saved review round to ./docs/workflows/{slug}/reviews/implementation/round-XX.md and links to the prior implementation review round when present.
  • Recommendation gatekeeping: Produces a clear next step recommendation (revise implement-plan vs proceed to final-review) based on material reviewer findings.

Quick Start

Ask your orchestrator to run the implementation-review after implement-plan and record the outcome to the next implementation review round file for the current workflow slug.

Frequently Asked Questions about implementation-review

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

FAQPage Schema
How do I validate code readiness before final review against an approved spec?

Architecture validation checks the delivered code shape against the plan's approved design boundaries. Security and QA lenses assess authn/authz issues, unsafe defaults, secrets handling risks, regressions, and insufficient test coverage to ensure safe implementation.

How do I run an implementation review and record the outcome?

Run the implementation review after implement-plan by asking your orchestrator to execute it. The process generates a zero-padded round artifact at ./docs/workflows/{slug}/reviews/implementation/round-XX.md, links prior rounds, and produces a constrained recommendation.

What does an implementation review recommendation gate decide?

The recommendation gate decides whether to revise the implement-plan or proceed to final-review. This decision is based on material reviewer findings from the architecture, security, and QA product-correctness assessments recorded in the workflow artifacts.

Can I use automated workflow gating for post-implementation QA readiness checks?

Yes, post-implementation gating evaluates QA readiness by flagging regressions and insufficient test realism. It enforces evidence-based review against the approved idea, spec, and plan to prevent weak or unsafe implementations from advancing within the workflow.

When should I not use diff validation for code review gating?

Diff validation for code review gating should not be used when there is no approved plan or spec to validate against. The process requires deriving a workflow slug, preserving source artifacts, and linking prior implementation review rounds to function correctly.