review-dr

Review Decision Records for rationale, alternatives, constraints, consequences, and decision criteria.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/novel-jp/projsight-plugin --skill review-dr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-dr
Source: https://github.com/novel-jp/projsight-plugin/tree/main/skills/review-dr
Command: npx skills add https://github.com/novel-jp/projsight-plugin --skill review-dr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reviews Decision Records for clarity, completeness, and decision quality, helping teams turn vague documentation into actionable, well-justified records.

Core Features & Use Cases

  • Intent-focused review: Evaluates why the decision was needed, what was decided, and how strong the justification is.
  • Structured scoring: Scores six dimensions including context, alternatives, constraints, consequences, and decision criteria.
  • Actionable feedback: Produces concrete improvement suggestions and optional add-on text when sections are missing.
  • Use cases: Review a specific DR by number or ID, inspect recent DRs, or batch-review all proposed records while excluding design documents that belong elsewhere.

Quick Start

Ask the Skill to review a specific DR or the most recent records and return a scored assessment with clear improvement suggestions.

Frequently Asked Questions about review-dr

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

FAQPage Schema
How do I review a Decision Record for completeness and rationale gaps?

To review a Decision Record, evaluate its context, alternatives, constraints, consequences, and decision criteria, then apply structured scoring to identify rationale gaps and generate actionable improvement recommendations for documentation quality.

What is structured scoring for architecture decision records?

Structured scoring for decision records is a quality assessment method that evaluates six dimensions including context, alternatives, constraints, consequences, and decision criteria to measure documentation completeness and decision justification.

How do I batch-review all proposed decision records while excluding design documents?

Batch-reviewing proposed decision records involves inspecting all records, detecting and excluding out-of-scope design documents, then returning scored assessments with concrete improvement suggestions for each valid decision record.

Can I assess the quality of recent decision records without reviewing every single one?

Yes, you can inspect recent decision records to evaluate their quality by applying structured scoring across six dimensions to identify gaps in rationale, alternatives, and constraints without reviewing the entire repository.

What should be included in a decision record to pass a quality assessment?

A decision record should include clear context, evaluated alternatives, documented constraints, identified consequences, and explicit decision criteria to pass a quality assessment and receive high scores across all six dimensions.

When should I not use automated decision record review for documentation?

Automated decision record review should not be applied to design documents that belong outside decision workflows, as the process specifically detects and excludes out-of-scope design documentation to maintain focus on architecture and process decisions.