メニュー
Esposter pnpm script reference — packages/app scripts (lint, typecheck, test, format, dev, build) and the root scripts (test, coverage, depcruise:graph, outdated:dependencies). Apply whenever running or recommending package scripts.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Esposter TypeScript conventions — banned patterns (Omit over Except, forEach, parameter properties, the void operator), as unknown as treated like any (model the type instead; the rare mock and library-seam exceptions), declare over ! on class fields, arrow functions and overloads, neverthrow promise style, InvalidOperationError, guard clauses, exhaustive switch guards, enum naming/refs/values arrays, discriminant-keyed maps for polymorphic dispatch, and the string "" sentinel with the null-vs-undefined rules. Apply when writing any TypeScript in this project.
Esposter vue-phaserjs integration patterns — component inventory, markRaw for Phaser objects in Pinia stores, configuration Pick pattern, all-configuration-keys-present-at-setup. Apply when writing Phaser game objects, stores, or vue-phaserjs components.
Esposter git workflow conventions — commit message format, safety rules, and branch hygiene. Apply when running git operations or advising on source control workflows.
Esposter Vitest testing conventions — describe with function refs, canonical test values, takeOne for unsafe index access, destructuring from stores/composables, mock session patterns (getMockSession/mockSessionOnce/replayMockSession), mock cleanup by creation style, toThrowErrorMatchingInlineSnapshot as the only error assertion, the node-default test environment (nuxt only via per-file directive; stub window for client/server paths), bundle-size snapshot tests, and type-level conventions for .test-d.ts files. Apply when writing .test.ts or .test-d.ts files.
Esposter responsive/mobile UI conventions — command bars collapse into a single overflow dropdown of icon+text list items on narrow viewports, which controls never collapse, and when flex-wrap is the allowed exception. Apply when adding or editing any toolbar, action row, or button group that must work on mobile.
Esposter Vue 3 component architecture — the shared Styled/App shell primitives, same level of abstraction, the wrapper + pure-child pattern for async data, generic SFCs, per-variant type correctness, is-prefixed boolean props typed as the non-default literal, present-tense emit names, component folder naming and Nuxt auto-import name collapse, defineSlots and conditional slot forwarding, slot extraction, array + v-for over hardcoded list items, shared list-item shells with action slots, permission-filtered action items, one affordance per action, singleton dialogs over per-item dialogs, page decomposition, and maximal component granularity. Apply when designing, decomposing, naming, or refactoring Vue components.
| name | package-scripts |
| description | Esposter pnpm script reference — packages/app scripts (lint, typecheck, test, format, dev, build) and the root scripts (test, coverage, depcruise:graph, outdated:dependencies). Apply whenever running or recommending package scripts. |
packages/app scripts run from packages/app/; root scripts run from the repo root. Always pnpm — never npm or npx.
packages/app| Command | Runs | When to use |
|---|---|---|
pnpm lint | TIMING=1 eslint --config eslint.light.config.js . | CI/check-only lint verification |
pnpm lint:fix | TIMING=1 eslint --config eslint.light.config.js --fix . | Local lint verification — use this directly |
pnpm lint:all | TIMING=1 eslint . (full config) | Full lint pass (slower) |
pnpm lint:all:fix | TIMING=1 eslint --fix . | Fix all lint errors (full pass) |
pnpm typecheck | nuxt typecheck | TypeScript type checking |
pnpm test | vitest (watch mode) | Run this package's tests in watch mode |
pnpm format | oxfmt | Format code |
pnpm format:check | oxfmt --check | Check formatting without writing |
pnpm dev | nuxt dev | Start dev server |
pnpm build | nuxt build | Build for production |
Oxlint is not part of any package's
lintscript — it runs as a single repo-wide pass from the rootpnpm lint/pnpm lint:fix(one.oxlintrc.jsonat the repo root). Packages run ESLint only.
| Command | Runs | Notes |
|---|---|---|
pnpm i | — | Refresh deps/lockfile after manifest changes. |
pnpm test | virrun -- vitest run | Whole suite once via unified root vitest projects config (all packages + scripts). |
pnpm test:packages | virrun -- vitest run --project "!@esposter/app" | All projects except the app — fast local run, skips Nuxt. Local-only. |
pnpm coverage | vitest run --coverage (no virrun) | Root-only (packages have no coverage script). CI shards via --reporter=blob + --merge-reports. |
pnpm outdated:dependencies | tsx scripts/checkDependencies/index.ts | Checks manifests use catalog:/workspace:, and catalog/configDependency/engines specifiers against the lockfile + npm latest. |
pnpm depcruise:graph | virrun -- depcruise … | graphviz -Tsvg | Generate dependency-graph.svg. |
On PR-bound work the suite runs once on develop after the merge, not on the feature branch — see the git skill's "Merge Then Verify". Run before declaring work done:
pnpm typecheckpnpm lint:fix — only for packages/* (non-app); skip when the change touches packages/app (slow), leave that to CI.pnpm test -u --run — only when actual code changed (not for test-only or doc edits). -u refreshes snapshots, --run forces a single non-watch run.Test-only changes: just run the affected test file(s) — no full test -u --run sweep needed.
pnpm lint:fix directly (packages only, not app) — never hand-edit to satisfy the linter. Reserve pnpm lint/pnpm lint:all for CI.spawn EPERM config-startup crash is fixed via the minimal Vitest module allowlist in packages/app/configuration/modules.ts.dev, build, test, typecheck): use run_in_background: true (2+ min).pnpm <script> -- <args>: pnpm forwards the literal --, so trailing flags become post--- positionals and are dropped. Use pnpm exec <binary> <args> or direct args (pnpm test -u).