design-partner

Refine software architecture, requirements, and design decisions through structured collaborative analysis.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/dsonyy/dotfiles --skill design-partner-dsonyy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-partner
Source: https://github.com/dsonyy/dotfiles/tree/main/skills/design-partner
Command: npx skills add https://github.com/dsonyy/dotfiles --skill design-partner-dsonyy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineers often jump into code before a design is fully understood, leading to vague entities, missing contracts, and conflicting requirements. This Skill acts as a thinking partner that pressure-tests your architecture, requirements, and tradeoffs before implementation begins. ## Core Features & Use Cases - Design Model Building: Structures your thinking across conceptual, runtime, storage, contract, and operational models. - Decision Recording: Captures decisions with context, consequences, rejected alternatives, and reversibility in an ADR-style format. - Risk Surfacing: Identifies duplicated sources of truth, unclear ownership, migration issues, and observability gaps. - Use Case: You are designing a new notification service and are unsure where retry state should live. Use this Skill to clarify core entities, define ownership boundaries, and record the tradeoffs before writing any code. ## Quick Start Ask the assistant to act as a design partner and review your proposed architecture for a new service, focusing on core entities, contracts, and risks.

Frequently Asked Questions about design-partner

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

FAQPage Schema
How do I review a software architecture before writing code?▼

Use a design partner workflow that clarifies the problem, distills requirements, builds conceptual and runtime models, and pressure-tests core entities. Record each decision with context, consequences, and rejected alternatives so tradeoffs stay explicit.

How to write an ADR for a technical decision?▼

An ADR captures the decision, its context, consequences, rejected alternatives, and reversibility. This Skill applies that structure to meaningful choices during design discussions without imposing a full framework.

What is the difference between RFC, ADR, and C4 models?▼

RFCs support discussion before commitment, ADRs record individual decisions with consequences, and C4 separates abstraction levels into context, container, and component views. This Skill borrows small pieces from each only when helpful.

When should I not use a design partner approach?▼

Skip it when the task is a small, well-understood change with no ambiguous entities or contracts. The Skill deliberately avoids writing code, mutating files, or producing implementation plans unless explicitly requested.

Can this Skill generate implementation code from a design?▼

No. It intentionally does not write code, create implementation plans, or mutate files unless the user explicitly asks. Its scope ends at a validated design model with decisions, risks, and open questions.