メニュー
Single Zod-validated runtime configuration from process.env at app/src/config.ts, imported via @config. Use when adding or changing env vars, boot validation, or wiring new features to configuration.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/Off-Nominal/ndb2 --skill app-configコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Requires kebab-case filenames for modules under app/src/domain. Use when adding, renaming, or importing files in app/src/domain, or when a PR touches domain layout or @domain/* path aliases.
Extracts multi-step business rules from Express handlers into app/src/domain/<area>/ modules: DomainFailure + typed API error codes (no HTTP), success metadata only, reload/events at transports. Use when adding or refactoring domain functions (e.g. placeBet), migrating a fat v2 route or web handler, splitting integration tests between domain and HTTP, or deciding where eventsManager.emit and getById reload belong.
Prefer Zod for runtime validation of env vars, HTTP inputs, and parsed external data. Instructs checking the installed library version (e.g. Zod 3 vs 4) and matching official docs and examples to that version so APIs are not outdated or deprecated. Covers ndb2 shared validation layout (@shared/validation/domain vs http, route-local composition). Use when adding validation, parsing request bodies or query strings, validating environment configuration, or refactoring manual checks into schemas.
SOC 職業分類に基づく
SKILL.md を表示中
| name | app-config |
| description | Single Zod-validated runtime configuration from process.env at app/src/config.ts, imported via @config. Use when adding or changing env vars, boot validation, or wiring new features to configuration. |
@config)app/src/config.ts — builds export const config once at import time with Zod 4. On validation failure it logs formatConfigError (each issue mapped to the real process.env name, e.g. DATABASE_URL) in red on stderr when supported, then process.exit(1) — it does not rethrow ZodError, so Node will not print a second JSON dump/stack for that case. Set NO_COLOR to disable ANSI; set FORCE_COLOR=1 to force color when stderr is not a TTY.import { config } from "@config" — path alias in app/tsconfig.json ("@config": ["src/config.ts"]), mirrored in app/vitest.shared.ts. Do not use relative imports to the config file from feature code.process.env elsewhere in app/src for application behavior (tests may set process.env before modules load; see below).buildRawFromProcessEnv() in config.ts.rawConfigSchema / appConfigSchema.transform output with a clear, grouped shape (discord, api, database, etc.).app/.env.example so required keys are documented.Follow Zod major-version APIs per .cursor/skills/input-validation/SKILL.md.
DATABASE_URL, Discord OAuth and web-portal fields (DISCORD_OAUTH_*, DISCORD_BOT_TOKEN, OFFNOMDISCORD_GUILD_ID, at least one ROLE_ID_*), DISCORD_CLIENT_API_KEY, GM_PREDICTION_UPDATE_WINDOW_HOURS, etc. — see rawConfigSchema for the canonical list.WEBHOOK_DISCORD_BOT (empty → no webhook subscribers), WEB_DISCORD_AUTHZ_RECHECK_HOURS (invalid values fall back to 24 hours), PORT / PG_POOL_MAX defaults.app/src/test/install-test-env.ts runs first (Vitest setupFiles and as the first import in app/src/test/global-setup.ts) so process.env is complete before any import pulls in @config (via @shared/utils or other modules).app/src/data/db/index.ts uses process.env.DATABASE_URL ?? config.database.url so integration tests can point at an ephemeral DB after resetPoolForTests().resolveTrustProxy / TrustProxyResolved — trust proxy behavior; configureTrustProxy(app) uses config.server.trustProxy, or pass configureTrustProxy(app, resolveTrustProxy(...)) in tests.collectWebPortalRoleIdsFromEnv — collects ROLE_ID_* from a given env object (used when building config).