docs: "APIデザイン ガイドライン"を追加

README.md

@@ -139,8 +139,7 @@ Issue 側で取り組み始めたことを伝えるか、最初に Draft プル
 
 ### Rust 以外の言語の API に関する方針
 
-VOICEVOX CORE の主要機能は Rust で実装されることを前提としており、他の言語のラッパーでのみの機能追加はしない方針としています。これは機能の一貫性を保つための方針です。
-各言語の特性に応じた追加実装（例えば、Python での `style_id` の [`NewType`](https://docs.python.org/ja/3/library/typing.html#newtype) 化など）は許容されます。
+[APIデザイン ガイドライン](./docs/guide/dev/api-design.md)をご覧ください。
 
 ## コアライブラリのビルド
 

docs/guide/dev/api-design.md

@@ -0,0 +1,15 @@
+# APIデザイン ガイドライン
+
+## Rust 以外の言語の API
+
+VOICEVOX CORE の主要機能は Rust で実装されることを前提としており、他の言語のラッパーでのみの機能追加はしない方針としています。これは機能の一貫性を保つための方針です。
+
+ただし機能追加ではない範囲で、各言語の習慣に適合するような変更は積極的に行っていきます。例えば:
+
+* [`AudioQuery`](https://voicevox.github.io/voicevox_core/apis/rust_api/voicevox_core/struct.AudioQuery.html)といったJSONで表現可能なデータ型は、Pythonなら[Pydantic](https://docs.pydantic.dev)、JavaScriptなら[Zod](https://zod.dev/)といったライブラリを使って表現すべきです。
+    * Rust APIとやりとりする際はJSONを介して変換します。
+* [`StyleId`](https://voicevox.github.io/voicevox_core/apis/rust_api/voicevox_core/struct.StyleId.html)といった[newtype](https://rust-unofficial.github.io/patterns/patterns/behavioural/newtype.html)は、そのままnewtypeとして表現するべきです。
+    * 例えばPythonなら[`typing.NewType`](https://docs.python.org/ja/3/library/typing.html#newtype)で表現します。
+* オプショナルな引数は、キーワード引数がある言語であればキーワード引数で、ビルダースタイルが一般的な言語であればビルダースタイルで表現すべきです。
+* 「範囲」を表すデータ型が言語レベルである場合は、可能な限りそのデータ型を用いてAPIを構成するべきです。
+    * 例えばSwiftやRubyでは`Range`という名のデータ型を使って表現します。