公式AIルール一覧/コーディング

コーディング

ミューテーションテストのツールを、今のコードとテストを見て直す

ミューテーションテストのツールのコードを直す時に使う。先に今のコードとテストを確かめ、処理の順番や遅延処理を崩さず、壊れた変異を作らないミューテーターと、変異を見逃さないテストを書き、安全なレビュー・CI・リリースの手順で進める。

層に分かれたデスクトップアプリに機能を足し、全部のビルドでテストする

コア・デスクトップのホスト・WebのUIに分かれたデスクトップアプリをAIに直させる時に使う。決まりはコアに置き、ツールが触れるコマンドとフォルダを絞り、オプション機能を実際の依存関係で切り分け、対応する全部のビルドでテストしてから完了にする。

低レベルなシステムのパッチで、細かい書き方より本当のバグを見つける

ドライバーや通信のライブラリなど、低レベルなシステムのコードのパッチをレビューする時に使う。メモリ・ロック・エラー時の流れを追い、整数の幅、スレッド、暗号、APIの変更を確かめ、直し方つきの指摘だけを出す。書き方の指摘はかなり確かな時だけにする。

拡張できるGoサービスに機能を足し、設定が上書きされても通るテストを書く

下流のビルドで名前や設定が変えられるGoのサービスを直す時に使う。ログにトレースのつながりを残し、新しいツールを正しいグループに登録し、設定の上書きがあっても公開の動きをテストして、生成される文書も直す。

別のWebフレームワークと同じ動きをする互換レイヤーを作る

別のWebフレームワークの動きを、複数のランタイムで同じように作り直す時に使う。先にそのフレームワークのテストを移し、リクエストの処理順とランタイムの境目を守り、ファイルパスの書き方をそろえ、全部のチェックに通ったpull requestだけでマージする。

マネージドのwrapperとネイティブライブラリを、ABIを壊さずに直す

ネイティブのCライブラリを包む、クロスプラットフォームのマネージドwrapperを直す時に使う。変更をすべての層で追い、古いダウンロードではなくソースからネイティブバイナリをビルドし、公開ABIを保ち、ポインターの所有とスレッドを正しく扱い、失敗するテストを飛ばさない。

JITでコンパイルするGPUカーネルライブラリに、カーネルを足してテストする

使う時にコンパイルする(JIT)GPUカーネルライブラリを、AIに直させる時に使う。カーネルを全部の層に通して足し、生成したファイルは書き込める場所にだけ置き、GPUの種類ごとにテストし、結果が正しいかを確かめてから速さを測る。

複数プロトコルの連携ゲートウェイを、権限チェックを壊さず開発・レビューする

複数のプロトコルをつなぐゲートウェイを、AIに直させたりレビューさせたりする時に使う。プロジェクトの検査を通し、権限チェックを厳しく保ち、トレースと監査ログの書き込みを分け、マイグレーションを慎重に作り、pushの前に許可を待つ。

非同期Rustのサービスを、キャンセルや失敗に強く作る

非同期Rustでサービスを作る時に使う。モックで済ませず本物のコードを最後まで書き、エラーとキャンセルを安全に扱い、利用者が使う本物のサービスの入口からテストし、全部のチェックを通してから完了を伝える。

多言語のデータライブラリを、ファイル形式とAPIを壊さずに直す

ネイティブコアと各言語の薄いバインディングでできた、速いデータライブラリをAIに直させる時に使う。安定版のファイル形式と公開APIの互換を守り、決められたコマンドを使い、テストと文書もそろえる。

データを複製するETLのコードを、値を勝手に変えず、データを外に出さずに作る

データベースの間でデータを複製するコードを作る・直す時に使う。変更を小さく保ち、丸めなどで値が黙って変わるのを防ぎ、おかしな入力では落ちずにエラーを返し、秘密情報や行の中身をログに書かず、テストが本当に動いたかを確かめる。

デバイス自動化ツールのコードを直し、実機で動きを確かめる

複数のプラットフォームで動くデバイス自動化ツールをAIに直させる時に使う。変更を小さく保ち、コマンドの情報を1つのレジストリにまとめ、変更に合ったテストを選び、作り直したビルドで実機やシミュレーターの動きを確かめてから報告させる。

大きな型付きモノレポを、AIに壊さず直させる

複数のパッケージがあるコードベースをAIに直させる時に使う。変更を受け持つパッケージを見つけ、共有ユーティリティを使い回し、ビルドと型の決まりを守り、影響するパッケージだけをテストして、実際に通した確認だけを報告する。

データベースのストレージエンジンを、速さと互換性を崩さずに直す

データベースのストレージエンジンのコードをAIに直させる時に使う。エラーと並行処理の正しい扱い、ベンチマークで確かめてから速くするやり方、API・ファイル形式・ビルドの互換性の守り方を決め、再現できるテストが通ってから変更を承認させる。

共有ワークツリーで、ほかの作業を壊さずに、どのOSでも動くCLIを作る

ほかのセッションも使うワークツリーで、コマンドラインのツールを作る時に使う。今のワークツリーの中だけで作業し、ほかの変更を消さず、データの出力と人向けの表示を分け、どのOSでも通るテストを書き、スナップショットや文書を最新に保つ。

root権限なしで動くコンテナツールを、ロックとダウンロードの確認つきで作る

root権限なしで動くコンテナツールを作る時に使う。変更中のコンテナにロックをかけ、ダウンロードしたイメージのレイヤーを全部確かめ、ホストの設定をコンテナへ持ち込まず、プロセスツリーごと止め、バックアップの復元で危ないパスをはじく。

AIのレビューと修正を自動で回すツールを、ユーザーのコードを失わずに作る

AIがコードのレビューと修正を裏で回すツールを作る・直す時に使う。先にビルド定義と担当を書いた文書を読み、信頼できないブランチの設定でコマンドを動かさせず、動いているジョブを守り、危ないpushやリリースを止める。

AIエージェントのスキルを書き、本当に効くかをテストで確かめる

AIエージェントのスキル集にスキルを足す・直す時に使う。名前とバージョン、ちょうどよい時に呼ばれる説明文、最小限のツールの許可、スキルあり・なしで比べるテスト、リリース前の確認を決める。

フレームワークのモノレポに、テスト付きの小さな変更を入れる

AIにフレームワークのモノレポのコードを直させる時に使う。先におおもとの手引きファイルを探し、変更を1つの動きに絞り、直す前に失敗するテストを書き、触った所のセキュリティ・ビルド・リリースノートを確かめる。

ワークフローを動かす大きなPythonモノレポを、AIに壊さず直させる

ワークフローを動かす大きなPythonモノレポで、AIにコードを直させる時に使う。スケジューラー・ワーカー・データベースの役目の分け方を守り、依存関係を正しいパッケージに置き、変えた動きのテストから始め、差分を全部見直してからプルリクエストを出す。

同期・非同期のクライアントライブラリを、APIを壊さずそろえて直す

同期版と非同期版がそろった、長く使われているクライアントライブラリをAIに直させる時に使う。公開APIとエラーの動きを変えず、両方に同じ変更を入れ、よく通る処理を遅くせず、失敗するテスト1つから全マトリクスまで順にテストする。

AIエージェントの記憶サービスを、ユーザーごとの記憶を混ぜずに作る

AIエージェントの長期記憶サービスを作る・広げる時に使う。メモリバンクごとに記憶を分け、取り込み・検索・推論を分けたうえで、データベースのマイグレーション、APIクライアントの更新、別のモデルに判定させるテスト、テナントやバンクごとの設定までそろえて進める。

分散ジョブ基盤のモノレポを、本物のサービスでテストしながら直す

分散ジョブ基盤のモノレポをAIに直させる時に使う。パッケージごとに合うチェックを選び、本物のデータベースやキューでテストし、リリースの記録を付け、ローカルでタスクを最後まで動かして、何を確かめて何を省いたかを報告する。

ドメイン駆動(DDD)の.NETモジュールを、レイヤーと公開APIを壊さずに作る

ドメイン駆動設計で作るモジュール式の.NETアプリを、AIに書かせたり直させたりする時に使う。今あるやり方に合わせ、レイヤーの依存を一方向に保ち、集約・リポジトリ・DTOを正しいレイヤーに置き、対応するすべてのデータベースで、今の利用者を壊さないかテストする。

複数ブラウザ向けの拡張機能を、シークレットを漏らさず、保存データを壊さずに直す

いくつものブラウザ向けに出す拡張機能を直す時に使う。シークレットを手元だけに置き、依存関係を変えたら安全用のポリシーを作り直し、保存データの形を変えたら番号付きのアップグレードを足し、合う層でテストし、Gitの操作は頼まれた時だけ行う。

分散で動く機械学習の学習・推論のコードを、壊さずに直す

機械学習のモデルを、たくさんのプロセスやアクセラレータで学習・推論させるコードを直す時に使う。危ない変更の前に確認を取り、重みのバージョンをそろえ、すべてのランクで集合通信を同じ順に呼ばせ、設定の互換性を守り、飛ばしたテストを報告する。

コンテナのログとメトリクスをリアルタイムで流すWebアプリを開発する

バックエンドとシングルページのフロントエンドでできた、コンテナのログとメトリクスを流すアプリを直す時に使う。層の分け方、ストリームの上限、ログイン方式とデプロイモードを崩さずに、機能を全部の層へ足し、決まったテストを回し、短いレビューを書く。

一般に配るサーバーパッケージを、拡張して使う側を壊さずに直す

ほかのコードがフックで拡張して使う、一般に配るサーバーパッケージを直す時に使う。秘密情報を入れず、コールバック・フック・ミドルウェアの順番を壊さず、古いマイグレーションは直さず新しく足し、パッケージに実際にあるテストとlintを回す。

多くの環境で動く古いCのプロジェクトを、互換性を壊さずに直す

古いコンパイラや多くのプラットフォーム、機能の組み合わせで動き続ける必要があるCのコードを、AIに直させる時に使う。関係する構成のビルドとテストを行い、書き方・メモリ・コミット・文書・リリースの決まりを守り、1つずつ単独で通る小さなパッチにまとめる。

バックエンドとフロントエンドが同居するリポジトリを、ビルドを壊さずに直す

API・バックエンド・フロントエンドが1つにまとまったリポジトリをAIに直させる時に使う。モジュールごとのルールを読み、両側の変更をそろえ、APIクライアントは手で直さず作り直し、変えた所に合ったテストを回し、マイグレーションや依存関係の追加の前に聞く。

複数言語の大きなデータ基盤モノレポを直し、プルリクエストを用意する

いくつもの言語で書かれた大きなデータ基盤のコードを、AIに直させる時に使う。正しいGitブランチを選び、自動で作られるファイルは手で直さず、いちばん小さいテストベースを使い、変えた所だけをビルド・テストし、失敗したCIを全部調べ、pushやプルリクエストの前に許可を取る。

Ansibleのインフラ自動化を、セキュリティを弱めずに作りレビューする

AIにAnsibleのplaybookなどのインフラ自動化を書かせる・直させる時に使う。lintとセキュリティ検査を警告ゼロで通し、パスワードや鍵をリポジトリに置かず、ネットワークは下の層から調べ、テストがバグを見つけられる事を確かめ、実際に行った検査だけを報告させる。

大規模なPythonデータ処理システムを、遅延実行を壊さずに直す

並列計算などをする大きなPythonのデータ処理コードをAIに直させる時に使う。変更する層を先に調べ、グラフを組む途中で計算を走らせず、近いテストから順に確かめ、許可なしにリリースやパッケージの公開をしない。

先に仕様を書き、テストから始める小さな単位で作っていく

仕様書や計画がある開発で、あいまいな依頼からAIにコードを書かせる時に使う。分からない点を質問として記録して答えを待ち、仕様と計画を直し、失敗するテストを先に書き、変えたファイルに合うチェックをかけ、データベースを守り、分かりやすい引き継ぎを残す。

アクセシビリティ検査エンジンのルールを、合格・不合格・判定不能で返すよう作る

Webのアクセシビリティ検査エンジンで、AIにルールを足したり直したりさせる時に使う。DOMと依存関係の層を分け、HTMLとARIAのデータを1か所から読み、Shadow DOMも含む実物に近いページでテストし、翻訳をそろえ、互換性を壊さないように進める。

実際のコマンドとフラグから、AIエージェント向けのコマンドスキーマを作る

AIエージェントに、どんなコマンドがありどう呼ぶかを伝えるスキーマを作る時に使う。レビュー済みのコマンド一覧と実際のコマンドから一方向で作り、全コマンドの対応、例、安全と確認の情報が正しいかを確かめる。

モジュールに分かれたJavaのプロジェクトで、互換性を壊さず小さく直す

モジュールに分かれたJavaのプロジェクトをAIに直させる時に使う。先にビルドとCIの決まりを調べ、古いJavaのバージョンとモジュールの依存関係を壊さず、合ったレベルでテストし、広い変更や壊す操作の前には聞いて止まる。

多言語向けIaCライブラリに、今の利用者を壊さずに機能を足す

型付きのIaCライブラリで、ほかの言語向けのバインディングを自動で作っている時に使う。機能を合う層に置き、バインディングで表せない書き方を避け、動きの変更は機能フラグで守り、権限をせまく保ち、ドキュメントとテストを足す。

Goサーバーに、セキュリティを弱めずにモジュールを足す

機能を足していけるGoサーバーで、機能を作る時やレビューする時に使う。モジュールを作る所から片付けまでの順で書かせ、設定ファイルを厳しく読み取り、Linux・macOS・Windowsでテスト・リンター・ビルドを通してからマージし、プルリクエストは人に任せる。

ネイティブとWebで動くTypeScriptアプリを、リポジトリの決まりどおりに作る

ネイティブとWebの両方で動くTypeScriptアプリを作る・直す時に使う。リポジトリのスクリプトとフォルダの分け方に従い、共有のコンポーネントを使い回し、画面の文字を翻訳できる形にして、関係するすべてのプラットフォームでテストしてから終える。

データベースからUIまで、フルスタックのリポジトリを互換を崩さず直す

バックエンドからフロントエンドまであるリポジトリをAIに直させる時に使う。先にリポジトリの指針を読み、データベースのキーとマイグレーション、APIのフィールドの互換を守り、共有部品と翻訳用のファイルを使い、実際に通した確認だけを報告する。

失敗したE2Eテストを、本物のブラウザで見ながら直す

E2Eテストが失敗した時に使う。成功の見え方を決め、本物のブラウザで動かし、スクリーンショットやコンソールのエラーを集め、原因をテスト・コード・環境に分け、いちばん小さく直して、合格するか止める条件に来るまでやり直す。

チャットや課題管理から依頼を受けるコーディングエージェントのサービスを作る

コードホスト・課題管理・チャットから仕事を受けるコーディングエージェントのサービスを作る時に使う。メイン・レビュー・分析の役割分け、スレッドごとのサンドボックス、ミドルウェアの順番、CIの失敗を自動で直す仕組みのオン・オフを決める。

GoのAPIとReactのSPAを、OpenAPIの仕様を先に直してから変える

GoのバックエンドとReactのSPAを、OpenAPIの仕様でつないでいるリポジトリで使う。生成ファイルを手で直さず仕様を直して作り直し、設定・エラー・ログイン・ダウンロード・更新を決まりどおりに扱い、テストしてから報告する。

テーマ対応のUIコンポーネントライブラリで、コンポーネントを作る・直す

使い回せるUIライブラリで、AIにコンポーネントを作らせる・直させる時に使う。変更が及ぶファイルを調べ、テーマの既定値・アクセシビリティ・右から左へ書く言語の表示を壊さず、テストとドキュメントまでそろえる。

ソフトウェアの案を、テスト済みのマルチエージェントシステムに仕上げる

複数のAIエージェントとツールが協力するシステムを作る時に使う。質問を1つずつして、役割とやり取りの設計の承認をもらい、依存関係の順に作り、5つの利用シナリオを合格するまでくり返し試す。

フルスタックのTypeScriptモノレポを直し、LLM機能は意味でテストする

LLM機能を持つTypeScriptのモノレポをAIに直させる時に使う。CIと同じパッケージ単位のチェックだけを回し、動きをテストし、個人の情報を広いログに残さず、LLMの答えを言い回しでなく意味で確かめる。

TypeScriptのフルスタックアプリを、サーバーとクライアント共通のAPIスキーマで作る

フルスタックのTypeScriptアプリを作る・直す時に使う。APIのリクエストとレスポンスをルートとクライアントのフックで共通のスキーマ1つにまとめ、入力を読む前に認証し、依存関係・キャッシュ・コンポーネントの見た目をそろえ、速いテストを書く。

フルスタックのモノレポで、共有パッケージを壊さずに変更を加える

アプリと共有パッケージが1つにまとまったモノレポをAIに直させる時に使う。変更を正しいモジュールに置き、生成されるバンドルを作り直し、組織ごとのデータを混ぜず、テスト結果つきのプルリクエストにまとめる。

高速なデータベースのコードを、速さと互換性を落とさずに直す

Java・SQL・Rust・ネイティブコード・CIにまたがる、速さ重視のデータベースをAIに直させる時に使う。コードの書き方、NULLの扱いとメモリの後片付け、クエリのテスト、失敗の調べ方、プルリクエストとビルドの決まりを示し、完了と言う前の最終チェックで締める。

わざと脆弱性を入れたセキュリティ練習用アプリを、チャレンジを壊さずに直す

学ぶためにわざと脆弱性を入れたアプリを直す時に使う。わざと入れたチャレンジとうっかりできた不具合を見分け、変更を小さく保ち、AIが作った余計なコメントを取り、決まったテストとセーフティネットを回し、修正用ファイルも合わせて直す。

C++の分析データベースエンジンを直し、必要なテストまで通す

C++で作られた分析データベースエンジンのコードを直す時に使う。SQLの解析から実行までの流れで直す場所を探し、生成ファイルは生成元のソースから作り直し、C++の書き方とエラー処理の決まりを守り、SQLロジックテストと必要なビルドを全部通してから終わりにする。

バグを、失敗するテストで再現してから最小の修正で直す

バグの報告を受けた時に使う。どの部分の問題かを分け、利用者に見える失敗をテストで再現し、本当の原因を突き止めて最小の修正をする。テストは再発の見張りとして残し、利用者と同じ手順で直ったかを確かめる。

レイヤー付き画像ファイルを、データを失わずに読み書きするライブラリを作る

レイヤー付き画像のバイナリ形式を扱うライブラリを作る・直す時に使う。低レベルの読み書きと利用者向けAPIを分け、セクションを順番どおりに読み、未知のデータを残し、レイヤーのグループを組み立て直し、読む・書く・読み直すテストで確かめ、自動の手順でリリースする。

開発者向けのセキュリティ文書を書き、レビューする

共有のリポジトリで、開発者向けのセキュリティ文書を書く時やレビューする時に使う。実際に読んだ情報源だけを引用し、対策が何を防ぎ何を防がないかを書き、変更を小さく保ち、リポジトリのチェックを通し、AIを使った事を書く。

大きなTypeScriptモノレポに、テストで確かめた小さな変更を加える

パッケージがたくさんあるTypeScriptのワークスペースをAIに直させる時に使う。先にリポジトリの構成とツールを調べ、変更に関わるビルドとテストだけを回し、生成ファイルには勝手に触れず、UnixとWindowsの両方で動くかを確かめる。

複数の実装があるモノレポを、動きをそろえたまま直す

同じ製品を複数の実装で作っている、大きな多言語のモノレポを変える時に使う。先にその場所の決まりを読み、利用者に見える変更を全部の実装へ同じように入れ、テストが使う物をビルドし直し、絞ったテストで失敗を全部調べ、リリースの記録を足し、変更リクエストを統合まで最新に保つ。

状態を持つUIライブラリを、今の利用者を壊さずに小さく直す

状態を持つブラウザ向けUIライブラリを、AIに直させる時に使う。状態の持ち主を見つけ、公開APIと保存済みデータの互換性を守り、先に失敗するテストを書き、単体テストか実ブラウザテストかを選び、終える前に差分とリリースノートを見直す。

公式SDKとCLIがそのまま動く、ローカルのクラウドエミュレーターを作る

クラウドの動きを手元のPCでまねるエミュレーターに、サービスや操作を足す時に使う。まず本物の通信プロトコルを調べ、要求と応答の形を本物のクラウドと同じに保ち、保存方式と設定を一緒に直し、公式SDKを使ったテストで確かめてからリリースへ進める。

エミュレータを、実機と同じバスとタイミングの動きで作る

エミュレータを作る・直す時に使う。ハードウェアの部品ごとにコードを分け、バスの読み書き・タイミング・DMAを実機どおりに再現し、実機で合格する参照プログラムでテストし、セーブステートと公開APIを安定させる。

小さなコード変更を、ローカルのテストとレビューで確かめながら進める

AIにコードを直させる時に使う。変える範囲と完了の確かめ方を先に決め、変更の前と後にローカルでテストを回し、今の差分をレビューして本当の問題だけを直し、最後に別のAIが続きから始められる引き継ぎ報告を残す。

多言語の自動化モノレポを、互換性を壊さずにAIに直させる

いくつもの言語のバインディングがある大きな自動化モノレポをAIに直させる時に使う。公開APIの互換性を保ち、固定のビルドツールで影響する最小の対象だけをビルド・テストし、ほかの言語のバインディングと同じ動きか比べ、影響の大きい共有部分を変える前に確認を求める。

生成ワークフローのアプリで、バックエンドとフロントエンドをOpenAPIでそろえる

素材から作業対象を取り出し、準備ページで確かめ、生成ワークスペースで生成を始めるアプリを直す時に使う。APIを変えるたびにOpenAPIの型を作り直し、画面ごとの役割と状態の種類を分け、architecture文書・plans・リリースノートを最新に保つ。

パッケージの多い大きなモノレポで、コードを直してテストする

パッケージがたくさんある大きなフレームワークのリポジトリで、AIに作業させる時に使う。直す前に作りを調べ、ビルドを最新にし、CIと同じモードでテストを選び、レビューより先にCIの失敗を直し、シークレットをログに出さず、変更ごとに確かめてから完了を伝える。

低水準のライブラリを、公開APIを壊さずに小さく直す

低水準のシステムライブラリをAIに直させる時に使う。変更は小さくし、頼まれない限り公開APIとABIを変えず、ビルドと変えたサブシステムのテストを動かし、メモリが足りない時も安全に失敗させ、リモートへのpushはしない。

複数パッケージのリポジトリを、今の動きを壊さずに変更する

パッケージがたくさんあるリポジトリをAIに直させる時に使う。どのパッケージが受け持つかとそこの決まりを確かめ、今の動きと公開名を残したまま、テストと文書を足し、依存関係を足す前に許可を取り、何を確かめて何のリスクが残るかを報告する。

静的解析(lint)のルールを、コードの動きを変えない自動修正つきで作る

静的解析(lint)のルールを作る時に使う。よくある書き方だけを対象にし、既存のヘルパーを使い回し、安全な時だけ自動修正を付け、まぎらわしい構文もテストし、生成される文書は手で直さず作り直す。

ロボットとAI向けのRust製データフロー基盤を、変更ごとに合うテストで開発する

ロボットとAI向けの、Rust製データフロー基盤をAIに直させる時に使う。通信の決まりをはっきり保ち、コミットごとに検査を通し、危なさに合わせて深いテストを選び、どのテストを実際に流したかを報告する。

バックエンドの変更で、アップロードやユーザー入力からの攻撃を防ぐ

アップロードされたファイル、ZIPやTAR、リクエストの値を扱うバックエンドのコードをAIに変えさせる時に使う。外から来るデータの行き先をたどり、使う前に検証し、似た処理の全部に同じ直しを入れ、セキュリティのチェックリストとlint・テストの合格で終える。

マルチテナントの自動化ツールを、テナントとエディションを混ぜずに作る

コミュニティ版・エンタープライズ版・ホスティング版があるマルチテナントの自動化ツールのコードを書く時に使う。クエリを正しいプロジェクトで絞り、外へのHTTP通信を安全なクライアントに通してSSRFを防ぎ、依存関係を使うワークスペースに書き、全部のエディションでテストしてから終える。

イベントで動くステートマシンを、動きを壊さずに作る・直す

ステートマシンのライブラリを作る・直す時に使う。1つのイベントを最後まで処理してから次へ進め、エラーが出ても後始末を飛ばさず、スレッドと子マシンを安全に保つ。先にテストを書いて同期・非同期の両方のエンジンで回し、コード・文書・スキーマをそろえる。

複数言語の大きなリポジトリを、必要なビルドとテストだけで直す

複数のプログラミング言語が混ざる大きなリポジトリでコードを直す時に使う。似たコードを先に調べ、使えるツールと実機を確かめ、変更が影響するビルドとテストだけを回し、マージ前に全部のCIを通し、確かめられなかった事も報告する。

JavaScriptとネイティブコードでできたWeb開発CLIを、担当する層を見つけて直す

JavaScriptとネイティブコードが混ざったWeb開発CLIを直す時に使う。CLIの動きを担当する層を見つけ、globalとlocalの両方のコマンドの通り道を確かめ、変更の種類に合ったテストを選ぶ。

アップロードした文書を読み込み、AIエージェントが検索できる仕組みを作る

PDFなどのファイルを取り込み、AIが検索できるサービスを作る時に使う。ファイルを形式に合ったパーサーへ回し、見出しと表を保ち、チャンクを決まった形で保存して、上限の中で検索し、出どころつきの根拠を返す。

秘密を断片に分けて預ける復旧ソフトを、オフラインで動くまま開発する

信頼できる人に鍵の断片を預け、オフラインで元に戻すソフトを直す時に使う。変更に関わる所を全部たどり、暗号の処理をコマンドラインとブラウザで共通にし、バンドルをオフラインで動くままに保ち、先にテストを書き、不安な人にも伝わる静かな文章を書く。

1つのAPIを複数の言語で使えるフレームワークを開発する

1つのコードから複数の言語向けのパッケージを作るフレームワークを開発する時に使う。プロセスの間のJSONのやり取り、公開してよい型、コードの生成、全部の言語で同じ動きになるかを確かめるテストの決まりを示す。

ツールで調べるAIエージェントを作り、でっち上げの答えを見抜くテストで確かめる

ツールを呼んで問題を調べるAIエージェントを作る時に使う。ツールはふだん読み取り専用にして返すデータの量を絞り、失敗の中身を正確に返し、設定の名前を変えても古い名前で動くようにし、実際に問い合わせないと分からない事実を聞くテストで確かめる。

リポジトリへの変更を、人が確かめて出せる形まで準備する

みんなで使うコードのリポジトリでAIに作業させる時に使う。プロジェクトの決まりに従い、保守担当者の許可を待ち、機密情報をコミットやテストに入れず、プルリクエストの文は人が送る下書きにする。

RustのAIフレームワークに、新しいAIプロバイダーやベクトルストアを足す

多くのAIプロバイダーに対応するRustのフレームワークを広げる時に使う。今あるtraitとbuilderに合わせ、WebAssemblyで動く形を保ち、フックがストリーミングの有無で同じ動きをするようにし、記録したテスト用のカセットにAPIキーが入っていないか確かめる。

複数OS向けのCLIダウンローダーにツールを足し、各バイナリを確かめる

リリース済みのバイナリをダウンロードするインストーラーに、コマンドラインツールを足す時やレビューする時に使う。OSとアーキテクチャごとの配布ファイルを調べ、ダウンロードURLを対応付け、版を固定したテストを書き、ダウンロードしたバイナリを1つずつ調べ、一覧表とプルリクエストの説明を更新する。

コンソールUIツールキットを最新の資料どおりに直し、実際の画面で確かめる

大きな書き直しがあったコンソールUIツールキットで作業する時に使う。昔のやり方ではなく今のリポジトリの資料に従い、テストを正しい場所に置き、動いている端末の画面を記録してUIの変更を確かめる。

大きな.NETのコードを、速さと互換性を保ったまま直す

広く使われるビルドエンジンのような、速さが大事な大きい.NETのリポジトリを直す時に使う。ホットパスで余計なメモリ割り当てを増やさず、新しい警告も壊れる変更として扱い、小さいビルドから順に確かめ、実行したビルド・テスト・サンプルを報告する。

RustのライブラリとCLIのワークスペースを、参照ツールと比べながら直す

ライブラリとCLIの両方に使う、Rustの複数crateのワークスペースをAIに直させる時に使う。失敗するテストから始め、参照ツールと結果を比べ、unwrap()を使わず、featureの組み合わせを全部テストする。

モバイルUI自動化フレームワークを開発し、不具合はCIでなく製品側で直す

クロスプラットフォームのモバイルUI自動化フレームワークをAIに開発させる時に使う。変更を受け持つモジュールに置き、動作を確かめられる一番安いテスト層を選び、必ず通るスイートとわざと失敗させるスイートを分け、CIの設定ではなく製品側で不具合を直す。

AIエージェントが調べられる、ローカルのコードグラフツールを作る

コードを解析してAIエージェント向けのグラフにまとめるツールを作る時に使う。構文木からのシンボルと関係の取り出し、複数のクライアントへの入れ方ときれいな外し方、エージェントが使いやすい検索の答え、実際のリポジトリとOSでのテスト、リリースの進め方を決める。

複数OS対応のツールチェーン管理ツールを開発し、レジストリへの登録を審査する

開発用ツールのバージョンを入れたり切り替えたりするツールを、AIエージェントに開発させる時に使う。リポジトリのタスクコマンドとモジュールの形に従い、ツールをレジストリに登録する前によく使われている証拠を集め、バージョンの順番は各バックエンドに任せ、OSごとに対象を絞ったテストを行う。

生成コードを含む複数モジュールのリポジトリを、許された範囲で直す

生成コードを含む、モジュールに分かれたリポジトリをAIに直させる時に使う。先にその場の指示を読み、生成ファイルではなく仕様を直し、モジュールごとにテストした小さく互換性のある変更にして、リリースやパイプラインは許可を持つ人に任せる。

AIモデルを評価する大きなTypeScriptのリポジトリを、直してテストする

CLI・Web・AIモデルの評価を持つ大きなTypeScriptのリポジトリで、AIに作業させる時に使う。近くのガイドを読み、変更を実際のCLIやブラウザーで確かめ、キャッシュやデータを消さずにデバッグし、ブランチとCIを通して変更を入れ、セキュリティを先にレビューする。

型付きのモノレポを壊さず直し、プロジェクトのWikiも最新に保つ

プロジェクトのWikiを持つ、型付きの大きなモノレポをAIに直させる時に使う。リポジトリが決めたコマンドを使い、古いビルド出力や起動スナップショットの問題を避け、必要なテストを走らせ、Wikiのページを根拠のファイルと結びつけて更新する。

Rustのリバースプロキシを、イベントループやセキュリティを壊さずに直す

マルチプロセスのRustプロキシをAIに変更・テスト・リリースさせる時に使う。ビルドとフィーチャーフラグ、エラーとログ、イベントループとプロトコルの動き、テストとファズ、セキュリティに関わるコード、プルリクエスト、リリースの手順の決まりを示す。

大きなプラットフォームのモノレポで、公開APIと使う側をそろえて変更する

コントロールプレーン・CLI・クライアントライブラリ・ドキュメントがそろった大きなモノレポをAIに直させる時に使う。各フォルダの決まりを先に読み、生成ファイルは正本のスキーマから作り直し、互換性を壊す変更の前に聞き、実行したチェックを報告する。

AIが作ったプルリクエストを、人のレビューを通してオープンソースに出す

AIがJavaのオープンソースのフレームワークにコードを出す時に使う。AIの作業だと明記し、直す前にコードの履歴を調べ、テストの固定スリープをなくし、プロジェクトのセキュリティの考え方に従い、人の承認の後にだけマージする。

AIのプロバイダーとモデルのカタログに、スキーマに合う形で項目を足す

AIのプロバイダーとモデルを集めたカタログに、AIで項目を足す・見直す時に使う。リポジトリのバリデーターを動かし、共通のモデル情報はコピーせずに引き継ぎ、推論の設定と価格は確かめた物だけを書き、同期しても出典が消えないようにする。

ビルドが重い大きなネイティブコードのリポジトリを、言語の境目を壊さず直す

ネイティブ言語、生成されるバインディング、時間のかかるビルドが混ざった大きなリポジトリを直す時に使う。変更の大きさに合わせて進め方を変え、一番小さいテストから回し、長いビルドのログは1回だけ取り、言語どうしの呼び出しを守る。

Webページから本文を取り出すツールを作り、消えた本文の原因を探す

ブラウザ・サーバー・コマンドライン・エッジで動く、Webページの本文を取り出すツールを作る・直す時に使う。本文を整える手順の順番を守り、取り除いた物を全部記録し、ページのHTMLからのスクリプト注入を防ぎ、先に失敗する小さなテストで直ったことを示す。

公開Goライブラリを、使う人のコードを壊さずに変える

ほかの人が使っている公開Goライブラリを変える時に使う。先に対応するGoのバージョンとブランチを確かめ、プロジェクトのツールでチェックとテストを回し、今のAPIの書き方に合わせて、テスト結果と互換性への影響を書いたpull requestを用意する。

手元の文書をキーワードと意味で探す検索CLIを作る

自分のPCの文書を探すコマンドラインツールを作る・直す時に使う。コレクションとコンテキストの管理、キーワード検索とベクトル検索の組み合わせ、返す量の上限、サービスとしての動かし方、テストとリリースの手順を決め、インデックスを変えるコマンドは利用者に任せる。

プロジェクトのドキュメントから、AIエージェント用のスキルを作って最新に保つ

プロジェクトのドキュメントや、上流のプロジェクトが出しているスキルから、AIエージェント用のスキルを作る時に使う。生成・同期・手書きのスキルを分けて扱い、短い索引と1つの話題だけの参照ファイルを書き、記録したリビジョンから変わった所だけを更新する。

データ処理ライブラリを、見つけやすいAPIと実データのテスト付きで作る

複雑な元データを扱いやすいオブジェクトに変えるライブラリを作る・直す時に使う。編集の前にコードの地図を作り、作業を課題として記録し、新しい機能ごとに実データの値のテスト、動く文書の例、分かりやすいエラーをそろえさせる。

複数パッケージのリポジトリでコードを直し、フォークからだけPRを出す

上流のリポジトリが読み取り専用の、複数パッケージのリポジトリでAIに作業させる時に使う。フォルダーごとの指示に従い、フォークにだけプッシュし、ユーザーの未コミットの変更を守り、Pythonのテストに誰が書いたかの印を付け、実際に走ったチェックの結果で報告させる。

グラフ検索とベクトル検索で、AIエージェントの長期メモリを作る

AIエージェントに会話をまたいで知識を覚えさせる仕組みを作る時に使う。ファイル・URL・テキストを検索できるグラフとベクトルのデータに変え、ユーザーごとにデータを分けて認証で守り、中心のコードを変えずに保存先やモデルのプロバイダーを入れ替えられるようにする。

グラフ型の認可サービスを、テストを先に書いて直す

グラフ型の認可サービスを直す時に使う。リクエストの通り道を追い、リポジトリのビルドターゲットとlintの決まりに従い、失敗するテストを先に書き、生成ファイルには手を入れない。

型付きのWebフレームワークを直し、データベース処理を3つの層に分ける

複数パッケージでできた型付きのWebフレームワークを直す時に使う。決められた開発環境の中で作業し、まず素早く、最後は全体をテストし、公開するモジュールを小さく保ち、データベース処理を層に分け、force-pushはしない。

AIのスキル文書を1か所で管理し、AIが探しやすい形で書く

AIのスキル用の指示文書を直し続ける時に使う。もとのファイルを1つに決めてほかはそこから作り直し、判断表を先に・詳しい中身は参照ファイルに置き、変更の前後でAIの動きを試して、バージョンは自動リリースで付ける。

複数のSQL方言に対応するコンパイラを、クエリの意味を変えずに広げる

SQLをASTに変え、別のデータベース向けのSQLに書き直すコンパイラを直す時に使う。先に受け持つ層を見つけ、方言が変わっても意味を保ち、SQLを文字列でなくASTの部品で組み立て、実際の実行と速さをテストする。

正しく呼び出され、チェックに通るエージェントスキルを作ってリリースする

エージェントスキルをまとめたリポジトリで作業する時に使う。説明文は「何をするか・いつ使うか」だけに絞り、メインのファイルを短くして詳しい中身を参照ファイルへ分け、バージョンと文書をそろえ、リリース前にチェックツールを通す。

スクリプトから複雑なCLIツールを動かし、成功をJSONのレポートで確かめる

スクリプトやコーディングエージェントで、複雑なCLIツールを動かす時に使う。先にタスクとクラスの一覧を確かめ、ライセンスが要るタスクはライセンスが無ければ止まり、入力とデバイスを全部指定して動かし、成功かどうかを進み具合の表示ではなく終了コードとJSONのレポートで判断する。

言語判定のリポジトリに、拡張子や新しい言語を足す

言語判定のリポジトリに、拡張子や言語をAIに足させる時に使う。実際のコードのサンプルと、拡張子がかぶる時のテスト付きの判定ルールを足し、生成ファイルはスクリプトで作り、変更提案を出す前に利用数とライセンスの証拠を確かめる。

文書を作るAIエージェントのアプリを、新旧2つのスタックを取り違えずに直す

文書を作るマルチエージェントのアプリで、古いスタックも残っているものをAIに直させる時に使う。本当の起動コマンドを探し、古い文書より実際のコードを信じ、設定の名前を変えずに保ち、PythonとNodeをまたぐ変更をたどり、意味のある最小のテストを回す。

モジュールで組んだネットワークサービスに、境界を守ってモジュールを足す

モジュールで組んだネットワークサービスを、AIに直させる・広げさせる時に使う。モジュール同士を共通のインターフェースだけでつなぎ、リポジトリのビルド方法とテストを使い、クライアントに見せても安全なエラーを返し、リクエストの間で状態を共有しないようにする。

証明書を自動で発行・更新するモノレポを、機密情報を守りながら直す

ACMEで証明書の申請・更新・デプロイをする、自分のサーバーで動かすツールをAIに直させる時に使う。変更を担当のパッケージやプラグインに収め、先にテストを書き、SQLのマイグレーションを付け、今あるUIの作り方に合わせ、証明書や秘密鍵をコードとログに残さない。

多くの言語向けのラッパーを作るコード生成器を、直してテストする

ネイティブライブラリの宣言から多言語のラッパーを作る、コンパイラ型のツールを直す時に使う。不具合が始まる処理段階をたどり、変更に合った大きさのテストを回し、回帰テストを足し、変更履歴を書く。

Webサイトの品質を見るAIエージェントのスキル集を作る

Webサイトの速さ・アクセシビリティ・検索での見つかりやすさ(SEO)を見るスキルを足す・直す時に使う。SKILL.mdの形と名前、短いファイル、直す前と後の例、エラーで止まるシェルスクリプト、使う人への影響の大きさで問題に順位を付ける決まりを示す。

フルスタックのリポジトリを、決まったコマンドとテストを守って直す

フロントエンド・API・SDK・CLI・データベースを持つリポジトリをAIに直させる時に使う。リポジトリのコマンドと固定された版を守り、層ごとの役目を分け、動作を担当する層でテストし、変えた画面とログインが要るAPIを確かめて、実行した確認を報告する。

機能ごとに要件・設計・タスクを書き、承認を得てから作る

仕様書をもとに、AIにソフトウェアを段階的に作らせる時に使う。プロジェクト全体の指針と機能ごとの仕様を分け、要件・設計・タスクを順に書いて人の承認を取り、実装後は別の目でレビューし、新しい検証結果で完了を確かめる。

フロントエンドの規則リポジトリで規則を書き、公開前に検査を通す

アクセシビリティ・性能・SEO・セキュリティなどのフロントエンド規則を集めたリポジトリを、AIが直す時に使う。各規則に必要なメタデータ、書く順番、測れるしきい値を決め、共有のUIはデザインシステムに置き、公開前に全部の検査を通す。

ビルドが厳しいリポジトリで、AIに警告ゼロのコードと正直な報告をさせる

ビルドの検査が厳しいリポジトリで、AIのコーディングエージェントを動かす時に使う。pushの前にビルドと検証を通し、コミットの決まりを守り、安全なコードを書き、すべての主張をコードと照らして確かめる。

大きなコードベースで、その場しのぎをせず原因を直し、公開APIの互換性を守る

AIに大きな多層のコードベースを直させる時に使う。ビルドのログを短く抑え、バグを上流の原因までたどって直し、自分の差分にその場しのぎのヘルパーが無いか見直し、分かりやすいプルリクエストを書く。

コンポーネントの多い大きなコードベースを、読みやすく壊さず直せる形に保つ

コンポーネントが多い大きなコードベースで、AIにコードを書かせる時に使う。コードの書き方、ファイルと変更の大きさ、コードレビューで見る所、テスト、APIの名前の付け方、ビルドの進め方の決まりを渡し、変更を小さく読みやすく保って、ほかの所を壊さないようにする。

AIに必要な所だけコードを直させ、危ない操作の前は人に確かめさせる

AIエージェントにプロジェクトのコードを直させる時に使う。先に変える範囲を決め、目的のあるコードと本当のバグを見つけられるテストだけを足し、ファイルを消す・プッシュ・本番のAPIを呼ぶ前に人に確かめ、最後に変えたファイルと実行したチェックを報告させる。

大きなコードベースで、テスト済みでレビューに出せる変更をAIに作らせる

AIエージェントに大きな多言語のコードベースを直させる時に使う。プロジェクトのラッパーコマンドでビルドし、テストは対象コードのそばに置いて変更前には落ちることを確かめ、レビューの決まりに従い、自分で実行して見た結果だけを報告させる。

今あるリポジトリで、頼んだ所だけをAIに直させ、迷ったら聞かせる

AIエージェントに今あるコードを直させる時に使う。分からない所は聞き、頼んだ所だけを変え、変えた所のテストと全体のテストを通してから「確かめた」と言い、頼まれない限りコミット・プッシュ・リリースをしない。

共有のコードベースに、メンテナーと合意した小さな変更を出す

オープンソースのライブラリなど、みんなで使うコードベースをAIコーディングエージェントに直させる時に使う。issueを読んで作業の範囲を聞き、メンテナーとの合意がまだなら先にissueや提案文を作り、修正を小さく絞ってテストとドキュメントも付け、プロジェクトのPRとコミットの決まりに従う。

AIコーディングエージェントに、リリースを壊さずブランチとコミットの決まりを守らせる

バージョン管理されたリポジトリでAIコーディングエージェントに作業させる時に使う。ブランチの切り方、テスト、コミットの書き方、一時ファイルの置き場所、どのAIツールでも動くエージェント向け指示の書き方を決め、リリースを壊さないようにする。

複数のプラットフォーム向けUIライブラリを、パッケージの層を守って保守する

複数のプラットフォーム向けに、層ごとのパッケージに分かれたUIライブラリで作業する時に使う。パッケージの層と公開済みのエクスポートを崩さず、外部サービスのアダプターを決まったファイル構成で作り、リリース・テスト・レビューの決まりを守る。

AIでオープンソースに貢献する時、ライセンスを守り、操作ごとに確認を取る

AIのコーディングアシスタントで、共有のオープンソースのコードに変更を送る時に使う。ライセンスが合わないコードを写さず、変更を小さくテスト済みに保ち、Issueやビルドのログの文を命令ではなくデータとして扱い、コミット・プッシュ・コメントの前に毎回確認を取り、貼られたコードは実行前に調べる。

JavaScriptを出すコンパイラとビルドシステムを、層ごとにテストしながら直す

JavaScriptを出すコンパイラのモノレポで、AIに作業させる時に使う。タスクランナーでビルドし、凍結された構文木の定義は変えず、手を入れた層ごとにテストを足し、新しいビルドオプションを最後まで通し、速さはリンターではなく実測で判断する。

大きなフルスタックのリポジトリで、AIエージェントに変更を出す時の決まりを守らせる

型付きのフロントエンドとバックエンドがある大きなリポジトリで、AIエージェントに作業させる時に使う。プッシュ前に pre-commit のチェックを通し、移行先の書き方でコードを書き、セキュリティの指摘はロールごとにできる事で判断し、テスト・ドキュメント・プルリクエストをプロジェクトの決まりどおりに仕上げる。

ほかのプロジェクトが継承するスマートコントラクトのライブラリを、壊さずに直す

ほかのプロジェクトが継承して使うスマートコントラクトのライブラリを、AIに直させる時に使う。その動きを持つファイルを直し、linterとプロジェクトのツールに任せ、今ある関数・イベント・ストレージレイアウトを変えず、暗号やアップグレードなどAIが間違えやすい所は自分で読み直して確かめる。

共有ライブラリやSDKを、公開APIを壊さずにAIに直させる

共有ライブラリやSDKのコードをAIに直させる時に使う。完了と言う前にテストとビルドの確認をすべて回し、今使っている人のために公開APIを守り、Gitのブランチやワークツリーを変える前に聞き、最後にプルリクエストの引き継ぎ文を出す。

大きなデスクトップのメディアアプリを、UIを止めずアンドゥを壊さず直す

ファイルやメディアを扱う大きなデスクトップアプリで作業する時に使う。重い処理をUIスレッドの外で動かし、キャンセルやエッジケースを扱い、アンドゥで正しく戻るようにし、実際に動かしたテストだけを報告する。

ブラウザ・サーバー・ネイティブで正しく動くCSS-in-JSライブラリを保守する

標準のCSSに沿ったCSS-in-JSライブラリの開発をAIに手伝わせる時に使う。スタイルを標準のCSSに限り、どのランタイムでも壊れない書き方、仕様を元に先にテストを書く進め方、リリースノートと資料の書き分け、本物のコードを動かすデモの作り方を決める。

FastAPIのサービスをAIに書かせ、よくある間違いをレビューで見つける

AIにFastAPIのサービスを作らせる時や、変更をレビューさせる時に使う。使うバージョンの下限、async と同期のルートの使い分け、Pydanticと依存関数の書き方、データベースとテストの決まりを示し、差分で見つけるべき間違いと直し方を表で出す。

TypeScriptのフロントエンドのモノレポで、パッケージの境目を守って作業する

モジュールに分かれたTypeScriptのフロントエンドで、AIに作業させる時に使う。パッケージの境目とフレームワークに頼らないコア、状態を持ち主経由で変える事、ファイルとテストの置き場所、コミット前のチェック、リリース手順、UIの層の分け方を伝える。

大きなリポジトリで、AIにコードを読んでから直させ、レビューを通してだけ変更を出させる

パッケージがたくさんある大きなリポジトリで、AIエージェントに作業させる時に使う。直す前にコード・依存関係・テストを読ませ、同じ事のやり方を1つにそろえさせ、信頼できないコードは手元で動かさず、共有のコードはレビューと承認を通してだけ変えさせる。

リポジトリを調べて直すAIエージェントに、共通の作業の決まりを渡す

AIエージェントが1つのリポジトリを自分で調べて直していく時に使う。共有メモに残す事、動く前に計画を出す場面、プッシュとシークレットの扱い、変更や自動化を完了と言う前の確かめ方を決める。

2つのランタイムで動くプラグイン式のデータパイプラインを、壊さず直す

2つのランタイムにまたがるプラグイン式のバックエンドで、AIにコードを直させる時に使う。バージョンを1つのファイルで管理し、テストの絞り込みを正しいタスクにかけ、プラグイン・並行処理・サービスのレイヤーの決まりを守り、新しいテストが変更なしでは失敗するかを確かめる。

低レベルのデバッガーを、テストを先に書き、ほかのOSを壊さず直す

多くのOSとバックエンドで動く、コンパイル言語向けのデバッガーをAIに直させる時に使う。先に失敗するテストを書かせ、OSごとのコードを別のファイルに分け、共有インターフェースを変える時は全バックエンドを確かめさせ、コミットメッセージをサブシステム名から始めさせる。

システム系のコードを、AIに型とエラー処理まで丁寧に書かせる

厳しい品質が求められるシステム系のコードでAIに手伝わせる時に使う。書いた時間の3倍以上かけて見直し、すべてのエラーの場合を扱い、決まりを型で表し、古い保存形式とも合うようにし、どれもビルドが通る小さなコミットに分ける。

AIエージェントのスキルとプラグインを、正しく読み込まれて発動するように作る

AIエージェントのスキルやプラグインを作って、レビューに出す時に使う。メタデータの正本を1つにし、ディレクトリの置き方、発動しやすい名前とdescriptionの書き方、速いフック、レビュー前に通すチェックリストを示す。

共有のプロジェクトへプルリクエストを出す前に、本当に要る変更かを確かめる

ほかの人が管理するプロジェクトへ、AIエージェントがプルリクエストを出す時に使う。問題が本当に起きたか、変更が本体に入るべき物か、人が差分の全体を見て承認したかを確かめ、メンテナーにすぐ閉じられる物は出さない。

層の分かれたアプリのリポジトリで、AIに頼んだ範囲だけ作業させる

フロントエンド・バックエンド・デスクトップ向けのビルドがあるアプリのリポジトリで、AIにコードを任せる時に使う。依頼を読むだけ・変更・ビルド・公開に分け、変えた場所ごとに走らせるチェックを決め、コミット・プッシュ・リリースや本物のデータに触る前には必ず聞くようにさせる。

型の厳しい関数型コードベースで、エラーを隠さずにコードを直す

型の厳しい関数型コードベースでAIに作業させる時に使う。コードの書き方、エラー型、サービスとレイヤー、スキーマ、ログ、UIコンポーネントの決まりを示し、型チェック・テスト・ビルドが通るまで完了と言わせない。

ユーザーの作業を失わせず、承認前のコードを動かさないコマンドラインツールを作る

すでにユーザーがいるCLIを、AIに作らせる・直させる時に使う。フラグと設定ファイルの互換性を守り、作業を壊す前にエラーで止め、プロジェクトのフックは承認の後にだけ動かし、すべてのサブプロセスを記録し、ネットの結果より先に手元の結果を出す。

大きな多言語のランタイムのコードを、今までの動きを壊さずに直す

ネイティブとスクリプトの両方で書かれ、パッチを当てた依存関係を中に持つ大きなランタイムのプロジェクトで使う。近くのガイドを先に読み、プロジェクトのビルド用ショートカットとテストターゲットを使い、独自の型と禁止事項を守り、動きの変更は互換性フラグの後ろに入れる。

データベースのインデックス拡張を、テストを通し、クラッシュに強く作る

データベースのインデックス拡張を、AIに作らせたり直させたりする時に使う。テストの失敗をすべて本物として扱い、コミット前の決まった順番を守り、クラッシュからの復旧とスタンバイが動くように、ページの変更をすべてログに残す。

TypeScriptモノレポの双方向プロトコルSDKを、公開APIを壊さずに保守する

クライアントとサーバーのどちらからもリクエストを送る、型の厳しいSDKを複数パッケージで出している時に使う。外へ出すエクスポートを意図して選び、新しい操作をケイパビリティのチェック付きで両側に足し、破壊的変更を記録し、サンプルをテストとして動かす。

サンドボックスで、脆弱性を見つけて直すパイプラインを動かす

信頼できないコードを実際に動かしてクラッシュを探す、自動のパイプラインを運用する時に使う。実行をコンテナに閉じ込め、見つかった結果をその都度知らせ、作った修正は必ず人のレビューに回す。

いくつものサービスに分かれたアプリに、バックエンドのコードと、それに合ったテストを足す

バックグラウンドワーカーを持ち、いくつものサービスに分かれたアプリをAIに直させる時に使う。環境と動いているサービスを確かめ、データベースとタスクのコードを決まった場所に置き、ジョブとエラーをプロジェクトの決まりどおりに作り、合う種類のテストを1つ選び、コードを書く前に計画を立てる。

マルチモジュールのリポジトリに、プロバイダーとジェネレーターを足す

シークレット用のプロバイダーとジェネレーターで広がる、マルチモジュールのリポジトリでAIに作業させる時に使う。ビルドとテストをタスクランナーで回し、決まった形で拡張を足し、プッシュやリリースの手前で止まる。

手元で動くAIデザインのデスクトップアプリを、決まった制約の中で直す

AIがデザインを作る、手元で動くデスクトップアプリのリポジトリで、AIコーディングエージェントに作業させる時に使う。どの指示ファイルが優先か、守る制約、セッション・保存・ツールの仕組み、4段階の権限、避ける事を伝える。

大きなJavaバックエンドで、AIにコードスタイルとモジュールの決まりを守らせる

モジュールとプロバイダで組み立てた大きなJavaサーバーで、AIに作業させる時に使う。先に入口のコードを読み、自動でチェックされるコードスタイルと、サポートする一番古いJavaのバージョンを守り、使うモジュールを全部宣言し、ソースで確かめてから答え、プッシュの前にローカルでテストする。

多くの連携先から作業の動きを集め、複数の表示先で見せるアプリを作る

たくさんのツールからイベントを集め、エディタ拡張と単体のサーバーの両方で見せるアプリを作る時に使う。層の依存を一方向に保ち、どの連携先も同じ形のイベントに変え、ほかを直さずに連携先を足せるようにし、状態を安全に保存する。