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.