plan-eng-review

Define an end-to-end plan review workflow capturing architecture, data flow, edge cases, tests, and risk tradeoffs.

Updated Dec 13, 2017
One-click install
npx skills add https://github.com/dogeared/tnra --skill plan-eng-review-dogeared
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-eng-review
Source: https://github.com/dogeared/tnra/tree/main/.claude/skills/gstack/plan-eng-review
Command: npx skills add https://github.com/dogeared/tnra --skill plan-eng-review-dogeared

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan reviews often fail to converge on a concrete execution plan. This Skill provides a structured approach to capture architecture decisions, data flow, edge cases, and test coverage in one place, so teams can align quickly and move forward with confidence.

Core Features & Use Cases

  • Structured review prompts for capturing architecture, data flows, risk assessment, and tradeoffs.
  • Decision-ready outputs with actionable recommendations, acceptance criteria, and follow-up tasks.
  • Use cases include engineering design sessions, architecture reviews, and lock-in meetings before coding begins.

Quick Start

Propose a plan review for the current feature by summarizing the architecture, data flow, and test strategy in a single, concise plan document.

Frequently Asked Questions about plan-eng-review

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

FAQPage Schema
What is an engineering plan review and why is it needed before coding begins?

An engineering plan review captures architecture decisions, data flow, and test coverage to align teams. It is needed to prevent plan reviews from failing to converge on a concrete execution plan before development starts.

How do I structure an architecture review to surface tradeoffs and risks?

Structure an architecture review using prompts that capture data flows, risk assessments, and tradeoffs. This approach produces decision-ready outputs with actionable recommendations, acceptance criteria, and follow-up tasks for the next sprint.

How do I document edge cases and test coverage during a design review?

Document edge cases and test coverage during a design review by summarizing the architecture and test strategy in a single plan document. This structured approach ensures all critical data flows and risks are captured.

Can I use ASCII diagrams for data flow documentation in my architecture plan?

Yes, you can use ASCII diagrams for data flow documentation when helpful. Including diagrams in your architecture plan helps visualize data flows and supports clear communication of edge cases and risk tradeoffs.

What is the best way to lock in an execution plan with concrete acceptance criteria?

The best way to lock in an execution plan is to run a structured review that defines scope, assesses risks, and outputs actionable recommendations. This ensures alignment on acceptance criteria and concrete follow-up tasks.

When should I avoid using a structured engineering plan review workflow?

You should avoid a structured engineering plan review if your request lacks a defined scope. The workflow requires a clear scope to effectively capture architecture, assess risks, and generate actionable recommendations with tradeoffs.