design-delta

Generate a delta design rationale from delta specs and architecture notes.

1|1|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/asermax/claude-plugins --skill design-delta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-delta
Source: https://github.com/asermax/claude-plugins/tree/main/katachi/skills/design-delta
Command: npx skills add https://github.com/asermax/claude-plugins --skill design-delta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta design documentation is often under-detailed or inconsistent, making it hard for teams to align on design decisions. This skill automatically crafts a complete delta design rationale by analyzing delta specs, architecture notes, ADRs, and existing designs to produce a coherent, actionable design document.

Core Features & Use Cases

  • Structured delta design: generates a comprehensive rationale for delta decisions, constraints, and dependencies.
  • Spec-consistent updates: detects drift between delta specs and current designs and suggests refinements.
  • Collaborative rationale: summarizes trade-offs, risks, and justification to share with ADRs, DES patterns, and stakeholders.

Quick Start

Provide a complete delta design by analyzing the delta spec and current documentation.

Frequently Asked Questions about design-delta

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

FAQPage Schema
How do I document a delta design rationale from a delta specification?▼

To document a delta design rationale, provide a delta spec located at docs/delta-specs/$ARGUMENTS.md. The skill analyzes dependencies, ADRs, and wireframing guidance to generate a complete delta design doc.

What is a delta design rationale and why do I need it?▼

A delta design rationale explains and documents the decisions, constraints, and trade-offs for a delta. It is needed to align teams on design decisions and prevent under-detailed or inconsistent documentation during delta planning and review.

How do I detect drift between delta specs and current designs?▼

To detect drift between delta specs and current designs, use delta design documentation to compare spec requirements against existing designs. It identifies inconsistencies and suggests refinements to ensure spec-consistent updates.

Can I use ADRs and wireframes to generate a delta design document?▼

Yes, you can generate a delta design document using ADRs and wireframes. The skill reads architecture notes, ADRs, and wireframing guidance alongside delta specs to produce a coherent rationale summarizing trade-offs and risks.

Does generating a delta design require any specific file structure?▼

Generating a delta design requires access to delta specs located at docs/delta-specs/$ARGUMENTS.md. The skill reads this path to analyze dependencies and existing documentation to output the design doc.

What's the best way to summarize design trade-offs for stakeholders?▼

The best way to summarize design trade-offs for stakeholders is through a collaborative delta design rationale. It documents trade-offs, risks, and justifications to share directly with ADRs, DES patterns, and stakeholders.