메뉴
Watch mode development using Node --experimental-transform-types. No transpiler needed. Watches ./src/, restarts on changes. Custom entry files supported. Experimental command — may change. Use when running TypeScript in dev mode.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
TypeScript to ESM compilation via tsdown with opinionated defaults. Sourcemaps, clean dist/, unbundled output, .d.mts types by default, publint publish gate. Flags: --no-dts, --bundle, --minify. Default entry src/**/*.ts. Use when building a package for publish or generating declarations.
Code formatting via oxfmt with project configuration. Tabs, single quotes, semicolons always, trailing commas, 100-char line width. Use when formatting source files before committing.
Scaffold new Bombshell project from bombshell-dev/template via giget. Replaces $name placeholder in package.json and README.md. Outputs to .temp/. Use when creating a new package in the Bombshell ecosystem.
TDD-driven development workflow for Bombshell projects using bsh CLI. Covers pnpm run as only entry point, command ordering (test→implement→lint→format→build→test), monorepo vs single-package detection with pnpm --filter, human-owned PRs. Use when starting work on any project that depends on @bomb.sh/tools.
Multi-tool linting pipeline: oxlint, knip, and tsgo run in parallel via pnpm run lint (publint gates pnpm run build instead). Covers Bombshell conventions: URL over node:path, max 2 params with options bag, named exports only, import type, prefer node builtins, no console.log, no generic Error. Use when checking code quality or understanding lint violations.
Migrate existing project to bsh toolchain. Remove prettier, biome, eslint, tsup, unbuild, rollup, vitest configs and dependencies. Replace scripts with bsh equivalents. Adopt createMocks and createFixture from @bomb.sh/tools/test-utils. Consolidate to single @bomb.sh/tools devDependency. Migration order: inventory existing tools, add unimplemented commands, replace 1:1 commands, remove configs and deps, adopt test-utils, verify. Use when onboarding a project to the Bombshell ecosystem.
| name | dev |
| description | Watch mode development using Node --experimental-transform-types. No transpiler needed. Watches ./src/, restarts on changes. Custom entry files supported. Experimental command — may change. Use when running TypeScript in dev mode. |
| metadata | {"type":"core","library":"@bomb.sh/tools","library_version":"0.6.0","requires":["lifecycle"],"sources":["bombshell-dev/tools:src/commands/dev.ts"]} |
Runs a TypeScript file with native Node TypeScript support and watches for changes.
pnpm run dev
pnpm run dev runs bsh dev which shells out to:
node --experimental-transform-types --no-warnings --watch-path=./src/ <file>
./src/index.ts./src/ — restarts on any change in the source directory--experimental-transform-typespnpm run dev -- ./src/other.ts
Additional arguments after the file path are passed through to Node.
This is an experimental command that relies on Node's --experimental-transform-types flag. Most Bombshell packages use a TDD loop (pnpm run test) as their primary development workflow rather than the dev server. The dev command is useful for running scripts or servers during development, not as the main iteration cycle.
Tension: Dev command stability vs experimental Node features. The underlying
--experimental-transform-typesflag may change behavior between Node versions. If you hit issues, fall back to the test-driven workflow.
Node handles TypeScript natively. External transpilers are unnecessary and add complexity.
# Wrong
npx tsx src/index.ts
npx tsx watch src/index.ts
npx ts-node src/index.ts
node -r ts-node/register src/index.ts
# Correct
pnpm run dev
These packages are not needed in Bombshell projects.
// Wrong — package.json
{
"devDependencies": {
"tsx": "^4.0.0",
"ts-node": "^10.0.0",
"esbuild-register": "^3.0.0"
}
}
// Correct — no transpiler dependencies needed
{
"devDependencies": {
"@bomb.sh/tools": "^0.3.1"
}
}
build/SKILL.md — Both handle TS compilation in different modes