feat(typescript-guidelines): fire on JavaScript, gate on Standard §3.1.1

[UnbreakableMJ]

The problem

Standard §3.1.1 landed in #23: wherever the JavaScript runtime is required, source MUST be TypeScript. But this skill's description ended with:

Do NOT trigger for standard JavaScript (unless type-safety is requested) or other languages.

That negative trigger is now actively wrong. The one moment the skill most needs to load is when someone reaches for plain JavaScript — because that is exactly when §3.1.1 says stop, write TypeScript instead. As written, the skill reached only people who had already chosen TypeScript: the audience that needs the rule least. A rule that cannot reach its audience is not in force.

The fix

Trigger (the important half). The negative JS trigger is replaced by a positive one — .js/.mjs/.cjs, package.json, Node/Deno/Bun, Electron, npm packages, VS Code extensions, browser scripts — with the reason stated inline, so the loading agent knows what to do on arrival: convert it, or file the exemption. Do NOT trigger for other languages is kept.

Paying for the added text: the project references (composite, incremental) and V8 clauses were trimmed. 966 rendered characters against the §5.6 cap of 1000.

Body. New ## §3.1.1 — TypeScript over JavaScript (read this first) section ahead of Core Philosophy, giving a four-step gate:

1. Is a memory-safe alternative available (Rust→Wasm, Rust/Go server, Flutter/Dart UI)? §3.1 chooses it over the JavaScript runtime entirely.
2. Is the JS runtime genuinely required? Author it in TypeScript — do not write the .js and offer to convert later.
3. Does a no-filing exemption cover it (tool config that must be .js, vendored/§4.2 file, generated output)? Emitted .js is a derived artifact and out of scope.
4. Anything else — including "it is only a small script" — needs a documented technical exemption, stated plainly rather than written silently.

Plus a note that converting a .js with a rename that leaves any everywhere satisfies neither §3.1.1 nor this skill, and that transpiling is not typechecking (esbuild/SWC/Bun strip types without checking them; tsc --noEmit gates CI).

Anti-Patterns gains authoring stray .js, @ts-ignore, and bundler-only CI. Pre-commit checklist gains two §3.1.1 lines.

Verification

• Description: 966 rendered chars, under the §5.6 cap (CI's skill-description gate re-checks this)
• reuse lint — compliant
• Both bundles rebuilt and byte-verified (unzip -p … | diff -) against the working tree

🤖 Generated with Claude Code

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.