未分類

未分類

「Claudeが勝手に作り始めた」を止める——仕様駆動開発(SDD)でAIと正しく協業する実践ガイド

はじめに「ログイン機能を作って、と頼んだら、パスワードリセットメールまで勝手に実装されていた。動くけど、私が欲しいものじゃない」Claude Codeを使い始めたエンジニアが、一度は経験するパターンだ。指示の解釈がズレているというよりも、仕...
未分類

「AIスロップ」UIから脱出する——Claude Codeで作るデザインに魂のあるフロントエンド開発ガイド

はじめにClaude Codeにコンポーネントを作ってもらうと、こんなUIが出てくることがある。グレースケールベースの配色、角丸で清潔感があるが無個性なカード、Interフォント、どこかで見たようなレイアウト——。これが「AIスロップ(AI...
未分類

「分散モノリス」を作らないために——Claude Codeで正しくサービス境界を分析し、マイクロサービスへ安全に移行する実践ガイド

はじめにマイクロサービス化したのに、なぜかデプロイが遅くなった。なぜかサービス間の結合が強くなった。なぜかモノリスより複雑になった——この経験をしたエンジニアは多い。これは「分散モノリス(Distributed Monolith)」という失...
未分類

Claude Codeにデータを消された——Prisma migrate resetの悲劇と、AIに安全にDB設計を任せる実践ガイド

はじめに2026年3月、GitHubのClaude Code Issueに報告されたインシデントがある。ユーザーがTypeScriptエラーとログイン問題をClaude Codeに依頼した。Claude CodeはPrismaスキーマに新フ...
未分類

仕様と実装が常に一致する——Claude CodeとOpenAPI 3.1で実現する「スペックドリブン開発」完全ガイド

はじめに多くのチームで同じことが起きている。Day 1にOpenAPI仕様書を書く。Day 7に仕様変更が入り、仕様書の更新を忘れる。Day 30で仕様書と実装が乖離している。Day 60になると誰も仕様書を信用しなくなる——。この「仕様書...
未分類

Claude Codeが生成するTypeScriptコードはデフォルトで型安全ではない——`any`を撲滅し型品質を制御する実践ガイド

はじめにClaude CodeにTypeScriptを書かせると、こんなコードが出てくることがある。function fetchUser(id: any): any {return fetch(/api/users/${id}).then(...
未分類

「AIに全部任せたら127個のバグが生まれた」——Claude Codeでレガシーコードを安全にモダナイゼーションする実践ガイド

はじめに2026年2月、The Unwritten Algorithm(Dev Genius)がある体験談を公開した。「私はAIにレガシーコードベース全体のリファクタリングを任せた。コードは美しくなった。しかし私たちが数週間後に発見した12...
未分類

Claude Code × Playwright——「E2Eテストが壊れたまま放置」を終わらせる自己修正ループ・自然言語テスト・ドメイン知識ファイルの設計パターン

はじめにE2Eテストが壊れているのを知りながら、誰も直さない状態になったことはないだろうか。UIのクラス名を変えたらPlaywrightのテストが軒並み失敗した。修正しようとしたら他の開発者が「後でやる」と言い、そのまま1ヶ月が経つ。CIの...
未分類

Claude Code × Terraform——「applyは人間が押す」原則とterraform-skill・HashiCorp MCPでハルシネーションを排除するIaC自動化設計

はじめにClaude CodeにTerraformを書かせると、こんなコードが出てくることがある。resource "aws_s3_bucket" "example" { bucket = "my-bucket" acl = "privat...
未分類

Claude Code Agent SDK——「Claude Codeをライブラリとして使う」10行で動くカスタムエージェントの設計パターン

はじめにclaude -p "..." でシェルスクリプトからClaude Codeを呼び出す使い方には、一つの限界がある。Claude Codeがブラックボックスになってしまうことだ。エージェントループの途中で何が起きているか見えない。ツ...