api-and-interface-design

Design stable, well-documented interfaces that are hard to misuse. Good interfaces make the right thing easy and the wrong thing hard. This applies to REST APIs, GraphQL schemas, module boundaries, component props, and any surface where one piece of code talks to another.

Define the interface before implementing it. The contract is the spec — implementation follows.

Don't mix patterns. If some endpoints throw, others return null, and others return { error } — the consumer can't predict behavior.

API、モジュール境界、またはパブリック インターフェイスを設計するときに使用します。 REST または GraphQL エンドポイントを作成する場合、モジュール間の型コントラクトを定義する場合、またはフロントエンドとバックエンド間の境界を確立する場合に使用します。 ソース: addyosmani/agent-skills。