local-build-reminder

ローカルビルドのリマインダー

OMC フォークの開発時に常に適用されるリマインダーです。 OMC がローカルモードで実行されている場合（HUD に L サフィックス付きの [OMC#X.Y.ZL] が表示されます）、Claude Code は src/ の TypeScript ソースではなく、dist/ のコンパイル済み JavaScript を読み込みます。.ts ファイルへの変更は、npm run build で dist/ を再生成するまで、実行中のプラグインには反映されません。

このスキルを使うタイミング

次のいずれかが発生したら、AI はこのリマインダーを伝えてください。

1. ユーザー（または AI 自身）が、このリポジトリの src/**/*.ts を編集した直後。
2. TypeScript の編集後に、ユーザーが「変更が反映されないのはなぜですか？」／「X を編集したのに同じ動作をします」と尋ねたとき。
3. ユーザーが Claude Code を再起動しようとしていて、作業ツリーにビルドしていない TypeScript の編集があるとき。
4. ユーザーが OMC コマンドを実行し、TypeScript の編集に関連する新しい動作を期待しているとき。

伝える内容

明確な一文の後に、正確なコマンドを伝えてください。毎回の応答でリマインダーを繰り返さないでください。TypeScript の編集を行う「一連の作業」につき一度で十分です。例：

注意：src/... を編集しました。Claude Code を再起動する前に npm run build を実行してください。そうしないと、変更が dist/ に反映されません。

TypeScript ファイルを続けて複数編集した場合は、最後に一度だけリマインダーを伝えてください。

リマインダーを伝えない場合

• ユーザーが編集したのが .mjs／.cjs／.md／.json だけの場合。これらはディスクから直接読み込まれるため、ビルドは不要です。
• ユーザーが、OMC をローカル実行していない Claude Code セッションを使用している場合（HUD に L がない）。
• tsc --watch／npm run dev:full がバックグラウンドですでに実行されている場合。保存時に自動で再ビルドされます。
• ユーザーが無関係な質問をした直後の場合。話題にそぐわない応答にリマインダーを無理に加えないでください。

ファイル形式の早見表

パス	再起動時に編集内容が反映されるか	ビルドが必要か
src/**/*.ts	ビルド後のみ	はい
templates/hooks/**/*.mjs	はい	いいえ
scripts/**/*.mjs / *.cjs	はい	いいえ
skills/**/SKILL.md	はい	いいえ
agents/**/*.md	はい	いいえ
commands/**/*.md	はい	いいえ
.claude-plugin/plugin.json	はい（Claude の再起動時）	いいえ
docs/**/*.md	外観のみ	いいえ

ハンズフリー開発向けのワンコマンドセットアップ

ユーザーが頻繁に編集していて、ビルドを覚えておくのが面倒そうな場合は、次を提案してください。

npm run dev:full

これは tsc --watch とすべてのブリッジビルダーを並行して実行します。保存するたびに 1 秒以内に再ビルドされるため、その後は restart Claude Code だけで済みます。

検出シグナル — AI が「ローカルモード」と判断する方法

HUD の [OMC#X.Y.ZL] サフィックスが目視できる手掛かりです。プログラム上の検出処理は src/lib/version.ts::isRuntimePackageLocal() にあり、パッケージルートに .git/ または src/ がある場合、シンボリックリンク／ジャンクションを経由してパッケージにアクセスしている場合、または親ディレクトリのいずれかがシンボリックリンク／ジャンクションである場合に検出されます。

OMC フォークのリポジトリ内で実行している場合、AI は定義上ローカルモードです。常にリマインダーが適用されます。