update-design

Evaluate ADRs and design documents on four criteria and output a score with prioritized improvements.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Solves the problem of inconsistent ADRs and incomplete design documents by providing a structured evaluation and actionable tasks.

Core Features & Use Cases

  • Structured scoring: evaluates ADRs, functional design docs, and plan files on four criteria and outputs a final score.
  • Improvement planning: generates a prioritized todo list to address gaps and contradictions.
  • Quality assurance: performs a final consistency check to ensure no contradictions or omissions before release.

Quick Start

Run the evaluation workflow on the target file path (e.g., docs/adr/20240101_example.md) to obtain a score and improvement items.

Frequently Asked Questions about update-design

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

FAQPage Schema
How do I evaluate an ADR for structural completeness and logical consistency?▼

To evaluate an ADR for structural completeness and logical consistency, run the evaluation workflow on the target file path to generate a final score and a prioritized improvement list.

What is the best way to review functional design docs before release?▼

The best way to review functional design docs before release is to apply a four-criterion scoring system covering structural completeness, logical consistency, implementability, and coverage, followed by a final consistency check.

How do I generate actionable improvement tasks for incomplete design documents?▼

You generate actionable improvement tasks for incomplete design documents by running an automated review that identifies gaps and contradictions, outputting a prioritized todo list to address specific issues.

Can I use this design doc review process for plan files across repository teams?▼

Yes, you can use this design doc review process for plan files across repository teams, as it applies to ADRs, functional design docs, and plan files during post-creation reviews and updates.

What criteria are used to score design documents for quality assurance?▼

The criteria used to score design documents for quality assurance are structural completeness, logical consistency, implementability, and coverage, which together produce a final score and highlight necessary improvements.

When do I need a structured evaluation for architecture decision records?▼

You need a structured evaluation for architecture decision records when solving the problem of inconsistent ADRs, ensuring no contradictions or omissions exist before release through a final consistency check.