Does this skill include specific templates?

Yes, it provides standardized templates for Product Requirements Documents (PRD), Architecture Decision Records (ADR), Technical Design Documents, and Work Plans.

Does this skill help with task management?

Yes, it includes Work Plan criteria that breaks down implementation into four phases: Foundation, Core Feature, Integration, and a mandatory Quality Assurance phase.

How does this skill determine which documents I need?

It uses a creation decision matrix based on the number of files changed (e.g., 6+ files require an ADR and Design Doc) and specific architectural triggers like contract or data flow modifications.

What is an ADR and when is it required?

An Architecture Decision Record (ADR) records the rationale behind technical choices. This skill mandates one for changes to nested contracts, storage locations, external dependencies, or complex logic.

Documentation Quality Standards

Name: Documentation Quality Standards
Author: shinpr

byshinpr

•

Learning & Documentation

Standardizes technical documentation workflows by enforcing specific criteria for PRDs, ADRs, Design Docs, and Work Plans based on project complexity.

The documentation-criteria skill empowers Claude to manage the technical lifecycle of a project through structured documentation. It provides a decision matrix that determines whether a Product Requirements Document (PRD), Architecture Decision Record (ADR), Design Document, or Work Plan is necessary based on the scale of changes—such as the number of files modified or the complexity of data flow. By integrating standardized templates and automated triggers for documentation creation, it ensures that technical debt is minimized, decisions are recorded, and implementation plans are clear before a single line of code is written.

Key Features

01Automated documentation decision matrix based on code impact and file count

02Integrated Mermaid diagram requirements for visual architectural clarity

03Standardized templates for PRDs, ADRs, Design Docs, and Work Plans

04Mandatory ADR triggers for contract, data flow, and architecture changes

0535 GitHub stars

06Structured change impact mapping and interface change matrices

Use Cases

01Reviewing existing technical designs to ensure they meet quality assurance standards

02Determining which technical documents are required for a new feature request

03Automating the creation of work plans with defined quality assurance phases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add shinpr/claude-code-workflows documentation-criteria

For use in Claude.ai and ChatGPT

Download Skill