reviewing-design-docs

Automate structured design document reviews against Lyft tech spec templates.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cyarie/cyarie-claude-plugin --skill reviewing-design-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-design-docs
Source: https://github.com/cyarie/cyarie-claude-plugin/tree/main/skills/reviewing-design-docs
Command: npx skills add https://github.com/cyarie/cyarie-claude-plugin --skill reviewing-design-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews of design documents can be inconsistent and time-consuming. This skill provides a structured, repeatable process that surfaces gaps, aligns with Lyft tech spec templates, and facilitates a clean handoff to milestone planning.

Core Features & Use Cases

  • Structured four-phase review: Format verification, Section-by-Section review, Iterative updates, and Handoff.
  • Task-tracking integration with dedicated checkpoints for each section to ensure coverage and accountability.
  • Supports the open questions workflow and provides traceable handoff instructions for milestone planning.

Quick Start

Run the design-review workflow on your design document with the command /review-and-validate-design

Frequently Asked Questions about reviewing-design-docs

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

FAQPage Schema
How do I automate design document reviews to surface gaps before handoff?

Automating design document reviews involves running a structured workflow that verifies format, evaluates sections iteratively, and tracks open questions. This process enforces evidence-based criteria across Summary, Background, Goals, Non-Goals, Plan, Milestones, Measurable Impact, and Open Questions to ensure alignment.

What is the best way to align a design doc with the Lyft tech spec template?

Aligning a design doc with the Lyft tech spec template requires a section-by-section evaluation against evidence-based criteria. A structured review process guides you through format verification, iterative updates, and handoff to ensure all required sections like Milestones and Measurable Impact are covered.

How do I track open questions and task ownership during a design review?

Tracking open questions during a design review requires task-tracking integration with dedicated checkpoints for each section. This ensures coverage and accountability by assigning ownership to open questions and enforcing defined handoff steps for milestone planning.

Can I review design documents at any abstraction level using a structured process?

You can review design documents at any abstraction level using a structured four-phase process. The review applies format verification, section-by-section evaluation, iterative updates, and handoff to identify gaps and ensure alignment with tech spec templates.

Does the design review process support milestone planning and handoff?

The design review process supports milestone planning through defined handoff steps. After format verification, section-by-section review, and iterative updates, it provides traceable handoff instructions and integrates task-tracking to transition directly into milestone planning.

Why should I use a structured workflow for design doc validation instead of manual checks?

Structured design doc validation prevents inconsistent and time-consuming manual checks by enforcing evidence-based criteria across all sections. A repeatable four-phase process surfaces gaps, tracks open questions, and ensures clean handoff to milestone planning.