메뉴
Maintain the OpenAPI contract in docs, regenerate TypeScript types into src/generated/api, and wire client/server imports without hand-editing generated files.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Introduce React Hook Form + Zod for form state, validation, and typed submission flows.
Add or update URL redirects in the server redirect registry, with status-code rationale and E2E coverage.
Configure the private route as a hidden admin utility. Moves credentials to env vars; operator updates .env using .envTemplate instructions. No credentials passed to the skill.
Migrate the current REST API usage to TanStack Query with server-state caching, invalidation, and progressive rollout.
Replace GitHub Actions CI with GitLab CI/CD while preserving the same lint, typecheck, and Playwright E2E behavior and updating docs for gitlab.com settings.
Migrate the client UI layer from Chakra UI to shadcn/ui and fully remove Chakra dependencies.
| name | api-first |
| description | Maintain the OpenAPI contract in docs, regenerate TypeScript types into src/generated/api, and wire client/server imports without hand-editing generated files. |
Use this skill when a task adds or changes HTTP API behavior, updates docs/openapi.yaml, or adjusts how API types are generated and consumed.
docs/openapi.yaml — human-reviewed contract; keep in sync with Express routes and response shapes.docs/API.md — endpoint inventory, REST rules, migration guidance.Do not treat generated TypeScript as documentation; treat the YAML + docs/API.md as the contract story.
npm run gen:api-typesdocs/openapi.yamlsrc/generated/api/openapi.generated.ts (openapi-typescript; do not edit)src/generated/api/api-types.ts — re-exports friendly names from components['schemas'] for client and server imports.After any YAML change, run gen:api-types and commit the updated openapi.generated.ts. Update api-types.ts when new schemas need stable export names.
@/generated/api/api-types for shared DTOs (path alias @/* → src/*).openapi.generated.ts directly from feature code unless you need path-level types; prefer api-types.ts for schemas.openapi-typescript (devDependency)openapi.generated.ts is ESLint-ignored (generated noise)npm run gen:api-types and fails if git diff --exit-code shows drift (stops committed spec from diverging from generated output). This boilerplate does not enforce that by default; add when the team wants strict parity checks.docs/openapi.yaml matches actual routes and status codesnpm run gen:api-types succeedsnpm run type-check passesdocs/API.md and docs/SCRIPTS.md still describe correct paths if you moved files@/generated/api/api-types (or documented exceptions).openapi.generated.ts.