design-doc-review-bottleneck

Reviews design documents to identify scaling bottlenecks, single points of failure, and architectural risks.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/pulak999/ai-tooling --skill design-doc-review-bottleneck-pulak999
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-doc-review-bottleneck
Source: https://github.com/pulak999/ai-tooling/tree/main/ai-assistant-kit/cursor-skills/design-doc-review-bottleneck
Command: npx skills add https://github.com/pulak999/ai-tooling --skill design-doc-review-bottleneck-pulak999

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design documents often hide scaling issues, single points of failure, and architectural impossibilities that only surface in production. This Skill conducts a formal Senior Staff Engineer-style review to expose those risks before implementation begins. ## Core Features & Use Cases - Bottleneck Identification: Analyzes proposals for hidden scaling issues, SPOFs, and infeasible implementation details under Google-scale constraints like tail latency, CAP tradeoffs, and resource efficiency. - Structured Risk Output: Produces a risk assessment table with severity and category ratings, plus a required revisions section explaining why each issue fails at scale and suggesting alternatives. - Socratic Review Style: Uses probing questions (e.g., "What happens when the daemon restarts mid-operation?") to guide authors toward their own realizations rather than lecturing. - Use Case: Before approving a new distributed caching service proposal, run this review to surface backpressure propagation gaps and p99 latency risks the author overlooked. ## Quick Start Review this design document for scaling bottlenecks, single points of failure, and architectural risks, and present the findings as a risk assessment table with required revisions.

Frequently Asked Questions about design-doc-review-bottleneck

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

FAQPage Schema
How do I review a design doc for scaling issues?

Review a design doc for scaling issues by analyzing tail latency (p99, p99.9), consistency versus availability tradeoffs, and resource efficiency under load. This Skill automates that review as a Senior Staff Engineer, producing a risk table and required revisions.

What should a design doc review checklist include?

A design doc review checklist should cover single points of failure, backpressure propagation, behavior under partial failure, tail latency of the slowest path, and resource growth with load. The Skill applies these checks using Socratic questioning.

Can this review system architecture proposals before implementation?

Yes, the Skill is designed for pre-implementation review of design docs, system proposals, and architecture plans. It flags unfeasible implementation details and explains concretely why they would not work at scale.

What output does a design doc bottleneck review produce?

The review produces a risk assessment table with severity and category columns, plus a required revisions section. Each critical risk includes the issue, why it fails at scale, and a suggested alternative direction.

When is a bottleneck-hunting design review not the right approach?

This review style targets large-scale distributed system proposals where tail latency and failure modes matter. For small internal tools or prototypes without scale constraints, a lightweight correctness and maintainability review is more appropriate.