特定のルールに基づいたディレクトリ階層から、SwaggerのYamlファイルを結合して出力する。Json)は最終的には1つのファイルとして扱わないといけないが、何も考えずにそれに乗っかるとファイルが肥大化して管理しづらくなる。そのためYamlを分割して結合するのが良く、npmにも既にそれを実現するライブラリも豊富にある。そのどれもが$refを使う方式で、これだとファイルをどの単位で分割するかのルールが無いので、もうちょっと仕組み的に縛りたかった。Yamlファイルが生成されるライセンスMITあとがき今回紹介したように手運用でSwaggerのYamlを生成するのは基本的にはオススメしない。Yaml職人が出る可能性がある(属人化)チーム全体で管理していく仕組み作りなどが必要になるそういった意味では自社開発のAPIにリクエストを投げる場合であればメンテの効率を上げるためにサーバー側で書かれたコードから自動生成させるのが良いだろう。手運用は果たして意味が無いのかと言うと状況によってはそんなこともない。このようなケースには使えると思われるプロジェクトがスタートした直後でサーバー側の準備ができていない場合モックサーバーとして活用する本格的な運用はサーバー側ができたらそっちでやるのが良さそう別会社・別チームのプロダクトなどそもそもSwaggerの連携が難しい場合このような感じでケース・バイ・ケースだと思うので、もし何らかの理由で手運用の管理が必要になった場合はこのフレームワークを使うと良いかもしれない。