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.