plan-eng-review

Reviews execution plans for architecture, data flow, edge cases, and test coverage interactively.

1|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/sanjanb/my-agent-harness --skill plan-eng-review-sanjanb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-eng-review
Source: https://github.com/sanjanb/my-agent-harness/tree/main/skills/gstack-plan-eng-review
Command: npx skills add https://github.com/sanjanb/my-agent-harness --skill plan-eng-review-sanjanb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering plans often contain hidden architectural flaws, missing edge cases, or weak test coverage that only surface during implementation. This Skill performs an engineering-manager-style review of your plan or design doc before you start coding, catching structural issues early. ## Core Features & Use Cases - Architecture & Data Flow Review: Walks through the plan's architecture, diagrams, and data flow with opinionated recommendations. - Edge Case & Test Coverage Analysis: Examines edge cases, performance implications, and test coverage gaps in the plan. - Interactive Decision Briefs: Presents issues one by one via structured AskUserQuestion decision briefs with recommendations and completeness scores. - Use Case: You have a design doc for a new feature and are about to start coding. Invoke the review to lock in the plan, resolve open architecture questions, and confirm test strategy before writing any code. ## Quick Start Ask the agent to run an engineering review on my implementation plan before I start coding.

Frequently Asked Questions about plan-eng-review

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

FAQPage Schema
How do I review an architecture plan before coding?

Invoke the plan-eng-review skill with your plan or design doc in context. It walks through architecture, data flow, edge cases, and test coverage interactively, presenting each issue as a decision brief with an opinionated recommendation.

What does an engineering plan review cover?

The review covers architecture, data flow, diagrams, edge cases, test coverage, and performance. Each identified issue is presented interactively with a recommendation so you can lock in the plan before implementation starts.

When should I run a plan review in my workflow?

Run it after drafting a plan or design doc and before writing code. It is designed to catch architecture issues early, and the gstack ecosystem suggests it as the step between planning skills like /spec and shipping skills like /ship.

Does plan-eng-review work in headless or CI sessions?

Interactive prompts require an interactive session. In headless sessions the skill reports BLOCKED when a question cannot be asked, and in spawned sessions it auto-chooses recommended options and reports results as prose.

What are the limitations of automated plan review?

The review quality depends on the completeness of the plan or design doc provided. It cannot validate runtime behavior or actual code, so it complements rather than replaces code review and QA testing after implementation.