What is the benefit of the dual storage model?

The dual storage model uses PR comments for the interactive user interface while local files in the .review directory provide persistence and version control for review data.

How are Architecture Decision Records (ADRs) matched to code?

ADRs are matched to changed files via module boundaries defined in the project's CLAUDE.md file, ensuring relevant standards are applied to the correct parts of the codebase.

Does this skill block pull requests from being merged?

No, the skill is advisory only. It provides reports and recommendations to guide developers but does not act as a hard quality gate for merging code.

Can this skill modify my existing project plans?

No, the quality strategy skill is designed to be read-only regarding project plans and will not modify plan documents or task statuses.

What is a spec-driven review?

It is a review process where checklists are derived directly from technical plans and architecture decision records rather than ad-hoc judgment, ensuring alignment with project goals.

Principled Quality Strategy

Name: Principled Quality Strategy
Author: alexnodeland

byalexnodeland

•

コラボレーションツール

Implements specification-driven code review workflows by aligning pull request checks with project standards and architecture decision records.

The Quality Strategy skill integrates the Principled methodology into Claude Code, enabling a sophisticated, specification-driven approach to code reviews. It empowers Claude to generate checklists derived from plan acceptance criteria, assess review coverage against Architecture Decision Records (ADRs), and produce structured summaries that ensure every code change is traceable to its original requirement. By utilizing a dual-storage model and module-scoped ADR relevance, this skill helps maintain high software quality and architectural consistency without enforcing rigid, automated blocking of development workflows.

主な機能

013 GitHub stars

02Specification-driven checklist generation

03Traceable review coverage reporting

04ADR compliance tracking for changed files

05Dual storage integration for PR comments and local files

06Severity classification (blocking, important, advisory)

ユースケース

01Auditing changed files against project architecture decision records

02Generating comprehensive PR review checklists from technical specifications

03Producing structured review summaries for complex pull requests

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled quality-strategy

For use in Claude.ai and ChatGPT

Download Skill