plan-eng-review

Guide engineering plan reviews through scope, architecture, risk, and decision logging.

48|2|Updated Dec 23, 2017
One-click install
npx skills add https://github.com/g4rcez/dotfiles --skill plan-eng-review-g4rcez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-eng-review
Source: https://github.com/g4rcez/dotfiles/tree/main/.ai/skills/plan-eng-review
Command: npx skills add https://github.com/g4rcez/dotfiles --skill plan-eng-review-g4rcez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines engineering plan reviews by guiding participants through a consistent, decision-focused workflow that captures assumptions, tradeoffs, and risks.

Core Features & Use Cases

  • Structured Scope Challenge prompts to align goals and constraints for a project.
  • Architecture, data-flow, and edge-case review checklists that surface risks early.
  • ASCII diagrams and plan artifacts that document decisions for future audits.
  • Built-in tradeoff logging and decision-record generation to accompany PRs or design docs.
  • Collaborative prompts to facilitate productive discussions in meetings or async reviews.

Quick Start

Initiate the plan-review workflow to start with the Scope Challenge.

Frequently Asked Questions about plan-eng-review

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

FAQPage Schema
How do I structure an engineering plan review for a large architectural rewrite?

Structure an engineering plan review by guiding scope definition, architecture discussion, risk assessment, and decision logging. This enforces a disciplined review flow with explicit criteria, ASCII diagrams, and artifact generation to support audits.

What is the best way to document engineering decisions and tradeoffs for a design doc?

Document engineering decisions and tradeoffs using built-in tradeoff logging and decision-record generation. These artifacts accompany PRs or design docs, capturing assumptions and risks to ensure traceability.

Can I use ASCII diagrams to visualize data-flow and edge cases during a code review?

Yes, you can use ASCII diagrams to visualize data-flow and edge cases during a code review. Built-in architecture and data-flow checklists surface risks early, while diagrams document decisions for future audits.

How do I facilitate an async engineering plan review with a remote team?

Facilitate an async engineering plan review using collaborative prompts that drive productive discussions. The structured Scope Challenge aligns goals and constraints, ensuring consistent documentation across distributed participants.

Does this engineering plan review framework work for feature upgrades or only large projects?

This engineering plan review framework works for both feature upgrades and large architectural rewrites. It applies a consistent, decision-focused workflow that captures assumptions, tradeoffs, and risks across any scale.

When should I not use a structured engineering plan review workflow?

Avoid a structured engineering plan review workflow for trivial changes requiring no architecture discussion or risk assessment. The framework enforces a disciplined flow with explicit criteria, adding overhead to simple updates.