plan-eng-review

Automate FeatureForge engineering plan reviews against a formal plan contract.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/dmulcahey/featureforge --skill plan-eng-review-dmulcahey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-eng-review
Source: https://github.com/dmulcahey/featureforge/tree/main/skills/plan-eng-review
Command: npx skills add https://github.com/dmulcahey/featureforge --skill plan-eng-review-dmulcahey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan reviews are a bottleneck and a source of drift when engineering work streams transform spec into execution plans. This Skill enforces a formal engineering-review workflow for FeatureForge plans, ensuring plans are well-scoped, auditable, and gate-controlled before execution.

Core Features & Use Cases

  • Validate plan headers and metadata such as Workflow State, Plan Revision, Execution Mode, Source Spec, Source Spec Revision, and Last Reviewed By to ensure alignment with the latest approved spec.
  • Enforce the Plan-Contract Gate by running preflight safety checks and plan-analysis to determine readiness for engineering approval.
  • Guide engineers through architecture, code quality, test coverage, and risk assessment sections, ensuring traceability to the source spec and plan fidelity receipts.
  • Manage plan lifecycle: draft to engineering approved, staged approvals, and planned execution handoff, including late refresh-test-plan lanes when needed.
  • Produce a QA handoff artifact for cross-session reuse.

Quick Start

Open with the latest plan at docs/featureforge/plans and run plan-eng-review to begin engineering validation.

Frequently Asked Questions about plan-eng-review

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

FAQPage Schema
How do I automate engineering plan reviews against a formal spec contract?

Automating engineering plan reviews requires validating plan artifacts against a formal spec contract by checking workflow state, revisions, and review headers to ensure alignment with the latest approved spec.

What is a plan-contract gate in an engineering workflow?

A plan-contract gate is a preflight safety check that analyzes plan readiness, ensuring engineering plans are well-scoped, auditable, and gate-controlled before execution against their source specs.

How do I validate plan metadata like workflow state and execution mode before approving execution?

Validate plan metadata by checking workflow state, plan revision, execution mode, source spec, and last reviewed by fields to ensure traceability to the approved source spec before execution handoff.

Can I use structured review guidance for architecture, code quality, and test coverage in one pass?

Structured review guidance can assess architecture, code quality, test coverage, and risk in one pass, ensuring plan fidelity receipts and traceability to the source spec throughout the engineering review workflow.

Does the engineering review workflow support staged approvals and late refresh-test-plan lanes?

The engineering review workflow supports managing the plan lifecycle from draft to engineering approved, including staged approvals, planned execution handoff, and late refresh-test-plan lanes when needed.

What are the limitations of manual plan reviews compared to automated contract validation?

Manual plan reviews create bottlenecks and drift when transforming specs into execution plans, whereas automated contract validation enforces preflight safety checks and structured guidance to reduce execution risks.