Claude Code Skills が発火しない3ケース — ローカル・クラウド・stale前提の設計ギャップ実験ログ
Skills を整備したのに動かない。Claude Code を日常運用して踏んだ3つの非発火パターン(ローカル/クラウド境界・編集非反映・stale前提)と、再発防止のための設計判断軸を実装ログから整理する。
Claude Code を使った個人開発の実験ログ。環境構築から収益化まで、手を動かしながら身につく連載素材。
Skills を整備したのに動かない。Claude Code を日常運用して踏んだ3つの非発火パターン(ローカル/クラウド境界・編集非反映・stale前提)と、再発防止のための設計判断軸を実装ログから整理する。
クラウドルーティンがAI報告を信じてOKにしていたら、Zennデプロイが4日間止まっていた。push到達検証・RSS監視・Slack通知の3層でサイレント失敗を検知する設計の実装記録。
格安VPS(月1,100円前後)にClaude Code CLIを常駐させる方法と、Claude Code on the Web(CCR)のscheduled routineで代替する設計を比較・実録公開。Macを閉じたい個人開発者向けの2つの「ローカル解放設計」。
Claude Code の API 費用が月1万円を超えた段階で見直した設定6つの実録。CLAUDE.md 最小化・/clear 習慣・サブエージェント分離を組み合わせて消費量を大幅に削減した経緯と判断基準。
masatoman.net の CLAUDE.md(4,696文字・115行)が毎リクエストで消費するトークン数を文字種別に計測した記録。重いセクション上位3つと、参照置換によるトークン削減方針を示す。Claude Code を日常運用する個人開発者向け。
Claude Code on the Web(CCR)のクラウドルーチンにSkillを適用しようとして発見した設計の盲点。~/.claude/skills/はローカルファイルなのでクラウドからアクセス不可。回避策としてadapt-specファイルへ仕様を移植した実装記録。
「CLAUDE.md が200行超で指示遵守率が下がる」という二次情報を見て、自分の4リポジトリ(masatoman.net=114行、sns-automation=58行ほか)で実際に観察した記録。行数より構造・密度・位置が効くと分かった。Claude Code を日常運用する個人開発者向けの実験ログ。
Claude Code のコンテキストが100%に達すると自動圧縮(auto compact)が走り、圧縮後に状態喪失→コード暴走するパターンを実運用で確認。PreCompact hookによるログ退避・手動compact・セッション設計の3つの回避策を実装ログとして公開します。
QiitaとZennのCI frontmatterエラーが再発した。真因はLLMがテキスト指示を守れないこと。解決策はvalidate-frontmatter.shをpush前ゲートに埋め込むことだった。その実装判断の記録。
Cursor 等の従量課金に怯えるより、Claude Code を CLAUDE.md / Skills / routine で"運用設計"する方が、AI開発のコストと作業が読めるようになる。masatoman.net 周辺を実際にこの構成で回している立場から、設計の実録を書く。
Claude Code on the Web の RemoteTrigger は git repository sources のみ参照可能で、~/.claude/projects/ 配下の memory ファイルは環境外。memory-weekly-sync routine を作ろうとして詰まった制約と、Calendar reminder + 手動実行への切替判断を実体験ベースで解説します。
Claude Code の Agent を 6 本(デモ)+ ハブ 2 本の合計 8 本を background で並列起動し、1 セッション内に 14 ファイル / 5,000 行超を 30 分以内で生成した実験ログ。worktree isolation が使えない環境でも「新規ファイル作成のみ」制約テンプレートで干渉ゼロを実現する方法を解説します。
複数のAIに相談するとClaude Codeが自分の本来意図と異なる方向で実装を進める罠がある。5/22 実際にv6.0→revert→v7.0という混乱が起きた体験から学んだ「意図ズレ」の4つの構造と、防ぐための実践プロトコルを書く。
Shorts 説明文を 2 タップから 1 クリックに変える Chrome 拡張を Claude Code 1 セッションで完成。Manifest V3 最小構成・ytSpecButtonShapeNextHost 仕様・10 回失敗したセレクタ探索の突破パターンを一次情報で公開。
masatoman.net の全 110 記事を PageSpeed Insights API (mobile preset) で一括計測したら、perf >= 80 が 1 本も存在しなかった。平均 57.7、最高 68、12 本が 50 未満。ローカル desktop Lighthouse で 89-91 を確認していたのに完全に油断していた話と、原因の仮説を実数字で記録する。
demo-gallery を友人 LINE 拡散の前日に Playwright P1 監査したら、画像 11MB・OGP 完全欠落・Placeholder バグ・metadataBase 未設定の 4 件が発覚。さらにローカル Lighthouse で 30 台、本番で 90 台という計測ズレも判明。公開直後に最低限やるべきチェックと判断基準を実数字で記録する。
auto-recapを入れる前に試すべきClaude Code hookが3つあった。Stop hookでuntracked 84件を発覚させ、PreCompactで会話ログを自動退避し、UserPromptSubmitで危険操作前にgit情報を自動注入した実装記録。
Claude Code の AGENTS.md と CLAUDE.md、何が違ってどう使い分けるか。公式仕様(CLAUDE.md だけが読まれる)と @AGENTS.md import パターンを、Next.js + Supabase 個人開発のモノレポ実例で整理する判断軸ガイド。
Claude Code settings.jsonの場所(~/.claude/settings.json 等 4 階層)と優先順を実運用で確認済。permissions deny/allow・schemaエラーが出たときの対処・hooks・sandbox・model の実例付きリファレンス。
Claude Code Skill が呼ばれない / SKILL.md が肥大化 / subagent 化すべきか迷う、を公式仕様の読み解きと monorepo の Skill 実例で解決。description 設計・supporting files 分割・起動権限 4 パターンの判断軸を整理。
Claude Code の SKILL と MCP server、新しいタスクが来た時にどっちで作るべきか。公式仕様(Agent Skills + MCP)と個人開発モノレポの実例で、外部 I/O / 再利用範囲 / 起動コストの 3 軸で即答できる判断フローを整理。
Claude Code で対話量が多くタイピングがボトルネックになる本業エンジニア向けに、macOS 標準 / Wispr Flow / Superwhisper / VoiceInk の 4 つを比較。コードと自然言語で入力手段を分ける実用的な運用フローを解説します。
AI エージェントを外部システムに繋ぐ 3 アプローチ(MCP・CLI・API 直叩き)の使い分けを、Anthropic 公式ガイドと masatoman.net の運用実例で整理。複数プロダクトを回す個人開発者がどこで MCP に切り替えるべきかの判断軸を解説します。
最初の Skills 実装でハマった description 問題の記録。db-migration-checker を15分で作ったがスキルが呼び出されず、トリガー文の書き方を直すまでの過程と3つの落とし穴を実装ログとして残す。
Claude Code で自作 MCP サーバー(TypeScript)を呼び出す最小実装を全コード公開。`.mcp.json` 設定から `@modelcontextprotocol/sdk` 実装まで、詰まりポイント3点も解説。
Claude Code のサブエージェントを使って複数タスクを並列実行する設計パターンを解説。本業をしながら個人開発を進めるための「人間1人で複数Claudeを動かす」戦略の実装と具体例を公開します。
Claude Code の Hooks 機能で「人間が忘れがちな処理」を強制する設定方法を、実コード付きで解説。保存時 lint・コミット前テスト・本番DB保護まで、実運用 Hooks 5パターンを公開します。
Claude Code を VPS 上で 24 時間常駐させる構築手順を、masatoman.net の周辺自動化を運用している立場で全公開。サーバー選定・セキュリティ・コスト管理まで、実コード付きで解説します。
Skills、MCP、サブエージェント、Hooks を統合した個人開発の SaaS 構築フローを解説。LP 公開から課金開始までを 1 週間で組み立てるパイプラインの設計と実装を、月 500 万トークン運用の筆者が公開。「売れるかどうか」は別途検証が必要なので、本記事は「作る速度を上げる」フローに特化しています。
GitHub Issue が立った瞬間に Claude Code が実装し、PR を作成するまで自動化する仕組みを、実コード付きで解説。GitHub Actions + claude-code-action の組み合わせで、Issue 駆動開発を実現します。
Claude Code のサブエージェントを本番運用で並列実行する 5 パターンを実コード付きで全公開。masatoman.net + 周辺自動化を Claude Code で回している筆者が「実際に効いた構成」を有料記事で詳細解説します。
Supabase のテーブルを参照して管理画面を自動生成する Skill を、実コード付きで解説。Claude Code が DB スキーマから Next.js 管理画面を30分で生成する仕組みを公開します。
Claude Code Hooks を使った本番事故防止の本格運用を解説。git secrets 検出、本番DB保護、CI/CD組み込みまで、月500万トークン運用の筆者が実際に使っている安全装置を全公開します。
Claude Codeラボ全12話の集大成。Skills/MCP/サブエージェント/Hooks/リモート運用を統合した「自走する Claude 自動化」を、月 ¥5K の実コストで動かす全構成を公開。寝てる間に競合調査・記事下書き・PR まで自動化する 6 層アーキテクチャの完成版。
次に読む
→ ラボ連載を読む