How does the SYS-Ready score work?

It is a maturity metric ranging from 0-100% that measures decision completeness, architecture clarity, and implementation readiness. A score of 90% or higher is typically required to progress to the SYS phase.

Does it support visual diagrams?

Yes, it mandates the use of Mermaid diagrams for architectural flows and component responsibilities to ensure clarity over text-only descriptions.

Why does this skill require upstream artifacts?

To ensure strict traceability, the skill verifies the existence of BRD, PRD, EARS, and BDD documents so that every architectural decision is justified by a specific business or product requirement.

What is Layer 5 in the doc-adr workflow?

Layer 5 represents the Architecture Decision Records (ADR) phase, where specific technical decisions are documented after high-level requirements (Layers 1-4) are finalized but before system specifications (Layer 6) begin.

ADR Documentation Generator

Name: ADR Documentation Generator
Author: vladm3105

byvladm3105

•

Learning & Documentation

Automates the creation of Architecture Decision Records (ADR) with standardized impact analysis and full traceability.

The doc-adr skill is a specialized tool for Layer 5 of the SDD workflow, enabling developers to document architectural decisions with rigorous structure. It follows the Context-Decision-Consequences format and ensures that every technical choice is linked to upstream business and product requirements. By utilizing a unique SYS-Ready scoring system and mandatory Mermaid diagrams, this skill ensures that architectural decisions are mature, validated, and ready for system-level implementation, maintaining a perfect audit trail for long-term project maintenance.

Key Features

01Automated lifecycle management including Proposed, Accepted, and Superseded states

02Enforced Mermaid diagram integration for visual architectural clarity

03Mandatory upstream artifact verification (BRD, PRD, EARS, BDD)

04Standardized 17-section ADR structure for comprehensive technical records

05SYS-Ready maturity scoring to gate transition to implementation

061 GitHub stars

Use Cases

01Formalizing technology stack selections with documented trade-offs and rationale

02Validating technical readiness before proceeding to system requirement specifications

03Creating an immutable audit trail for architectural shifts in complex software projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vladm3105/aidoc-flow-framework doc-adr

For use in Claude.ai and ChatGPT

Download Skill