すべての記事
Claude Code で flaky test を体系的に潰す段階的アプローチ
「再実行したら通った」で済ませてきた flaky test を、Claude Code を使って体系的に分析・修正する手順を紹介します。原因分類から再現スクリプトまで、本番運用で機能しているパターンをまとめました。
Claude Code Skills を組み合わせる設計術 — 単一スキルでは届かない自動化を作る
Claude Code の Skills を1つずつ作るところから一歩進み、複数スキルを連携させて自動化を組む設計手法を解説します。Pipeline・条件分岐・メタスキルの3パターンとよくある落とし穴を実装例付きで詳述します。
Claude API の『messages.X.role must alternate』を1分で直す — 400 invalid_request_error の典型パターン
Claude API で頻発する『messages.X.role must alternate』エラーの原因と直し方を、user/assistant の交互ルール・tool_use と tool_result の対応関係・履歴管理の落とし穴に分けて、実例コード付きで整理します。
AI エージェントが即座に活躍できるコードベース設計図
Claude Code をはじめとする AI エージェントが、初見のリポジトリでも迷わず開発に貢献できるコードベース設計の実践ガイド。CLAUDE.md・契約境界・ガードレール・テスト戦略まで体系化します。
Cowork Skills で「自分の文体」を再現する — 個人ブランド向けスタイルガイドの作り方
Cowork の Skills 機構を使って、自分の文体・語彙選び・構成癖を AI に再現させる方法を、観察・SKILL.md 化・反証テストの3段階で解説します。
Claude API で多言語翻訳 SaaS を本番運用する設計ガイド — 用語集・スタイル・ドメイン適応の実装
Claude API で多言語翻訳 SaaS を本番運用する設計を、用語集・スタイルガイド・ドメイン適応・品質ゲート・コスト最適化まで具体的なコードと運用ノウハウで解説します。
Claude Code が .gitignore のファイルを検索しない理由と、必要なときに見つける方法
.env.example や dist/ が Claude Code の Glob/Grep に引っかからないとき、原因は .gitignore です。挙動の理由と、Read ツール・--no-ignore・一時的な除外解除の3つの突破口を具体的に解説します。
Claude Codeでフロントエンドのアクセシビリティ監査を自動化する — axe-coreとプルリクのコメント連携で運用に乗せる
アクセシビリティ監査を続けるのが難しい本当の理由と、Claude Code+axe-coreで「最初の一歩を5分」「日々の運用は無意識化」する具体的なワークフローを、設定例とともにまとめました。
Claude APIをCloudflare Queuesで非同期処理する：障害復旧と優先度制御を含めた本番設計
Claude APIをCloudflare Queuesで非同期処理する本番グレードのパイプライン設計を、Producer/Consumer両方の動作コード・障害時のリトライ戦略・優先度制御・コスト制御まで含めて解説します。
Claudeのシステムプロンプト実例集 — 業務でそのまま使える9パターンと設計の勘どころ
Claudeのシステムプロンプトを業務でそのまま使える形で9パターン用意しました。サポート応対、コードレビュー、JSON抽出、教育チューターなど用途別に「なぜこう書くか」までセットで解説します。
Claude Code の実行を OpenTelemetry で観測する — エージェント処理を本番品質で可視化する設計ガイド
Claude Code のエージェント処理を OpenTelemetry でトレースする本番設計ガイド。フック連携・ツール呼び出し計測・MCP 通信・コスト属性・サンプリングまで、実運用で詰まらないパターンを解説します。
Claude Code の自動アップデートが効かない時の診断手順 — claude --version が古いまま動かない問題を切り分ける
Claude Code をアップデートしたはずなのに claude --version が古いまま、新機能が出てこない、という症状の根本原因を切り分けるための実践的な診断手順をまとめました。PATH 衝突、ローカルキャッシュ、nvm の切替、社内プロキシなどケース別に解説します。