Local Build Reminder

Always-on reminder for OMC fork development. When OMC is running in local mode (HUD shows [OMC#X.Y.ZL] with an L suffix), Claude Code loads compiled JavaScript from dist/ — NOT TypeScript source from src/. Edits to .ts files are invisible to the running plugin until npm run build regenerates dist/.

When to invoke this skill

The AI should mention this reminder whenever any of these happens:

The user (or the AI itself) just edited src/**/*.ts in this repo.
The user asks "why isn't my change working?" / "I edited X but it does the same" after a TS edit.
The user is about to restart Claude Code and the working tree has TS edits with no rebuild.
The user runs an OMC command and expects new behavior tied to a TS edit.

What to say

Surface one clear sentence followed by the exact command. Don't repeat the reminder on every turn — once per "round" of TS editing is enough. Example:

Heads up: you edited src/.... Run npm run build before restarting Claude Code — dist/ won't reflect the change otherwise.

If multiple TS files were edited in a row, just remind once at the end.

When NOT to remind

The user only edited .mjs / .cjs / .md / .json — those load directly from disk, no build needed.
The user is in a Claude Code session that isn't running OMC locally (no L in the HUD).
A tsc --watch / npm run dev:full is already running in the background — those rebuild automatically on save.
The user just asked an unrelated question; don't shoehorn the reminder into off-topic responses.

File-type cheat sheet

Path	Restart picks up edit?	Needs build?
`src/*/.ts`	Only after build	Yes
`templates/hooks/*/.mjs`	Yes	No
`scripts/*/.mjs` / `*.cjs`	Yes	No
`skills/**/SKILL.md`	Yes	No
`agents/*/.md`	Yes	No
`commands/*/.md`	Yes	No
`.claude-plugin/plugin.json`	Yes (on Claude restart)	No
`docs/*/.md`	Cosmetic only	No

One-command setup for hands-free dev

If the user is iterating heavily and tired of remembering the build, suggest:

powershell

npm run dev:full

This runs tsc --watch plus all bridge builders in parallel — every save triggers a rebuild within a second, so restart Claude Code is all that's needed afterwards.

Detection signal — how the AI knows it's "local mode"

The HUD's [OMC#X.Y.ZL] suffix is the visible cue. Programmatically, the detection lives in src/lib/version.ts::isRuntimePackageLocal() and triggers on any of: .git/ at package root, src/ at package root, package reached via symlink/junction, or any ancestor is a symlink/junction.

When running inside the OMC fork repo itself, the AI is by definition in local mode — the reminder always applies.