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.