메뉴
Scaffold a new backend HTTP endpoint / vertical slice in apps/backend (Zod schema + defineAction + service + mounter) following the slice conventions. Use when adding a backend endpoint, action, or resource.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | new-slice |
| description | Scaffold a new backend HTTP endpoint / vertical slice in apps/backend (Zod schema + defineAction + service + mounter) following the slice conventions. Use when adding a backend endpoint, action, or resource. |
Read apps/backend/README.md first - it is the source of truth for this
framework. apps/backend/tag/ is a minimal reference slice.
Location. Add to an existing domain folder under apps/backend/,
or create a new <slice>/ with actions/, schemas/, models/,
<slice>.service.ts.
Schema (Zod). Add <slice>/schemas/<shape>.ts exporting a Zod
value + inferred type. Name by role: Input (write body/query),
Filter (list query), Params (path ids). Barrel-export via
schemas/index.ts.
Action. <slice>/actions/<verb>.action.ts default-exports
defineAction({ body?|query?|params?, handler }). Verb-first filename
(get-source.ts); entity-prefix only inside resource-cluster
subfolders.
Service. Business/DB logic in <slice>/<slice>.service.ts.
Services accept inferred types (not req) and throw domain error
classes - never createError/HTTP.
Errors in the action. Map service domain errors via instanceof
and return createError(code, msg) (not throw).
Mount. Register via createActionMounter(...); declare literal
routes before :id routes. Mounter order drives OpenAPI sidebar order.
Client. Types flow to @tailor-cms/api-client automatically (regen
on boot) - never hand-edit generated output.
Verify. pnpm --filter tailor-server type-check; check /api/docs.
Draft a high-quality GitHub bug report from a QA observation - dedup, fill the bug_report form fields. DRAFT ONLY: it never files the issue; it hands you a ready `gh issue create` command to run yourself. Use when QA finds a defect to report.
Draft a GitHub proposal (feature / enhancement / task) - dedup, classify the type, fill the proposal form fields. DRAFT ONLY: it never files the issue; it hands you a ready `gh issue create` command to run yourself. Use when proposing new capability, an improvement, or a unit of work (not a defect - that's /report-bug).
Draft a clear, reviewer-ready pull request description for the current branch (or an existing PR) - feature-first summary, motivation, test plan, linked issues - verified against the real diff. DRAFT ONLY: it never creates, edits, or pushes; it hands you a ready `gh pr create`/`gh pr edit` command to run yourself. Use when writing up a PR.
Scaffold a new Tailor content extension - content element (ce), content container (cc), meta input (mi), or plugin (pl) - and wire it into the registry. Use when adding a new ce/cc/mi/pl extension to the platform.
Scaffold a Playwright Page Object plus a functional spec in tests/, following the POM conventions. Use when adding an end-to-end test for a feature or flow.
Turn a bug (GitHub issue number or description) into a failing Playwright spec that reproduces it - POM-based, tagged @bug, linked to the issue, and marked test.fail() so CI stays green until a fix flips it red. Use to capture a known bug as a regression-first test.
