Claude Codeに1ファイルだけ直させる指示文のつくり方
「もっと良くして」で40行も変えられた失敗から学んだ、触る範囲・検証・戻し方をセットにしたClaude Code用の依頼文テンプレートを紹介します。
「もっと良くして」で40行も変えられた失敗から学んだ、触る範囲・検証・戻し方をセットにしたClaude Code用の依頼文テンプレートを紹介します。
Claude Code のコマンドが拒否されたとき、焦って許可を広げずに、拒否理由、代替手順、証拠コマンド、再試行条件へ分解する方法。
最小スモークテストの選び方、失敗ログを食わせて直させるループ、回数上限と確認ゲートで暴走を止める方法を、コピペで動くコード付きで紹介します。
最初は ask/deny 多めで始め、検証が積み上がった操作だけ段階的に allow へ。Claude Code の権限を安全に緩める5段ラダーと、各段の昇格条件を実例で。
大きい変更を小さいPRに刻む手順、1PR=1目的の徹底、AIに任せた差分をレビューしやすく見せる証拠(テスト/diff)の添え方を実例で整理。
commit前にClaude Codeで差分・テスト・CTAを一気に点検する型。build失敗、未翻訳本文、壊れたGumroadリンクを公開前に止める実践手順。
AIの自己申告は鵜呑みにしない。テスト・コマンド出力・スクショで裏取りし、検証レシートとしてPRに残す手順を、コピペで動くコード付きで紹介します。
Claude Codeのallow/ask/denyとトークン上限を毎朝5分で点検する運用。自動承認の線引き、使いすぎを止める設定、コピペで動く監査スクリプトまで僕の実例で。
よく効いたClaude Codeのプロンプトを、保存・命名・チーム共有し、CLAUDE.mdやカスタムコマンドに育てる運用術。陳腐化したプロンプトの棚卸しまで、僕の失敗込みでまとめました。
Claude Codeの最初のCLAUDE.mdに何を書くか迷う人へ。コピペで使える最小テンプレ、言語別の例、毎セッション説明し直す手間を1枚で減らす育て方を、僕の失敗込みでまとめました。
「画面が壊れてる」が伝わらないのは情報不足が原因。タイトル・再現手順・期待と実際・環境・ログの並べ方を、コピペで使えるissueテンプレと自動生成スクリプトで整えます。
個人開発・コンテンツサイト・API・チーム・レガシー向けのCLAUDE.mdテンプレを、僕が事故った話つきで7本まとめました。コピペして禁止事項を3行足すだけ。
allow/ask/denyの境界、plan・acceptEdits・auto・bypassPermissionsの使い分け、dangerously-skip-permissionsの是非、sandboxの使いどころを実務目線で。
Claude Codeの始め方を初心者向けに。インストール、ブラウザ認証、最初のプロンプト、最初のコミットまでを30分で。僕が最初につまずいた権限・コンテキスト・CLAUDE.mdの落とし穴も紹介。
REST API入門。HTTPメソッドとステータスコードの基礎から、Claude CodeでTodo APIをCRUDまで作り、curlとテストで動かす最初の一歩を実体験で解説。
REST APIのURL設計・HTTPメソッドとステータスコードの使い分け・ページング・バージョニング・冪等性を、実装前に決める手順とコピペで動くコードで。
Claude CodeとGemini CLIを半年併用した僕の使い分け基準。料金・OSS・Google連携・失敗例から、あなたが選ぶべき方を整理します。
Claude CodeとCursorを実際に両方触った所感で比較。CLIエージェントとエディタ統合の違い、料金の考え方、向いてる人、併用のコツを2026年視点で整理。
遅い処理を勘で直すと別の場所を直して終わる。計測でボトルネックを特定し、N+1・直列await・無駄な再計算を潰してサーバー処理を速くする実践手順を、コピペで動くコード付きで。
AI APIの請求が読めない人へ。入出力トークン課金の計算、モデル使い分け、プロンプトキャッシュ、予算アラートで止める方法を、コピペで動くコードと一緒に整理しました。
曖昧な一文がClaude Codeの事故を招く。広すぎる削除・本番への適用・秘密の露出を防ぐ依頼文の型、dry-run、権限とフックで機械的に止める設計を実例で。
本番が落ちた瞬間、焦って直すと被害が広がる。検知→止血→原因切り分け→復旧→振り返りの順番を固定し、Claude Codeをログ調査と仮説出しに使う実務手順を、僕のやらかし込みで紹介。
Claude Code の権限を settings.json で設計するリファレンス。allow/deny/ask の評価順、Bash・Edit・Read・WebFetch のパターン構文、Hooks 自動化をコピペ設定例で。
Claude CodeとAI支援開発の安全対策を1枚で俯瞰。権限・秘密情報・危険コマンド・依存・入力・ログの6観点を、コピペできる設定とチェックリストで。各論は内部リンクへ。
権限の渡しすぎ、秘密情報のコミット、入力検証の抜け、脆弱な依存。AI支援開発で実際に起きがちな事故を「何が起きた→なぜ→どう防ぐ」で整理し、コピペで使う防御設定まで。
AIエージェントが暴走しない理由はモデルの賢さではなく「ハーネス(足場)」。とは何か、なぜ要るのか、safePathの門番から検証ループまで、コピペで動く最小例でやさしく解説。
散らかったObsidianのメモをClaude Codeの相棒に変える全体像。何が起きるか、つなぎ方の地図、毎日の回し方、安全の境界線を、入口の1枚として実体験でまとめます。
外部SaaS APIを自分のアプリへ連携する実装手順。APIキー管理、Webhook署名検証、指数バックオフのリトライ、冪等性、サンドボックス検証をコピペで動くコードで解説。
「入力欄1つ追加で1日」が5日に膨らんだ反省から、タスク分解・3点見積もり・バッファの置き方を実例で。Claude Codeで前提と抜けを洗い出す壁打ち手順つき。
APIキー・トークン・DBパスワードを.envと.gitignoreで隔離し、コミット前にgit-secretsで検出、漏れたら即ローテーション。Claude Codeに秘密を渡さない設計まで僕の失敗談つきで。
Claude Codeにエラーを丸投げすると一般論が返る。ログの整え方、再現手順の作り方、スタックトレースの読み方を僕の失敗込みで具体的に。
git のマージ衝突を直す具体的な手順。コンフリクトマーカーの読み方、ours/theirsの罠、rerereでの自動再利用、衝突を減らす運用、Claude Codeへの頼み方まで実例で。
AIで速く書いたPRほどレビューで止まる。小さく分け、説明を埋め、自己レビューする型をClaude Codeで仕組み化。コピペで動く差分サイズCI付き。
10万行のリポジトリで迷子になった僕が使う、rg検索の段階化・依存の追い方・実行経路の追跡まで。読み進め方を具体コマンドで解説。
赤いログを上から全部読むのは遠回り。スタックトレースのどこから読むか、undefined・型・非同期・importの型分類、エラーをClaude Codeに渡して原因を絞るコツを実例で。
Claude Codeの会話が重くなり返答が雑になる原因はコンテキスト圧迫。/clearと/compactの使い分け、CLAUDE.mdを短く保つコツ、読ませる量を絞る依頼で、トークンとコストを下げる方法を実例で。
Claude Codeの自作スラッシュコマンドを最新仕様で。.claude/commands/*.md の書き方、$ARGUMENTS・位置引数、frontmatter、スキル統合、チーム共有まで実例で解説。
Canvasがスマホで崩れぼやける原因はHiDPIと座標設計。Claude Codeに渡す条件文、コピペで動くコード、Playwright検証まで実体験で解説。
MarkdownをHTMLに変換するとき正規表現で見出しやリンクを拾うと事故る。remark/rehypeのパイプライン、rehype-sanitizeでXSS対策、目次生成、MDXとの違いを実コードで。
Claude Codeとペアプログラミングする時の役割分担・基本ループ・プロンプト例を、僕の失敗談つきで紹介。任せすぎて事故らないコツがわかる。
「いい感じにして」が通じない理由はモデルじゃなく頼み方。Claude Codeで効く具体性・文脈・出力形式・例示・反復の5コツを、Before/Afterの実例で。
正しさ・可読性・セキュリティ・テスト・設計の観点別チェックリストと、CLAUDE.mdに観点を入れてClaude CodeにPRの一次レビューをさせる手順を、僕の失敗込みで紹介します。
ブラウザのWeb Audio APIをやさしく解説。AudioContextの起動、Oscillatorで音を作る、Gain/Filterで加工、AnalyserNodeで波形表示、autoplay対策まで、コピペで動くコード付き。
ブラウザ内DBのIndexedDBをidbライブラリで簡潔に。localStorageとの違い、オブジェクトストアとインデックス、トランザクション、容量と永続化を動くコードで。
横スクロールが消えないのは設計順序のせい。モバイルファースト、clamp、コンテナクエリ、画像の出し分けまで、崩れないレスポンシブCSSの考え方を実例で。
ダークモード実装でほぼ全員がハマる「開いた瞬間だけ白くなる」ちらつき。CSS変数・prefers-color-scheme・head内スクリプトで消す手順を、僕の失敗込みで解説。
Claude Codeで毎日の開発を速くする実務Tips。よく使うワークフロー、CLAUDE.mdの効かせ方、権限の段取り、確認の省力化、つまずきを減らす小ワザを僕の失敗込みで紹介。
コミット前にESLintとPrettierを変更ファイルだけに走らせる仕組みを、husky + lint-stagedで構築。導入手順、commitlint、CIとの二重化、フックが遅い・効かない時の切り分けまで。
リストの並び替えやモーダルの退場はCSSだと詰む。Framer Motion(motion)のAnimatePresenceとlayout、Web Animations APIの使い分けを、コピペで動くReactコードで解説。
コメントとコードがズレた瞬間ドキュメントは嘘になる。JSDoc/TSDocからTypeDocでリファレンスを生成し、READMEとADRを陳腐化させない仕組みを、Claude Codeと検証スクリプトで回す手順にまとめました。
.prettierrcの書き方、eslint-config-prettierでの競合回避、保存時整形、CIのフォーマットチェックまで、コピペで動く設定で順番に固めます。
title/meta、JSON-LD構造化データ、sitemap、Core Web Vitals、内部リンク、AI回答エンジン対策まで。Webサイトを検索とAIに見つけてもらうための土台を、実装つきでまとめます。
CSV集計や画像処理でUIがカクつく原因と対策。Claude CodeにWeb Workerを型付きで実装させ、メインスレッドを止めない設計を実例コードで解説。
PRを小さく出し、指摘と提案を分け、トゲのないコメントを書く。レビューを溜めないチーム文化と、Claude Codeに一次レビューを任せて人間は設計に集中する運用を、僕の失敗込みで紹介します。
a11y対応は「最後にaxe」では遅い。セマンティックHTML優先、ARIAは最後、キーボードとフォーカス、コントラスト、実機確認まで実装順に解説するハブ記事。
npm publishでESM/CJS両対応のパッケージを公開する手順。package.jsonのexports、tsupビルド、型定義、npm packの中身確認、CI自動公開まで実例で。
ESLint v9以降の標準、Flat Config(eslint.config.js)の書き方を実例で。typescript-eslint連携、Prettierとの競合回避、CIでの実行まで僕の失敗込みで解説。
「SVG作って」だけだと色がハードコードされ、viewBoxが消え、ダークモードで死ぬ。僕が踏んだ罠とコピペで動く型を、アイコン・図解・最適化まで一気にまとめます。
Claude CodeでCSSを直すと別ページが崩れる——その原因と直し方を、僕の失敗込みで解説。レイヤー設計で優先順位を固定し、よくある崩れを順に潰す進め方。
個人とチームでGitのブランチをどう切るか。trunk-based developmentとgit-flowの違い、rebase/mergeの使い分け、コミット粒度、Claude Code併用の運用を実例で整理。
「僕のPCでは動く」を消す方法。devcontainer.jsonの書き方、features、postCreateCommand、Codespacesでの再現、Claude Codeを隔離して安全に走らせるコツを実例で。
Service Workerのinstall/activate/fetch、cache-first・network-first・stale-while-revalidateの使い分け、Workbox、古いSWが残る更新事故をコピペコードで。
useStateで足りるか、Zustandか、Jotaiか、Reduxか。サーバー状態はそもそも別物。規模と種類でライブラリを選ぶ判断軸を、コピペで動くコードと一緒に整理しました。
型推論を活かす、anyをunknownと型ガードで置き換える、strict設定、as constとリテラル型、エラーの読み方。実務で効くTypeScriptのコツを一人称で。
Drizzle ORMをClaude Codeで実装。SQLに近い書き味でスキーマ定義、drizzle-kitのマイグレーション、リレーショナルクエリ、Zod連携まで。Prismaとの違いも。
スケルトンスクリーンがスピナーより体感が速い理由と、CLSを起こさない実寸合わせの作り方。Suspenseとの組み合わせ、CSSの書き方、使う場面/使わない場面を実コードで。
Reactトースト通知の難所はキュー管理。複数同時表示の制御、ホバーで一時停止、重複のまとめ、aria-liveでの読み上げまでコピペで動くコードで解説。
CSS変数(カスタムプロパティ)の基本。--var と var()、:root とスコープ、継承、JSからの読み書き、ダークモード切替、フォールバックを、僕がハマった失敗込みで解説。
MSWでネットワーク層からAPIを横取りしてモックする手順。1つのhandlersをVitestのテストとブラウザ開発で共有し、Playwright併用や実APIへの切替まで実例で解説。
Reactモーダルのフォーカストラップ、ESCで閉じる、背景スクロール固定、aria-modal、フォーカス復帰、dialog要素と自作の違いを実装コード付きで。
Tailwind CSSのclassNameが伸びて崩れる前に。ユーティリティファースト、@applyの使いどころ、コンポーネント抽出、v4の変更点を実例で。
Flexboxの中央寄せ、両端+中央のナビ、等高カードをコピペで動くコードで紹介。横スクロールが消えないmin-width:0問題も実例で直します。
Reactのデータテーブルをソート・ページネーション・列フィルタ・仮想化まで実装。自前の最小コードとTanStack Tableの使い分け、アクセシブルなtableマークアップを紹介。
Reactで日付ピッカーを自作する手順。月グリッド生成、月送り、範囲選択、矢印キー操作、そして「日付が1日ずれる」タイムゾーンの罠まで、コピペで動くコードで解説。
grid-template-columns、fr、minmax、auto-fitでレスポンシブを最小コードで。Flexboxとの使い分けとはみ出し対策まで、コピペで動く例で解説。
リッチテキストエディタ実装の地雷を回避する。contenteditableの罠、TipTap/Lexical/ProseMirrorの違い、保存形式、XSSサニタイズ、ペースト処理を実コード付きで。
トップページが管理画面やグラフまで一緒に読み込んで重い。React.lazy+Suspense、Next.jsのdynamic、プリフェッチ、分割しすぎの罠まで、コピペで動く実装で送り分けを解説。
loading=lazyを全画像に付けてLCPが悪化した僕の失敗から、遅延させないヒーロー画像の見分け方、CLS対策、IntersectionObserverとの使い分けを実装で説明します。
@mediaと@containerをどう使い分けるか。端末名で増やさないブレークポイント設計と、Claude Codeに任せて崩れない依頼の型を実例で解説。
「npm update」一発で本番が落ちた失敗から学んだ依存管理の手順。lockfileの意味、^と~の違い、メジャー更新の進め方、Renovate自動化、npm auditまで。
React のドラッグ&ドロップを dnd-kit で実装。HTML5 Drag and Drop APIの限界、リスト並び替え、キーボード操作とタッチ対応まで、コピペで動くコード付き。
無限スクロールが本番で壊れる原因はsentinelの置き方と長大リストのDOM。IntersectionObserverの重複ロード防止、react-windowでの仮想化、戻る位置復元、SEO併用までReactで解説。
HttpOnly・Secure・SameSite・Domain・Path・Max-Age。Cookie属性の意味と決め方を、本番で踏んだ罠と一緒にNext.jsのコピペコードで解説します。
共有ボタンが半分の端末で無反応だった僕の失敗から、navigator.shareの使い方、HTTPSとタップ必須の制約、未対応時のコピー退避、ファイル共有まで実装で解説します。
大量リストが重い理由と、見えている範囲だけ描く仮想スクロールの作り方。react-window・TanStack Virtual・virtuaの選び方、固定/可変高さ、コピペ実装まで。
PVは伸びるのに何が効いたか分からない。GA4とPlausibleのイベント命名を固定し、計測漏れ・二重計測・同意管理(consent mode)まで実装で潰した記録。コピペで動くJS付き。
Claude CodeでFramer Motion(Motion for React)を実装。motion・variants・AnimatePresenceの使い方と、跳ねすぎ・exit不発を直した実例コードを公開。
クリックは増えたのに売上は減った。僕が踏んだ罠を起点に、Claude CodeでA/Bテストの割り当て・計測・有意差・ロールバックを安全に作る手順を解説。
コピーボタンが社内検証のスマホだけ無反応だった僕の失敗から、navigator.clipboard.writeTextの使い方、HTTPSと権限の制約、古いexecCommandへの退避、Reactでの成功表示まで実装で解説します。
if(flag)を足すだけでは本番で破綻する。フラグの種類分け、環境変数→DB→SaaSの段階実装、段階的ロールアウト、寿命管理までを僕の事故込みで実装解説。
.envと.env.localの使い分け、.gitignore、zodでの起動時バリデーション、本番への注入、クライアント露出の境界まで。環境変数を事故らせない型を作る。
JavaScriptでキーボードショートカットを実装する方法。keydown、修飾キー判定、入力中の無効化、?キーでヘルプ、Reactフックまでコピペで動く形で解説。
色だけの現在地表示は支援技術に伝わらない。aria-current・BreadcrumbListのJSON-LD・パスからの自動生成まで、コピペで動くReactコードで作る手順を僕の失敗込みで解説。
Pick・Omit・Partial・Record・ReturnType・Awaitedをいつ何に使うか、コピペで動く実例と落とし穴で整理。Claude Codeに型を任せる前に押さえたい基準。
TypeScriptのジェネリクスを、型引数の基本・extends制約・デフォルト型引数・Partialなどのユーティリティ型・実務の使い分けまで、コピペで動く例で整理。