# ITアライグマ

> AI時代を生き抜くエンジニアのための実践ガイド。個人開発プロダクトの一次情報・技術トラブルシューティング・失敗談と意思決定、エンジニアリングマネジメントや転職活動の実践知を記録・発信しています。

## プロダクト

- [DevPick](https://devpick.it-araiguma.com/): 開発者向け厳選ニュースのキュレーションサービス。日次ダイジェスト配信やカスタムRSS機能を提供。
- [AgentPick](https://agentpick.it-araiguma.com/): AIエージェント・LLM関連ツールのディレクトリーサービス。

## 最新の実践記録・技術トラブルシューティング

- [Webにお問い合わせページがあるのに、Google Play審査で「連絡先が無い」と否承認された話](https://it-araiguma.com/google-play-news-policy-rejection-story/): 個人開発のニュースアプリがGoogle Playのニュース＆雑誌ポリシーで否承認され、連絡先と古い記事の扱いを直した話です
- [配信停止リンクを開いただけで、期限のないトークンがGoogleに送られていた話](https://it-araiguma.com/unsubscribe-token-analytics-leak-story/): メールの配信停止リンクに載せたトークンが、アクセス解析経由でGoogleへ送られていた個人開発の失敗談です
- [個人開発アプリの課金を、リリース直前でやめた話 ─ 特定商取引法と自宅住所](https://it-araiguma.com/mobile-paywall-disabled-ad-only-launch-story/): 個人開発アプリの有料プランを先行リリースで畳み、完全無料と広告モデルに切り替えた判断の記録です
- [「いいね」は消せるのに「興味なし」だけ消せない ─ 手動列挙のFK削除がテストで検知できなかった話](https://it-araiguma.com/profile-delete-fk-dependency-drift-story/): プロフィール削除で依存レコードの手動列挙が漏れ、一部ユーザーだけ削除に失敗していた話です
- [カスタムRSSの認可を直しても残った競合 ─ 判定と保存を同じ前提にするまで](https://it-araiguma.com/custom-rss-authorization-toctou-story/): カスタムRSS記事の認可漏れを修正しても残った競合を、判定と保存を同じ前提で扱う設計から振り返ります
- [壊れたRSSを巡回し続けて詰まる前に ─ 定期フェッチにリース（Lease）と自動停止を入れた話](https://it-araiguma.com/custom-feed-lease-circuit-breaker-story/): 外部RSSの定期巡回で壊れた配信先による遅延を防ぐため、リース方式と自動停止を入れた話です。
- [no-deployのPRをマージしたら、前のデプロイまで消えていた話](https://it-araiguma.com/no-deploy-superseded-skip-prevention-story/): no-deployのPRをマージした際、直前単体の判定で先行デプロイが消えた原因と対策です
- [オフショア解散に伴う1ヶ月での国内体制移行と、年上猛者エンジニアのマネジメント術](https://it-araiguma.com/offshore-transition-senior-engineers-management-story/): オフショア解散に伴い1ヶ月で国内3名体制へ移行。年上シニアエンジニア陣と開発速度を維持しKRを達成した実体験です
- [入社2週間で受託開発を引き継ぎ、ジュニア中心チームで納期と品質を死守した「タスク咀嚼」術](https://it-araiguma.com/junior-team-task-decomposition-handover-story/): 入社2週間で受託開発を引き継ぎ、粗い要望を自ら咀嚼・分解してジュニア中心チームの納期と品質を死守した実体験です
- [/health が200を返しているのに、保存系APIは全滅していた話](https://it-araiguma.com/health-endpoint-missed-shared-storage-failure-story/): Redisが停止して保存系APIが503になっても/healthが200を返し続けていた問題と、検知を足した話です
- [保存エラーの「再試行」が、保存の取り消しになっていた話](https://it-araiguma.com/reaction-toggle-retry-idempotency-story/): 応答だけを失った通信の再試行が、保存済みの評価を取り消していた問題を冪等な更新へ直した話です
- [便利だからとProject全件を引いていたら、GraphQLの上限が16回で尽きた話](https://it-araiguma.com/github-graphql-project-item-list-rate-limit-story/): GitHub Projects全件取得でGraphQL上限が尽きた事故から、走査起点を逆転させて消費ポイントを激減させた記録です
- [どうせレビューで落ちるPRに、テストもE2Eも全部流していた話](https://it-araiguma.com/ci-review-first-gate-order-story/): レビューで落ちるPRにテストもE2Eも流していたCIを、実行順序と起動条件で組み替えた記録です
- [削除前の確認だけでは、直近の既読を守れなかった話](https://it-araiguma.com/cleanup-recent-read-race-protection-story/): 削除前に既読を確認しても、直後の保存と競合する問題が残りました。削除条件とロックを見直した話です
- [Claude CodeにGeminiを導入したら、スキルの二重管理で破綻しかけた話](https://it-araiguma.com/claude-code-gemini-skills-ssot-story/): Claude Code環境にGemini（AGY）を導入した際、スキルの二重管理を防ぐためポインタ方式でSSOT化した実体験を解説。
- [技術を審査される選考に落ち続けた40歳が、転職ドラフトで年収を200万円以上上げるまで](https://it-araiguma.com/job-draft-40s-career-change-story/): 転職ドラフトで年収が200万円以上上がった40歳エンジニアの体験談です。技術審査の選考に落ち続けた話も書きます
- [AIにテストさせたら、成功ログだけでコンテキストが埋まっていた話](https://it-araiguma.com/ai-agent-test-log-context-compression-story/): AIの成功ログでコンテキストを埋めず、失敗診断を残す仕組みを作った話です
- [テストは通っているのに、定期ジョブが一度も動いていなかった話](https://it-araiguma.com/scheduler-restart-deadline-persistence-story/): 定期ジョブの次回実行時刻をプロセス起動基準にしていたため、デプロイのたびに起点が戻り実行されなかった話です
- [プロフィール作成は成功したのに、再読み込みで匿名へ戻る設計だった話](https://it-araiguma.com/profile-create-browser-storage-partial-failure-story/): プロフィール作成後のブラウザ保存だけが失敗したとき、作成を再送せず保存だけ再試行する設計へ直した話です
- [「読みたくない媒体」をユーザーではなくプロフィールに持たせた話](https://it-araiguma.com/profile-scoped-source-preferences-story/): 「読みたくない媒体」をプロフィール設定として保存し、DevPickのWeb・Chrome拡張・通知へ一貫して反映した設計判断を書きます
- [メール送信の再試行で、先に届いた復旧リンクが無効になる設計だった話](https://it-araiguma.com/recovery-link-retry-unknown-delivery-story/): メール送信の結果が不明な再試行で、先に届いた復旧リンクを無効にしない設計へ直した話です
- [LLMが返したJSONは、保存できても安全とは限らなかった話](https://it-araiguma.com/llm-json-save-read-validation-story/): LLMのJSONを保存時と読み出し時の両方で検証するようになった個人開発の失敗談です
- [バックグラウンド処理が、エラーも出さずに消える話：個人開発で踏みかけた create_task の落とし穴](https://it-araiguma.com/background-task-gc-reference-story/): 個人開発のバックグラウンド処理がGCで静かに消えうる状態だった話と、その直し方を書きます
- [バックアップは取れていた。でも「戻せるか」は誰も確かめていなかった話](https://it-araiguma.com/backup-restore-verification-story/): 個人開発のDBバックアップに自動リストア検証を入れた経緯と、検証自体が抱えていた落とし穴を書きます
- [フィードのリンクをそのままGETしていた話：個人開発のOGP取得に足したSSRF検証と再取得設計](https://it-araiguma.com/ssrf-guard-ogp-refetch-story/): 外部フィードのリンクを無検証で取得していた個人開発のOGP処理に、SSRF検証と再取得設計を足した話です

## 個人開発・システム設計・障害対応トピック

- [Webにお問い合わせページがあるのに、Google Play審査で「連絡先が無い」と否承認された話](https://it-araiguma.com/google-play-news-policy-rejection-story/): 個人開発のニュースアプリがGoogle Playのニュース＆雑誌ポリシーで否承認され、連絡先と古い記事の扱いを直した話です
- [配信停止リンクを開いただけで、期限のないトークンがGoogleに送られていた話](https://it-araiguma.com/unsubscribe-token-analytics-leak-story/): メールの配信停止リンクに載せたトークンが、アクセス解析経由でGoogleへ送られていた個人開発の失敗談です
- [「いいね」は消せるのに「興味なし」だけ消せない ─ 手動列挙のFK削除がテストで検知できなかった話](https://it-araiguma.com/profile-delete-fk-dependency-drift-story/): プロフィール削除で依存レコードの手動列挙が漏れ、一部ユーザーだけ削除に失敗していた話です
- [カスタムRSSの認可を直しても残った競合 ─ 判定と保存を同じ前提にするまで](https://it-araiguma.com/custom-rss-authorization-toctou-story/): カスタムRSS記事の認可漏れを修正しても残った競合を、判定と保存を同じ前提で扱う設計から振り返ります
- [壊れたRSSを巡回し続けて詰まる前に ─ 定期フェッチにリース（Lease）と自動停止を入れた話](https://it-araiguma.com/custom-feed-lease-circuit-breaker-story/): 外部RSSの定期巡回で壊れた配信先による遅延を防ぐため、リース方式と自動停止を入れた話です。
- [/health が200を返しているのに、保存系APIは全滅していた話](https://it-araiguma.com/health-endpoint-missed-shared-storage-failure-story/): Redisが停止して保存系APIが503になっても/healthが200を返し続けていた問題と、検知を足した話です
- [AIエージェント運用ROIを月次計測する実務ガイド：トークン消費と工数削減効果の可視化フレームワーク](https://it-araiguma.com/ai-agent-operation-roi-monthly-measurement-guide/): AIエージェント運用のROIを月次計測する実務ガイド。トークン消費と工数削減効果を可視化する設計フレームワーク
- [Claude Codeのトークン消費を月3000円に抑える実務テクニック7選：Skills/Subagent/.claudeignoreで節約する設計ガイド](https://it-araiguma.com/claude-code-token-cost-reduction-techniques-guide/): Claude Codeのトークン消費を月3000円に抑えるエンジニア向け節約テクニック7選を実務目線で解説。
- [RAG基盤のベクトルDB選び方：Qdrant・Chroma・Milvusをエンジニアが比較する実装パターン](https://it-araiguma.com/rag-vector-database-selection-qdrant-chroma-milvus-guide/): RAG基盤のベクトルDB選定方法をQdrant・Chroma・Milvus比較の観点からエンジニア向けに解説する実装ガイド
- [GitHub Actionsの肥大化を防ぐCI/CD設計パターン：ワークフロー分割とキャッシュ最適化の実践ガイド](https://it-araiguma.com/github-actions-bloat-prevention-cicd-design-patterns/): GitHub Actionsの肥大化を防ぐCI/CD設計パターンをエンジニア向けに解説。ワークフロー分割と最適化の実践
- [本番障害を最小限に食い止めるレジリエンスパターン7選：Circuit BreakerからBulkheadまで実装ガイド](https://it-araiguma.com/resilience-patterns-production-fault-tolerance-guide/): 本番障害を最小限に抑えるレジリエンスパターン7選をエンジニア向けに解説。実装例と導入事例つき
- [個人開発で「他人のプロフィールが丸見え」事故を起こした話：MVPでも最低限やるべきAPI認証設計](https://it-araiguma.com/devpick-security-incident-mvp-api-auth-guide/): 個人開発MVPでセキュリティ事故を起こした実体験と修正手順をエンジニア向けに解説。API認証設計の教訓
- [GAS×Claude API×Slack連携|AIニュース自動投稿Botの作り方](https://it-araiguma.com/gas-claude-api-slack-ai-news-automation-guide/): GAS×Claude API×Slack連携でAIニュース要約Botを作る方法をエンジニア向けに解説。設定手順から運用まで網羅
- [localhost:3000とは？開発サーバーの仕組みと開けない時の解決法5選【Next.js/Vite/Bun/WSL2対応】](https://it-araiguma.com/localhost-3000-port-history-guide/): localhost:3000とは？開発サーバーの仕組みと開けない時の解決法5選を3分で解説（Next.js/Vite/Bun対応）
- [Tokentap完全ガイド：LLMアプリ開発のトークン消費とコストをリアルタイム可視化する](https://it-araiguma.com/tokentap-llm-token-cost-visualization-guide/): エンジニア必見！TokentapでLLMコスト可視化！月30%削減の導入手順とデバッグ術を徹底解説。API破産を防ぐ必須ツール。

## キャリア・エンジニアリングマネジメント・チーム運営

- [オフショア解散に伴う1ヶ月での国内体制移行と、年上猛者エンジニアのマネジメント術](https://it-araiguma.com/offshore-transition-senior-engineers-management-story/): オフショア解散に伴い1ヶ月で国内3名体制へ移行。年上シニアエンジニア陣と開発速度を維持しKRを達成した実体験です
- [入社2週間で受託開発を引き継ぎ、ジュニア中心チームで納期と品質を死守した「タスク咀嚼」術](https://it-araiguma.com/junior-team-task-decomposition-handover-story/): 入社2週間で受託開発を引き継ぎ、粗い要望を自ら咀嚼・分解してジュニア中心チームの納期と品質を死守した実体験です
- [技術を審査される選考に落ち続けた40歳が、転職ドラフトで年収を200万円以上上げるまで](https://it-araiguma.com/job-draft-40s-career-change-story/): 転職ドラフトで年収が200万円以上上がった40歳エンジニアの体験談です。技術審査の選考に落ち続けた話も書きます
- [envguardでシークレット流出を防ぐCI設計：チーム導入で押さえる運用ルールと教育の実務ガイド](https://it-araiguma.com/envguard-secret-management-ci-design-guide/): envguardでシークレット流出を未然に防ぐCI設計と運用ルールをエンジニア向けに実務目線で解説します
- [マルチエージェント基本設計8パターン：エンジニアリングマネージャーが押さえるAIチーム構築の実務判断ガイド](https://it-araiguma.com/multi-agent-design-patterns-engineering-manager-guide/): マルチエージェント設計の基本8パターンをエンジニアリングマネージャー向けに解説する実務判断ガイド
- [LLM実装経験を武器にするエンジニア転職エージェント4社比較：年収アップに直結する選び方ガイド](https://it-araiguma.com/llm-engineer-career-agent-4-comparison-guide/): LLM実装経験を武器にエンジニア転職エージェント4社を比較し年収アップを狙う選び方を解説
- [メルカリ流Claude Codeセキュリティ設定の組織配布戦略：チーム導入で失敗しないガバナンス実務ガイド](https://it-araiguma.com/mercari-claude-code-security-governance-team-deployment-guide/): Claude Codeのセキュリティ設定を組織配布しチーム導入で失敗しないためのガバナンス設計をエンジニア向けに解説
- [新人AI禁止令は正しいのか？開発チームのAI活用ルール設計をPjM視点で考える](https://it-araiguma.com/ai-usage-policy-team-rule-design-pjm-guide/): 新人AI禁止令の是非をPjM視点で分析し、段階的AI活用ルールの設計方法を解説します
- [エンジニア転職面接で落ちる人の共通点5選：面接官経験PjMが教える対策と準備法](https://it-araiguma.com/engineer-job-interview-failure-pattern-guide/): エンジニア転職面接で不採用になる共通点5選を面接官経験PjMが解説。対策と準備法を紹介
- [技術的負債を可視化して返済計画を立てるPjM実践ガイド：チームを止めない負債管理の進め方](https://it-araiguma.com/technical-debt-visualization-repayment-pjm-guide/): 技術的負債の可視化手法と返済計画の立て方をPjM視点で解説。チーム開発で負債を管理する実践ガイド
- [エンジニアリングマネージャーの仕事術：技術とピープルマネジメントを両立するEMキャリアの始め方](https://it-araiguma.com/engineering-manager-career-people-management-guide/): エンジニアリングマネージャーに必要なスキルと実践的な仕事術を解説。技術力を活かしたEM転職とピープルマネジメントの始め方ガイド
- [エンジニアからITコンサルタントへ転身する方法：必要スキルと転職成功の実践ステップ](https://it-araiguma.com/engineer-to-it-consultant-career-guide/): エンジニアからITコンサルタントへの転身方法を解説。必要スキルと転職成功の実践ステップガイド
- [エンジニアの『入社1年目の過ごし方』完全ガイド：転職後の立ち上がりを早め、評価される人材になる90日プラン](https://it-araiguma.com/engineer-first-year-onboarding-90day-plan/): エンジニア転職後の90日プランで評価獲得を加速。入社1年目の過ごし方と立ち上がり戦略を完全解説。
- [情報処理安全確保支援士を取得したエンジニアのキャリア設計：セキュリティ資格を転職・フリーランス案件獲得に活かす実践ガイド](https://it-araiguma.com/riss-security-certification-career-strategy/): 情報処理安全確保支援士を取得したエンジニアが転職やフリーランス案件獲得で資格を活用するためのキャリア設計を実践ガイドで解説
- [転職エージェントの選び方：エンジニアのキャリア志向別おすすめサービス比較ガイド](https://it-araiguma.com/career-agent-selection-guide/): エンジニア向けに転職エージェントの選び方をキャリア志向別に解説。失敗しないエージェント活用のコツを元PjMが紹介

## Optional

- [全記事インデックス (llms-full.txt)](https://it-araiguma.com/llms-full.txt): 全326件の記事タイトルと要約リスト
- [サイトマップ](https://it-araiguma.com/wp-sitemap.xml): XML形式のURL一覧
- [著者Xアカウント](https://x.com/it_araiguma): 最新の開発状況やブログ更新情報