CLI Tech Stack

CLIツール開発で使用する技術スタックと規約の定義。

技術スタック

全て必須。指定バージョン以上の最新版を使用すること。

TypeScript 規約

• anyの使用禁止
• interfaceではなくtypeを使用（既存ライブラリ型の拡張時のみ例外、コメント必須）
• barrel import/exportの禁止
• 無駄なオプション・デフォルト値を設定しない

スクリプト規約

• Bunで実行可能なTypeScriptファイルとして作成
• シェバン設定で単体実行可能にする

# OK
./hoge.ts

# NG
bun run hoge.ts

コード品質

• 関数型スタイルを意識（map/filterを優先、array.pushを避ける）
• fail fast原則
• 暗黙のフォールバック禁止
• ダミーコード・NO-OP実装の禁止

ダミーコード・NO-OPの例

// NG: 何もしない関数
function doSomething() {
  // TODO: 後で実装
}

// NG: 常にtrueを返す検証
function validate(input: string): boolean {
  return true; // 実際の検証なし
}

// NG: エラーを握りつぶす
try {
  riskyOperation();
} catch {
  // 何もしない
}