未分類

Claude CodeにOpenTelemetryを正しく実装させる──スパン管理・コンテキスト伝播・エクスポーター設定をCLAUDE.mdで制御する

# Claude CodeにOpenTelemetryを正しく実装させる──スパン管理・コンテキスト伝播・エクスポーター設定をCLAUDE.mdで制御する## はじめにClaude CodeはOTel計装コードを生成できるが、廃止済みエクス...
未分類

Claude CodeにJetpack Composeを書かせる:CLAUDE.mdでXML・AsyncTask・LiveDataを封じる実践ガイド

はじめにAndroidはXML→Compose、AsyncTask→Coroutines、Dagger→HiltとパラダイムシフトしてきたためClaude Codeが旧パターンを生成しやすい。本記事はKotlin/Android Nativ...
未分類

Claude Codeに古いLangChain記法を書かせない──CLAUDE.md + llms.txt で最新コードを強制する方法

はじめにLangChainはv0.1→v1.0と短期間で大きく変化し、Web上には旧記法のサンプルが大量に残っている。Claude Codeがそれらを学習しているためLLMChainや旧State定義を生成しやすい。2025年3月28日に公...
未分類

Claude Code に古い Spring Boot コードを書かせない:CLAUDE.mdで制御する実践ガイド

はじめにSpring Boot 3.xへの移行後、Claude Codeに書かせたコードがビルドエラーになるケースが増えている。javax.persistence.*のインポートやWebSecurityConfigurerAdapterの継...
未分類

Claude CodeにTailwind CSS v4を正しく書かせる──CLAUDE.mdでv3の呪縛を断ち切る方法

はじめにTailwind CSS v4が2025年1月22日に正式リリースされて以降、Claude Codeに書かせたCSSやPostCSS設定がビルドエラーになるという報告が増えている。原因はシンプルだ。Claude Codeの学習データ...
未分類

Claude CodeがStripeコードで踏む地雷と、CLAUDE.mdで防ぐ方法

はじめにClaude CodeにStripeのWebhookハンドラを書かせると、署名検証が省略されたコードが出てくることがある。コンパイルは通り一見動くように見えるが、攻撃者が偽のWebhookを送れば未払いの注文を完了させられる。冪等性...
未分類

Claude CodeがPlaywrightテストを生成するとき、なぜフラキーになるのか──CLAUDE.mdで防ぐアンチパターン完全ガイド

はじめに「Claude Codeで書いてもらったE2EテストがCIでよく落ちる」という声は珍しくない。原因はAIの問題ではなく、制御していないことの問題だ。Claude CodeにPlaywrightのベストプラクティスを伝えるCLAUDE...
未分類

asで逃げるのをやめる──Claude Codeに判別共用体と型ガードを書かせるCLAUDE.md設計

はじめにClaude CodeにTypeScriptを書かせると、型エラーをas SomeTypeで黙らせたコードが出てくることがある。コンパイルは通るが型チェックをバイパスしているため、実行時エラーの温床になる。CLAUDE.mdに「何を...
未分類

「Dockerfileが怖い」を卒業する──Claude Code × Go/Python別マルチステージビルドとTrivyスキャンを自動化する

はじめにClaude CodeにDockerfileを書かせると、シングルステージのまま返ってくることがある。ビルドツールや開発依存がそのまま本番イメージに入り、1GB超になる。CLAUDE.mdにDockerfileポリシーを定義すれば、...
未分類

import文を書き続けるClaude Codeを止める──Nuxt.js開発でCLAUDE.mdが必須な理由

はじめにClaude CodeでNuxt.jsのコンポーネントを書かせると、import { ref } from 'vue'が毎回追加される。内で$fetchを直接呼ぶ。サーバールートがpages/api/に置かれる。いずれもNuxt 3...