new-course-phase

스타12

포크6

업데이트2026년 7월 15일 07:13

Scaffold a new PROMPT 2.0 course phase end-to-end — a micro-frontend (clients/) plus a Go microservice (servers/) wired into Module Federation, the workspaces, and docker-compose. Use when asked to add a new course phase, component, or phase module/service.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

출처

prompt-edu

prompt-edu/prompt

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Frontend component

Copy the example: cp -R clients/example_component clients/<name>_component.
In clients/<name>_component/webpack.config.mjs update the two constants near the top: const COMPONENT_NAME = '<name>_component' and const COMPONENT_DEV_PORT = <unique-port> (existing ports: core 3000, example 3001, interview 3002, matching 3003, assessment 3007, team_allocation 3008, self_team_allocation 3009 — pick a free one).
Set "name": "<name>_component" in clients/<name>_component/package.json.
Register the workspace in BOTH clients/lerna.json (packages) and clients/package.json (workspaces.packages).
Register the remote in clients/core/webpack.config.mjs remotes: using the cache-busting pattern (see the module-federation-remote skill for the exact line and the matching URL env var).
Load it lazily in core: const X = React.lazy(() => import('<name>_component/App')).
cd clients && yarn install so the workspace resolves.

Backend service

Copy the example: cp -R servers/example_server servers/<name>.
In servers/<name>/go.mod set the module path to github.com/prompt-edu/prompt/servers/<name> and update internal imports accordingly.
Define schema + queries (use the sqlc-migration skill): migrations in db/migration/ as 0001_<desc>.up.sql, queries in db/query/*.sql, then run sqlc generate (config in servers/<name>/sqlc.yaml).
Implement business logic in <module>/service.go, routes in <module>/router.go under /api/course_phase/:coursePhaseID (required for prompt-sdk auth — see the go/auth-routing rule), validation in <module>/validation.go.
Keep the config/ and copy/ packages from the example (phase config + copy endpoints) and wire them in main.go (InitAuthenticationMiddleware, RegisterConfigEndpoint, RegisterCopyEndpoint).

docker-compose wiring

Add a server-<name> service (copy the server-example block): build context ./servers/<name>, dockerfile: ../Dockerfile, unique published port mapped to 8080, depends_on its db + keycloak (condition: service_healthy), and the DB_*/KEYCLOAK_*/ CORE_HOST/SERVER_CORE_HOST env vars (rename *_EXAMPLE_* → *_<NAME>_*).
Add a client-<name>-component service (copy client-example-component).
Add a dedicated database service (copy db-example-server → db-<name>) with its own postgres_<name>_data volume. Each microservice uses a SEPARATE Postgres database.
Add the matching DB_*_<NAME>_* entries to .env.template and .env.dev.template.

Verify

make setup-skills not needed here. Run cd servers/<name> && go build ./... and go test ./...; cd clients && yarn install; make lint.
Start the phase (make clients, the new server target) and confirm core lazy-loads the remote.
Source of truth for these conventions: AGENTS.md ("Creating New Course Phases") and the .claude/rules/ stack files.

이 저장소의 다른 Skills

같은 저장소

add-shared-ui-component

prompt-edu/prompt

Add or reuse a shared UI component in PROMPT 2.0 — install shadcn/ui primitives into the shared_library and surface them via @tumaet/prompt-ui-components instead of writing custom UI. Use when adding a button/dialog/table/form or any reusable UI element.

2026-07-0112

address-pr-comments

prompt-edu/prompt

Address unresolved review comments on the current branch's GitHub PR — fetch the open threads, fix the code, and push. Use when asked to handle, resolve, or respond to PR review comments/feedback.

2026-07-0112

docker-patterns

prompt-edu/prompt

Docker Compose patterns for PROMPT's local multi-service stack — networking, volumes, container security, and debugging. Use when editing docker-compose*.yml, adding a service, or troubleshooting containers.

2026-07-0112

github-release-creation

prompt-edu/prompt

Create a GitHub release for the PROMPT 2.0 repository. Use this when asked to create, draft, or publish a GitHub release.

2026-07-0112

golang-patterns

prompt-edu/prompt

Deeper idiomatic Go patterns for PROMPT's services — concurrency (errgroup, context, goroutine leaks), error wrapping, and performance idioms. The go/ rules point here for these; they own the Gin/pgx/sqlc conventions.

2026-07-0112

keycloak-local-setup

prompt-edu/prompt

Get Keycloak auth working for local PROMPT 2.0 development — the .env vs .env.dev split, realm import, and common auth failures (401/403/CORS). Use when setting up local dev, fixing login/token issues, or onboarding a new contributor.

2026-07-0112

name	new-course-phase
description	Scaffold a new PROMPT 2.0 course phase end-to-end — a micro-frontend (clients/) plus a Go microservice (servers/) wired into Module Federation, the workspaces, and docker-compose. Use when asked to add a new course phase, component, or phase module/service.

Frontend component

Copy the example: cp -R clients/example_component clients/<name>_component.
In clients/<name>_component/webpack.config.mjs update the two constants near the top: const COMPONENT_NAME = '<name>_component' and const COMPONENT_DEV_PORT = <unique-port> (existing ports: core 3000, example 3001, interview 3002, matching 3003, assessment 3007, team_allocation 3008, self_team_allocation 3009 — pick a free one).
Set "name": "<name>_component" in clients/<name>_component/package.json.
Register the workspace in BOTH clients/lerna.json (packages) and clients/package.json (workspaces.packages).
Register the remote in clients/core/webpack.config.mjs remotes: using the cache-busting pattern (see the module-federation-remote skill for the exact line and the matching URL env var).
Load it lazily in core: const X = React.lazy(() => import('<name>_component/App')).
cd clients && yarn install so the workspace resolves.

Backend service

Copy the example: cp -R servers/example_server servers/<name>.
In servers/<name>/go.mod set the module path to github.com/prompt-edu/prompt/servers/<name> and update internal imports accordingly.
Define schema + queries (use the sqlc-migration skill): migrations in db/migration/ as 0001_<desc>.up.sql, queries in db/query/*.sql, then run sqlc generate (config in servers/<name>/sqlc.yaml).
Implement business logic in <module>/service.go, routes in <module>/router.go under /api/course_phase/:coursePhaseID (required for prompt-sdk auth — see the go/auth-routing rule), validation in <module>/validation.go.
Keep the config/ and copy/ packages from the example (phase config + copy endpoints) and wire them in main.go (InitAuthenticationMiddleware, RegisterConfigEndpoint, RegisterCopyEndpoint).

docker-compose wiring

Add a server-<name> service (copy the server-example block): build context ./servers/<name>, dockerfile: ../Dockerfile, unique published port mapped to 8080, depends_on its db + keycloak (condition: service_healthy), and the DB_*/KEYCLOAK_*/ CORE_HOST/SERVER_CORE_HOST env vars (rename *_EXAMPLE_* → *_<NAME>_*).
Add a client-<name>-component service (copy client-example-component).
Add a dedicated database service (copy db-example-server → db-<name>) with its own postgres_<name>_data volume. Each microservice uses a SEPARATE Postgres database.
Add the matching DB_*_<NAME>_* entries to .env.template and .env.dev.template.

Verify

make setup-skills not needed here. Run cd servers/<name> && go build ./... and go test ./...; cd clients && yarn install; make lint.
Start the phase (make clients, the new server target) and confirm core lazy-loads the remote.
Source of truth for these conventions: AGENTS.md ("Creating New Course Phases") and the .claude/rules/ stack files.