coupling-design-advisor

Evaluate design candidates with a 3D coupling model and generate ADR-ready documentation.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/ebal5/agent-skills --skill coupling-design-advisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coupling-design-advisor
Source: https://github.com/ebal5/agent-skills/tree/main/skills/coupling-design-advisor
Command: npx skills add https://github.com/ebal5/agent-skills --skill coupling-design-advisor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

設計時(事前)の対話型アドバイザ。候補案を3次元(統合強度・距離・変動性)で評価し 均衡度を比較、推奨案と ADR 形式の出力を返す。

Core Features & Use Cases

  • 発火条件(以下のドメイン語のいずれかを含むときにのみ発火する): 「結合バランス」「均衡結合」「均衡度」「3 次元モデル」(本スキル固有の用語 — 必須条件)、 上記語のいずれかを伴う以下の文脈: 「新しいマイクロサービスの境界を引きたい」「モジュール分割/統合」「サブドメイン境界」の設計判断、 「イベント駆動 vs 直接呼び出し」の結合バランス評価、「結合バランスで設計レビューしたい」という明示的依頼。
  • 発火しないケースのカバー: 「A案 vs B案 どちらが良い」のみの一般的技術選定・UI/DB 設計を伴わない、既存コードの計測 → coupling-audit(未実装)、純粋な実装タスクへの適用外。
  • 出力は、均衡結合モデルに基づく推奨と ADR 形式の記録を提供。
  • 将来のケーススタディ参照を想定した参考情報の保持と再利用。

Quick Start

Describe your design boundary scenario to the advisor and obtain an ADR-ready recommendation.

Frequently Asked Questions about coupling-design-advisor

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

FAQPage Schema
How do I evaluate microservices boundary design options objectively?

To evaluate microservices boundary design options objectively, you apply a 3D coupling model that scores integration strength, distance, and variability. This approach generates objective scores, a recommended option, and ADR-ready documentation.

What is the best way to compare event-driven vs direct call architecture choices?

Comparing event-driven vs direct call architecture choices is best handled by scoring each candidate against a coupling-balance framework. This evaluates integration strength, distance, and variability to recommend an option with objective justification.

How does a 3D coupling model work for software architecture decisions?

A 3D coupling model works for software architecture decisions by quantifying design choices across three dimensions: integration strength, distance, and variability. It applies these dimensions to score candidate designs and output an ADR-ready recommendation.

When do I need a coupling balance framework for module partitioning?

You need a coupling balance framework for module partitioning when defining new microservice boundaries or comparing subdomain boundary designs. It provides an interactive design advisor to evaluate design options and generate objective ADR documentation.

Can I use this approach to review existing code coupling measurements?

No, you cannot use this approach to review existing code coupling measurements. The design advisor specifically targets early-boundary design and comparing candidate designs, while measuring existing code requires a separate coupling audit process.