plan-eng-review

Review architecture plans for data flow, edge cases, and test coverage.

1|2|Updated Jan 4, 2024
One-click install
npx skills add https://github.com/NaKMiers/Port4lio --skill plan-eng-review-nakmiers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-eng-review
Source: https://github.com/NaKMiers/Port4lio/tree/main/.agents/skills/plan-eng-review
Command: npx skills add https://github.com/NaKMiers/Port4lio --skill plan-eng-review-nakmiers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps engineering teams lock in execution plans for architecture reviews, data flows, edge cases, tests, and performance before implementation.

Core Features & Use Cases

  • Interactive architecture reviews that walk through data flow, risk, and tradeoffs.
  • Opinionated recommendations to accelerate decisions and reduce rework.
  • Diagrams and artifacts for architecture, data flow, and test coverage.
  • Use case: run plan-eng-review before shipping a feature to surface gaps and validate assumptions.

Quick Start

Provide your architecture plan or design doc and I will walk through the plan, identify gaps, and propose improvements.

Frequently Asked Questions about plan-eng-review

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

FAQPage Schema
What is an architecture review and how does it help with execution planning?

An architecture review evaluates your execution plan to identify gaps in data flow, edge cases, and test coverage before implementation. It provides opinionated recommendations and structured diagrams to validate assumptions and reduce rework.

How do I review my architecture plan for edge cases and test coverage gaps?

Provide your architecture plan or design doc to walk through the plan interactively. The review identifies gaps in edge cases and test coverage, then proposes improvements using structured diagrams for data flow and performance.

Can I generate data flow diagrams during an architecture review?

Yes, architecture reviews generate diagrams and artifacts for data flow, test coverage, and architecture. These visual outputs help engineering teams evaluate tradeoffs and lock in execution plans before shipping features.

Does this approach work for performance planning across existing projects?

Yes, performance planning across projects is supported through interactive architecture reviews. The process walks through data flow, risk, and tradeoffs to provide opinionated recommendations that accelerate decisions for your existing systems.

What is the best way to surface gaps in a design doc before implementation?

The best way to surface gaps is running an interactive architecture review on your design doc. It walks through the plan to validate assumptions, identify missing edge cases, and propose improvements before you start implementation.

When should I avoid using an automated architecture review for execution planning?

You should avoid using automated architecture reviews when your design doc lacks sufficient detail for data flow analysis. Without baseline architecture plans or defined execution parameters, the review cannot accurately surface gaps or propose improvements.