Claude のサブスクリプション認証で Agent SDK を開発する — 実践 Tips

AI エージェントとの実装協働で経験した3つの具体的なバグ事例から、テスト合格やスコア1.00が必ずしも正確性を保証しないことを示す。グラフ検索の副作用補完、評価データの設計ミス、LLMの後付け説明など、従来のテスト駆動開発では見落とされやすい問題に対し、高リスク領域での全量レビューなど実務的なレビュー方針を提示する。

Macアプリ開発者が Claude Code と Codex を多用する中で、ターミナルアプリ microTerm を開発。エージェントの状態を可視化・管理するため hooks を活用し、セッション状態の追跡、ゾンビプロセス判定、異なる仕様への対応など、実装時に直面した4つの罠と対策を詳述。

Agent 型 AI 開発で作業ログから継続的にルールを自動更新する際、ログの振り返りだけでは実務で機能しない問題に対し、気づきを検索可能な単位に「蒸留」する 2 速メモリ仕組み（素ログ取得と AI による定期カード化）を提案。決定の結果追記・3 分類トリアージなど 5 つの工夫により、積み上がる学習を複利的に生かす実装方法を示す。

AWS Bedrock の AgentCore Memory を使用し、「涼宮ハルヒの憂鬱」のエンドレスエイト（時間ループ）を再現する実験。記憶を保持しないエージェント（キョン型）と長期記憶を蓄積するエージェント（長門型）で同じ夏休みシナリオを50周繰り返し、既視感の発生やループ終了条件への到達可能性を検証した内容。