plan-eng-review

Coordinate and document engineering plan reviews before code changes.

55|8|Updated Jul 21, 2021
One-click install
npx skills add https://github.com/Actual-Chat/actual-chat --skill plan-eng-review-actual-chat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-eng-review
Source: https://github.com/Actual-Chat/actual-chat/tree/main/.claude/skills/plan-eng-review
Command: npx skills add https://github.com/Actual-Chat/actual-chat --skill plan-eng-review-actual-chat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps engineering managers conduct thorough, enforceable plan reviews before making code changes, aligning teams on scope, architecture, and risk.

Core Features & Use Cases

  • Interactive scope challenges with guided questions to surface tradeoffs and decisions
  • ASCII diagrams and structured data flows to communicate design clearly
  • Documentation of decisions, action items, and ownership for PRs and handoffs
  • Opinionated recommendations and prompts to confirm direction before coding

Quick Start

Run plan-eng-review on your PR to begin an interactive scope-and-design review.

Frequently Asked Questions about plan-eng-review

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

FAQPage Schema
How do I conduct an engineering plan review before writing code?

An engineering plan review challenges scope and architecture decisions interactively before coding begins. It uses guided questions to surface tradeoffs, document action items, and align teams on data flows and design risks.

What is the best way to document architecture tradeoffs and decisions for a pull request?

Documenting architecture tradeoffs for a pull request requires structured prompts that force explicit decisions on edge cases and performance. Interactive reviews generate diagrams and ownership records to satisfy scoped design requirements.

How do I create ASCII diagrams for data flows during a technical design review?

Creating ASCII diagrams for data flows during a technical design review clarifies architecture and system boundaries. Structured plan reviews generate these diagrams interactively to communicate design scope and surface edge cases.

Can I use interactive prompts to challenge engineering scope and surface edge cases?

Yes, interactive prompts can challenge engineering scope by asking targeted questions about architecture and test coverage. This guided approach forces explicit tradeoffs and confirms direction before development starts.

Does a structured plan review help enforce test coverage and performance questions?

A structured plan review enforces test coverage and performance questions by applying opinionated recommendations to the proposed architecture. It ensures teams address data flows and edge cases before code changes are approved.

When do I need an opinionated plan review for architecture decisions?

You need an opinionated plan review for architecture decisions when aligning teams on scope and risk before code changes. It provides structured guidance to evaluate tradeoffs, document ownership, and confirm direction for handoffs.