開発ガイド
ツールの差分手順、取り込みの使い分け、AIエージェント開発の短いメモです。上段で広い区分、下段で個別製品を選べます。並びは更新日の新しい順です（公開日も併記）。
最終更新
Snowflakeのチャット用MCPにはSemantic Viewだけ渡す—数え方はツール説明に書かない
事業の担当者が外部のチャットでSnowflakeの売上や人数を尋ねるとき、人数の数え方や月の区切りをMCPのツール説明に書くと、Semantic Viewを直したあとも説明文に古い定義が残ります。チャットが読める範囲をSemantic Viewだけにし、どの料金がかかるかを決めてから使う道具を選ぶ判断基準です。
コンテナ版Streamlitは見ていなくてもCompute Poolが残る—操作ログが空なら自分で止める
Snowflakeのコンテナ実行Streamlitは、視聴者が来なくてもサーバーが残り、Compute Poolの自動停止は始まらない。画面を閉じたこととノード課金を分け、操作ログと稼働日で画面用プールだけを止める判断基準。
2026.10（8件）
Geminiの無料枠が変わると報道されたら—アプリとAPIのどちらの話かを分けてから、定時収集への影響を判断する
Geminiの料金や上限の変更が報道されたとき、チャットアプリとAPI（AI Studio）とVertex AIでは別の仕組みです。AIの要約を定時バッチで回している側が、どの経路の話かを出典で分け、自分たちのキー・モデル・ティアを設定から確かめてから答えるための判断基準と、AIエージェントに渡す指示文。
PowerShell 5.1でAWS CLIの出力が化ける・cp932で落ちる—出す側と読む側の文字コードをそろえ、本物のaws.exeで試す
日本語WindowsのPowerShell 5.1からAWS CLI v2を呼ぶと、cp932に無い文字で終了コード255になったり、落ちずに化けたJSONが保存されたりします。片方だけ直して終わらないための判断基準と、偽のエンドポイントを使ったテスト、AIエージェントに渡す指示文。
CloudWatch Logsの調査で件数と時刻を取り違えない—1万行の打ち切り・UTC表記・0件の切り分け
CloudWatch Logs InsightsやアラームAPIの結果を数えて結論を出す前に、気づかないうちに切れる上限、APIごとに違う時刻の形式、0件の原因を確かめる判断基準と、AIエージェントに調査させるときの貼り付け文。
gitignoreのローカル実データをForce削除しない
エージェントが掃除や移動のつもりでローカル実データをForce削除し、Gitにもゴミ箱にも残らず復元不能になった事故の型と、再発防止のルール。
GA4を初めて置く（2026）測定開始から静的サイト配線まで
ようこそからのプロパティ作成、測定IDの環境変数配線、データ保持14か月、内部トラフィック定義とデータフィルタ有効化。旧UA／旧メニュー名との差分付き。
X APIのキー取得手順（2026）クレジットとBearerまで
console.x.com・pay-per-use・Bearer生成・リポ直下.env・支出上限までの最新通し手順。旧Basic／Portal手順との差分付き。
AIエージェントのよかれが事故になるとき—是正をルールに残す
よかれの先読み最適化を止め、是正を永続ルールに残す。症状1件直しで止まらず、『プロセスを修正しろ』を待たない。
Gemini無料キーとGitHub Secretsの設定（2026）
AI Studioでキー発行、GitHub Secrets登録、429のバックオフと日次おおよそ20回。Vertex有料レーンとの取り違えを避ける通し手順。
2026.09（24件）
セキュリティ情報の定時取り込みでのGeminiとPerplexityの使い分け
セキュリティ情報・障害短報をGitHub Actionsで定時取り込みするとき、要約はGemini無料枠（1往復・件数上限）、漏えいなど個別事案URLの発見と原典差し替えはPerplexity Sonarを一日最大5回。出典は全トピック共通で、公式以外は原典未確認の印（※）付きで載せる。429時もエディタやCLIのAIチャットに逃がさない。
情報の出典ルールはカテゴリでバラすな—公式以外は落とさず※
漏えい・AI・決済のニュースを自動で集めるとき、出典の可否をトピックでバラすな。報道・転載・まとめしか無くても落とさず、原典未確認の印（※）を付けて載せ、定時処理で公式URLへ差し替える。落とすのは検索結果ページとSNS投稿だけ。
ガイドのタイトルだけで『何の作業の話か』が分からなければ不合格—『汎化した』抽象タイトルを通すな
顧客名は削ってよいが、物件売値・情報メモ・定時収集など種類名まで消すな。初読チェックは本文の前にタイトルと説明文だけで場面が分かるか見る。
定時の収集バッチは実行時間の予算を先に出せ—主人の細かい指示を待つな
朝の収集ジョブが時間切れで落ち、応急でジョブ分割すると共有データの書き込みが壊れる。本線とサイドカー、実行時間の予算、異常系を実装前に自分から出す。
情報メモの要約を手で埋めたら再一覧せよ—『全部埋めた』は再スキャン後だけ
セキュリティ等の情報メモで『要約作成中』を手埋めしたあと、開始時ローカル一覧だけで完了するな。pull→一覧→埋め→再一覧。rebase後も残件ゼロまで。
情報メモの見出しと要約—要約はタイトルの言い換えにしない
漏えい・AI・決済などの情報メモで、見出しのすぐ下に要約が並ぶとき。タイトルの言い換え・メタ拒否文を要約にしない。並記テストと日付の正。
教訓ガイドは判断基準を書く—ファイル一覧だけで終わらせない
事故のあと残す文章は、「何が不合格で何が合格か」が主。どのファイルを触るかの一覧だけだと、次の人に伝わらない。
原稿は1チャット直列—多タブ同時エージェントは使わない
ライター→チェッカー→プレリーダー→機械チェック。タブは1つ。投稿するガイドだけ。『投稿前ゲート』と呼ぶな。
物件の売値を直しても、一覧の仮値が履歴に残ると大暴落に見える
不動産クロールで詳細の売値だけ直して履歴先頭の仮値を据え置くと、変動率が嘘の値下がりになる。現行を直すパッチは履歴も整合させる。
緯度経度が合っても海に出る—装飾地図では全点を陸判定しろ
装飾白地図は測地と1:1ではない。注釈掃除に粘らず、投影後は全点を陸ピクセルで判定する。およその中心座標禁止と勝手な立体化も止める。
GitHub Actionsのscheduleを本線にしない—外部cronで定時を保証する
Actionsのcronは遅延・スキップがあり得る。本線は外部cronからworkflow_dispatch。PAT最小権限と /dispatchesの判定基準。
AdSense申請と静的サイトへの配線（2026）
個人用Googleアカウントでの申請、publisherコードとads.txt、同意メッセージ、準備中ステータス。Workspace誘導やads.txt不明の切り分け付き。
GA4キーイベント設定（2026）メニューが消えたあとの手順
コンバージョンや専用キーイベントメニューが見つからないときの現行画面手順。旧UI用語との対応表付き。
Stripe本番切替—本人確認からlive鍵と本番設定差し替えまで（2026）
テスト通しの次。本番切替、テストデータはコピーしない、liveカタログと鍵、本番アプリが読む設定への差し替え。実カード通しは任意。
Stripeサンドボックスでサブスク課金まで通す（2026）
税の先決め、Product／Price、鍵とWebhook、Checkout通し試験。live先走りやCheckout URLのチャット貼りを避ける通し手順。
機械チェックは経路に固定する—『投稿前ゲート』と呼ぶな
任意チェックは飛ばされる。儀式名は作業を止める。安価な機械チェックとガイドのA→B→Cを混ぜない。
ノートPCのDDR5 64GB—FigmaとClaudeとTeamsが同時だと足りないときの選び方（2026）
値動きが激しい時期に、ノート用DDR5-5600 32GB×2を買うかの判断。Figma・Claude・Teams併用の目安と、CFD相性保証キットの見方。
AIと開発を始めるときの入口—読む順・ゲート・初手の依頼
エージェントと小さく始めるときの最初の時間の使い方。文書の読む順、実装前ゲート、依頼の型、やりがちな誤解。
IDE内蔵ブラウザでGoogleにログインするとアカウントが保護されやすい
CursorなどIDEの内蔵ブラウザからGA4やGoogleにサインインすると拒否・アカウント無効化になりやすい理由と、通常ブラウザでの復旧手順。
小さく始めるAIネイティブ開発—設計をdocsに置いてからコードへ
個人・小規模でも、要件と設計を実装リポのdocsに同居させ、ゲートを人間が持ってからエージェントに実装させる進め方。
Cursor Proが足りないとき—Pro+と従量課金の選び方
Plan & Usageの見方、AutoとAPIの違い、$100ボーナス噂の正体、忙しい週だけ凌ぐときの判断。
画面に出ないときはデプロイを疑う—スタブと障害を混同しない
反映されない画面の切り分け、固定の未接続文言が障害に見える問題、ロール別ナビと管理者の表示確認の設計メモ。
Figmaのアクセス権 編集できない・ライブラリが無いときの確認ポイント
チーム／プロジェクト／ファイルの階層、can viewとcan edit、ゲストとシート。共有トラブルの切り分け手順。
SSRホスティングの環境変数 ビルド時とランタイムを取り違えない
Next.jsなどのSSRで、ビルド時注入と実行時のdual、署名鍵の変数名食い違いでセッションだけ死ぬときの切り分け。
この区分に該当する開発ガイドはいまありません。