Overview

Overview

AIエージェントツールから利用されるユーティリティツールを集めたリポジトリです

技術仕様

• runtime: bun
• testing: bun test
• formatter: biome bun run format

作業ルール

• 日本語で応答する
• ドキュメント作成は日本語で行う
• コメントは日本語でつける
• コードは常にメンテナンス製とテスト容易性を最も重要視する
• タスクは常に逐次実行する。並列化は行わない
• 時間の節約・開発スループットよりも、確実とトレーサビリティを優先する
• 後方互換性や例外処理のために処理を複雑にせず、シンプルで唯一の正解のために DRY な実装を行う
• コミットメッセージは必ず次の形式にする: <type>:<description> の1行目 + 空行 + 本文
  • type は fix / feat / docs / chore のいずれかを使う
• PR作成には gh を使う
  • 本文にバッククォートやシェル展開される文字列を含む場合を想定し、--body 直書きは避けて常に --body-file を使う
  • 作成後は gh pr view --json url,title,body で本文崩れがないことを確認する

Folder Rule

• @src/ - Bunのコード本体
  • lib.ts - 外部公開用の型定義・エクスポートなど
  • utils/ - 内部で仕様するユーティリティ関数
  • registory/ - tools に追加したツール定義を格納する
  • sandbox/ & security/ - Agentが実行するツール機能を制限するガードレール機構
  • tools - ツール機能の本体。機能ドメインごとにフォルダを分ける
• @test/ - テストコードを格納する

Definition of Done

• scripts/sanity.sh を実行し、型エラー・フォーマット・全件テストが全てパスすること