When does this skill recommend creating an Architecture Decision Record (ADR)?

An ADR is mandatory for changes involving 6+ files, contract system modifications (like nesting levels or responsibility changes), data flow shifts, or introducing new external dependencies.

What documentation templates are included in this skill?

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

How does the Design Document handle change impact?

The criteria require a Change Impact Map that explicitly identifies direct impacts, indirect impacts, and areas with no ripple effect to ensure safe code modifications.

How does it help with task management and implementation?

It generates structured Work Plans divided into four essential phases: Foundation Implementation, Core Feature Implementation, Integration Implementation, and a mandatory Quality Assurance phase.

Does this skill support visual documentation via diagrams?

Yes, it mandates specific Mermaid diagrams for each document type, such as User Journey diagrams for PRDs and Data Flow diagrams for Design Documents.

Documentation Criteria & Standards

Name: Documentation Criteria & Standards
Author: Tahir-yamin

byTahir-yamin

•

콘텐츠 관리

Enforces standardized technical documentation workflows by providing templates and decision matrices for PRDs, ADRs, Design Docs, and Work Plans.

This skill equips Claude with a rigorous framework for technical documentation, ensuring that every architectural decision and product requirement is properly captured throughout the development lifecycle. It provides a logic-based decision matrix to determine exactly when documents like ADRs or Design Docs are required based on change complexity, file count, or architectural impact. By utilizing standardized templates and requiring specific Mermaid diagrams, it helps engineering teams maintain a high-quality knowledge base, track implementation phases with a mandatory QA stage, and mitigate risks through thorough impact analysis and interface mapping.

주요 기능

01Standardized templates for PRDs, Architecture Decision Records (ADRs), and Design Docs

02Automated document requirement detection based on change complexity and file count

03Mandatory ADR triggers for contract system changes, data flow shifts, and external dependencies

04Integrated technical impact mapping and Mermaid diagram requirements for visual documentation

05Structured Work Plan generation with a required 4-phase quality assurance framework

063 GitHub stars

사용 사례

01Drafting comprehensive Architecture Decision Records when introducing new frameworks or changing storage logic

02Reviewing technical design documents to ensure they include required interface matrices and impact maps

03Determining which technical documents are required before beginning a new feature implementation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tahir-yamin/dev-engineering-playbook documentation-criteria

For use in Claude.ai and ChatGPT

Download Skill