AIコーディング セッション喪失時の復旧リスク—定義ファイルの盲信が招いた本番データ破損の危機
ZennAIコーディングツールのセッション3つが切れた際、ディスク残存の定義ファイルを忠実に復元しようとしたら、本番の問題データ 3,599 問が 546 問に上書きされる寸前だった。旧環境向けの腐った定義、1ヶ月以上検知されない自動実行の不具合、CLAUDE.md 不在が複合して事故が起きかけ、復旧時の検証と Context ファイルの重要性を改めて指摘した事例報告。
タグ: Claude Code
20 件の記事
このタグの RSS
社内文書AIにベクトルDBは要らなかった — 全文投入で本番運用した設計と限界
Zenn社内マニュアルをAIに参照させる際、一般的なRAG（ベクトル検索）ではなく、マニュアル全文をプロンプトに毎回投入する構成を採用し、2社のSlackボットで本番稼働。トークン数計算とプロンプトキャッシュの活用により、ベクトルDB不要で運用が壊れにくく、表の断片化や検索漏れの問題を排除できた一方、入力量に正比例したコスト増加が課題。
Claude Skills完全ガイド①：基本の使い方と設定編
QiitaAnthropicが2025年10月に発表したAgent Skillsは、業務手順・スクリプト・参考資料をまとめてClaudeに渡し、特定作業を効率化する仕組み。Claudeアプリ・Claude Code・APIで利用でき、必要なSkillのみ動的に読み込まれることで毎回の長いプロンプト入力が不要になる。
朝の問題が難しい原因は難易度ではなく初見出題だった——予習ルーティンを8日間運用した結果
Zenn朝のメイン課題が重く感じた原因を調査したところ、難易度ではなく前夜の四肢選択と朝の記述式という問題形式の違いが原因だった。対策として夜のルーティン末尾に予習フェーズを追加し、翌朝の設問を前夜に生成・講義することで初見を避けるよう設計。8日間の運用で午前I演習の正答率は69.1%から75.0%に改善。Agent間の状態受け渡しでは、データ構造より「両者が同時に触れる共有ストレージ」の制約を優先すべき、という実装上の教訓も得た。
Claude Code を使用した完全自動サイト構築——ソフトウェア企業の実例
HNソフトウェア企業 Soamee が自社サイト構築にClaudeコードを導入し、339件のコミットのうち52%にAI支援が関わったことを公開。翻訳システムやスクリプト自動生成で数週間を短縮した一方、完璧さには課題があり、レビューが必須であることが明らかになった。
AI 2体と人間1人で iOS アプリ開発を回す
QiitaXcode で iOS アプリ開発する際、画像認識の精度改善に詰まった結果、設計役（Opus 5）と実装役（Opus 4.8）を別モデル・別セッションで立て、人間がゲートで判定を加える 3 者ループを構築した。自動化できるのは情報運搬だけで、判断作業は減らせず、相互チェックが起きない場合は「互いに承認し合うだけ」に陥る。実機確認と方針判定は人間にしかできず、1周ごとに測定可能な条件が増えていく。
Qiita コンテスト全敗の診断：社内実験レポートを外部向け記事と誤認していた
QiitaQiita「ai& Inference」コンテストに投稿した3記事が全て落選。著者が5つの異なる AI に受賞記事13本と自分の記事を比較分析させたところ、原因は誠実さではなく「モデルや設定そのものを検証する社内実験レポート」になっていたこと。受賞記事は読者の具体的な困りごとを解く「道具」としてモデルを扱っていたのに対し、著者の記事は検証対象そのものが主題になっていた。この構造的ズレから生じる3つの症状（冒頭が方法論から始まる、検証が内部で閉じる、問いかけで締める）と対策を定式化。
有能な執事とメイドに囲まれたい — 煩悩から始まったAIエージェントのお屋敷
ZennFlutter/Firebase 開発を行うCEOが、戦国武将をモチーフにしたマルチエージェント構成に着想を受け、Claude Code を使った自前のエージェントシステムを構築。tmux と YAML で手作りした直後に公式の Agent Teams がリリースされたが、学習と愛着を理由に独自システムを継続し、5ヶ月でディスパッチャー的な開発スタイルへ変化した経験を綴る連載のプロローグ。
WIREDRIVEの知見がWIREFIGHTの生成コストを削減——再利用可能な基盤づくりの実践
ZennPyxel で制作した格闘ゲーム「WIREFIGHT」の開発では、前作「WIREDRIVE」の描画・音声基盤をそのまま流用し、Fable 5での追加消費を約17ドルに抑えた。ゼロからの生成ではなく既存コードと失敗記録を活用することで、コスト削減だけでなく隠れていたバグも発見でき、次の作品へ向けた再利用可能な基盤が構築される。
Claude が独自のウェブサイトを装飾したら、桜の花びらが降ってきて戻せなくなった
Redditユーザーが Claude に自分のウェブサイトの見た目を改善するよう依頼したところ、CSS に落下する桜の花びらのアニメーション効果が追加され、その後もこの装飾が残ってしまったというお話。
Finding Unknownsを組織に — Claude Fable 5とナレッジグラフ
ZennAnthropic の Thariq Shihipar 氏が公開した「Finding your unknowns」が話題になっている背景と、組織での実務への応用方法を解説。Claude Fable 5 時代は長いプロンプトより「自分が何を知らないか」を先に洗い出す方が成果を左右しやすく、個人完結型ではなく複数部門が絡む業務では、AI に正解を出させるのではなく「会議のたたき台」を作ることがゴール。盲点の洗い出し（Blind Spot Pass）と構造化インタビュー（Structured Interview）の具体的な手順を営業→オンボーディングの例で実装可能な形で提示。
prompt-master がAIの出力を安定させる仕組み
ZennClaude Code や Cursor などのAIエージェントツールで曖昧な依頼をすると、関係ないファイル編集や余計なリファクタが発生する。prompt-master は、「プロっぽくして」といった漠然とした指示を、対象ツール・制約・成功条件・停止条件など9つの観点に分解し直すことで、AIの判断範囲を狭め出力を安定させる手法を示す。
Claude Code プラグインでトークンを節約する
HNtoken-warden は Claude Code 用のプラグインで、エージェントのメモリに含まれるルールを実測ベンチマークで検証し、コスト以上の節約効果があるルールのみを保持することでトークン消費を削減する。4段階のループ（収集・蒸留・ベンチマーク・選別）で継続的にメモリを最適化し、効果のないルールは自動的に削除される。
Claude Cowork のスケジュール機能を使ってITニュース収集を自動化する
DevIO営業が毎朝15～20分かけていたITニュース収集をClaudeのスケジュール機能で自動化した事例。非エンジニアでもコード不要でチャット形式の設定だけで完成し、毎朝決まった時間に自動でニュース取得・集約・通知される仕組みを実装。小さな日次作業の効率化に特に向いている活用法を紹介。
Cursor / Claude Code対応：MCPサーバーで AI に長期記憶層を組み込む実装ガイド
ZennMCP（Model Context Protocol）を活用し、Cursor や Claude Code に「プロジェクトの設計決定」を記憶・再利用させる長期記憶レイヤーをローカルで構築するハンズオン。Kawa Code CLI をセットアップし、AI が新機能を実装する際に過去のアーキテクチャルールを自動注入することで、コンテキストの手動コピペやトークンコスト増加を排除。
AI セッションは消えうる前提で設計する — 回復力だけでは足りず実行環境を切り替えた話
ZennClaude Opus 4.8 リリース直後、複数の AI サブセッションが数時間で 5 回終了する事象が発生。コードと思考を二重永続化し親セッションが痕跡から再構成する「回復力設計」で初期はロスゼロで吸収したが、リカバリ頻度が上がると時間が前進を侵食。そこで実行環境を Claude Desktop から CLI に切り替えた。
Claude Code で株・仮想通貨 bot を 300 個作らせて見えてきたこと
Zenn著者が Claude Code を用いて 1～2 ヶ月で株・仮想通貨 bot 300 個を生成し、バックテストと検証を経て実運用可能な戦略 5 個に絞り込んだ過程を報告。AI が生成する戦略の多くはデータスヌーピングバイアスやリークを含むため、実運用に耐える判別には人間の経験とセンスが必須であること、および単純なテクニカル指標では差別化できない点が明らかになった。
マッチを擦るAI、ポンプを売るAI：AI時代の「デジタルみかじめ料」ビジネスモデル
QiitaAnthropicが5月22日にClaudeの脆弱性発見能力を強調し、5日後にセキュリティプラグインをリリースした一連の動きを、古典的なマッチポンプ商法の洗練版と指摘。トークン従量課金モデルにより、AIが発見したバグをAIが修正するループが回るたびに課金が発生し、企業は継続的な負担を強いられる構造を批判。
Claude で Microsoft 365 を使う 3 つの入口：35 個の権限要求を見直した MCP・アドイン・Web アプリの比較
ZennClaude と Microsoft 365 を連携する 3 つの経路（MCP サーバー経由、Office アドイン、Web アップロード）を、権限要求の範囲と仕組みから比較。MCP 連携で 35 個の権限一括付与を求められることに対し、入口ごとに異なるセキュリティモデルと、組織導入時の選択基準を整理した。