ZARD - Yet another YARDoc.

ZARD

Yet another YARDoc.

pixiv Inc.

USAMI Kenta

2026-10-08 Proposals on Rails 2026

イタンジ株式会社 #roppongirb

お前誰よ

• うさみけんた (@tadsan) / Zonu.EXE / にゃんだーすわん
• ピクシブ株式会社 Platform Div > WebTechnology Team PHPer
• 2012年末から現職、APIとかCIとかいろいろなところを見つめてきました
• 最近チームが再編されてインフラっぽい仕事もしてます
• Emacs PHP Modeを開発しています (2017年-)
• プログラミング言語にちょっとこだわりのある素人 (spcamp2010)

はじめましての方ははじめまして

便利なので使ってください

今回はその話ではない

現代の生成AIは大規模言語モデル

コーディングエージェントがいかに賢く振る舞っても確率からは逃れられない

モデルが持っている常識

×プロジェクトの雰囲気

水は低きに流れる

AIは常識を振りかざす前例主義者

何が言いたいか

大規模言語モデル

生成AIは言語であれこれ語りたがる

コメントが多いプロジェクトは自然に雄弁になる

プログラミング言語

自然言語

コメントはコードで表現できない行間を補う機能

パラメータ名で表現しきれない構造の評価

歯止めを掛けないとAIはコードにポエムを書き散らす

ポエマーになる

コードにはあくまで行間を書いてほしい

シンプル

型なし

完全な散文よりも構造化形式で書いておきたい

Rubyでは歴史的にいろんなフォーマットがあった

RD

RDoc

Yay! A Ruby Documentation Tool

rbs-inline (method)

rbs-inline (Doc style)

RubyMine

Rigorの思想

人間に冗長な型をわざわざ明記させない

型推論してRBSを生成してガードレールにする

必要以上に詳細に型を書かせない

AIでちょんとセットアップすれば静的解析できる！

Rubyに型を書きたくないのにDocに型を書かされる

ZARD

Yet another YARDoc.

pixiv Inc.

USAMI Kenta

2026-10-08 Proposals on Rails 2026

イタンジ株式会社 #roppongirb

型は @rbsまたは #: に書く

型は @rbsまたは #: に書く

@param @returnにはコメントだけを書く

型は @rbsまたは #: に書く

@param @returnにはコメントだけを書く

@extrbs という怪しい型も書ける

なぜrbs-inlineに一本化できないのか

• # @rbs は、あくまで型情報に -- でコメントを載せる記法
• 主役は型だと認識している
• #: はRBS系エコシステムだけでなくSorbetも読み取るので、

RBS仕様外の型情報を載せるのはあまりよくない

• Pythonの型宣言も実行時に読み飛ばされるが、ツールごとの非互換に弱い
• # @extrbs にRigorのRBS::Extendedをコメントに載せられる

作り始めたばかりなので乞うご期待