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.

About

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

Automated lifecycle management including Proposed, Accepted, and Superseded states
Enforced Mermaid diagram integration for visual architectural clarity
Mandatory upstream artifact verification (BRD, PRD, EARS, BDD)
Standardized 17-section ADR structure for comprehensive technical records
SYS-Ready maturity scoring to gate transition to implementation
1 GitHub stars

Use Cases

Formalizing technology stack selections with documented trade-offs and rationale
Validating technical readiness before proceeding to system requirement specifications
Creating an immutable audit trail for architectural shifts in complex software projects

About

Key Features

Automated lifecycle management including Proposed, Accepted, and Superseded states
Enforced Mermaid diagram integration for visual architectural clarity
Mandatory upstream artifact verification (BRD, PRD, EARS, BDD)
Standardized 17-section ADR structure for comprehensive technical records
SYS-Ready maturity scoring to gate transition to implementation
1 GitHub stars

Use Cases

Formalizing technology stack selections with documented trade-offs and rationale
Validating technical readiness before proceeding to system requirement specifications
Creating an immutable audit trail for architectural shifts in complex software projects