vsdd

Design verifiable system architectures with verification gates and ADRs.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/kvithayathil/agent-resources --skill vsdd-kvithayathil
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vsdd
Source: https://github.com/kvithayathil/agent-resources/tree/main/skills/vsdd
Command: npx skills add https://github.com/kvithayathil/agent-resources --skill vsdd-kvithayathil

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, python3, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill eliminates the risk of system architectures that fail to meet requirements, have unverified structural flaws, or miss critical quality attributes like security and scalability until after costly implementation work.

Core Features & Use Cases

  • End-to-End Design Workflow: Guides you through eliciting requirements, defining verifiable design criteria, building architectures with verification gates, and recording Architecture Decision Records (ADRs).
  • Comprehensive Verification Checks: Includes built-in checklists for structural soundness, quality attributes (performance, reliability, security, scalability, cost, compliance), failure analysis, and observability.
  • Self-Improving Methodology: Automatically updates itself with lessons learned from real design work to catch recurring anti-patterns and verification gaps over time.
  • Use Case Example: Use this Skill when designing a new microservices-based order processing system to verify service boundaries, data consistency, and failure isolation before writing any implementation code.

Quick Start

Use the vsdd skill to design a verifiable microservices architecture for the new order processing system, including all verification criteria and ADR templates.

Frequently Asked Questions about vsdd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify system design decisions against quality attributes before implementation?

You can verify system design decisions by applying built-in checklists for quality attributes like performance, reliability, and security. This approach guides you through defining verifiable design criteria and building architectures with verification gates to catch structural flaws early.

What is the best way to document architecture decisions to prevent production failures?

The best way to document architecture decisions to prevent production failures is by recording Architecture Decision Records (ADRs). This process ensures traceable, requirement-aligned architectures with built-in verification gates for structural soundness and failure resilience.

How do I design and verify service boundaries for a microservices architecture?

To design and verify service boundaries for a microservices architecture, use an end-to-end workflow that defines verifiable design criteria. It applies built-in verification checks for data consistency, failure isolation, and structural soundness before writing implementation code.

Do I need python3 and gh installed to run verification-driven system design workflows?

Yes, you need python3, gh, and jq installed to run verification-driven system design workflows. These dependencies support the scripts required to elicit requirements, execute verification gates, and record Architecture Decision Records.

Can a system design workflow automatically catch recurring anti-patterns over time?

Yes, a system design workflow can automatically catch recurring anti-patterns over time through a self-improving methodology. It automatically updates itself with lessons learned from real design work to identify verification gaps and prevent unverified structural flaws.