From 9a3649342e355025a1ee45d38f7e1df0bf89b774 Mon Sep 17 00:00:00 2001 From: sangwook yoo Date: Thu, 4 Jun 2026 14:07:48 +0900 Subject: [PATCH] =?UTF-8?q?chore(skills):=20grill-me=20=EC=8A=A4=ED=82=AC?= =?UTF-8?q?=20=EC=B6=94=EA=B0=80=20+=20CLAUDE.md=20=EB=A7=88=ED=81=AC?= =?UTF-8?q?=EB=8B=A4=EC=9A=B4=20=ED=8F=AC=EB=A7=B7=20=EC=A0=95=EB=A6=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - .agents/skills/grill-me/SKILL.md, skills-lock.json 추가 - CLAUDE.md 섹션 사이 빈 줄 보정 및 Always Do의 type check 항목 제거 Co-Authored-By: Claude Opus 4.8 (1M context) --- .agents/skills/grill-me/SKILL.md | 10 ++++++++++ CLAUDE.md | 12 +++++++++++- skills-lock.json | 11 +++++++++++ 3 files changed, 32 insertions(+), 1 deletion(-) create mode 100644 .agents/skills/grill-me/SKILL.md create mode 100644 skills-lock.json diff --git a/.agents/skills/grill-me/SKILL.md b/.agents/skills/grill-me/SKILL.md new file mode 100644 index 00000000..bd04394c --- /dev/null +++ b/.agents/skills/grill-me/SKILL.md @@ -0,0 +1,10 @@ +--- +name: grill-me +description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me". +--- + +Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer. + +Ask the questions one at a time. + +If a question can be answered by exploring the codebase, explore the codebase instead. diff --git a/CLAUDE.md b/CLAUDE.md index 476d90d1..060ccde3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -31,14 +31,17 @@ PM2 entrypoints (`ecosystem.config.js`, `prd1/prd2/dev/dev.local.ecosystem.confi ## Architecture — the parts that span many files ### Mode routing through `src/config/` + Runtime config is selected at module load by `src/config/config.export.js`, which switches on `process.env.NEXT_PUBLIC_RUN_MODE` between `config.local.js`, `config.local.dev.js`, `config.development.js`, `config.production.js`. Never read env values directly in feature code — import from here so mode switches stay in one place. ### Session / auth gate + `iron-session` cookies are the session source of truth (`src/lib/session.js`, `src/lib/authActions.js`). `src/app/layout.js` checks the session at the root and redirects every non-login route to `/login` when missing. `SESSION_SECRET` must be set (≥32 bytes). The session also carries `storeLvl` (1차/2차 판매점) which drives quote-render branches, builder number, and group ID. Q-Order / Q-Musubi support **autoLogin** flows via `NEXT_PUBLIC_Q_ORDER_AUTO_LOGIN_URL` / `NEXT_PUBLIC_Q_MUSUBI_AUTO_LOGIN_URL`. `src/middleware.js` injects `x-pathname` into request headers so the root layout can branch on the active route. ### Floor Plan canvas (the heart of the app) + `src/app/floor-plan/**` is built on **Fabric.js 5.5.2**. The model has three layered concerns: 1. **Roof covering** (`hooks/roofcover`, `components/floor-plan/modal/roofShape` / `outerlinesetting` / `eavesGable` …): outer wall lines, auto/manual roof-shape detection, guides, eaves & kerabs, flow up/down, outer-line edit & offset, roof-face assignment. @@ -54,9 +57,11 @@ A modal under `components/floor-plan/modal/` pairs with a hook under `h **Plan persistence** (serialize/restore) is in `src/lib/canvas.js` and `src/util/canvas-util.js`. Recent commits (`a5e794b3`, `2aef32e0`) added a three-layer guard (entry / cache / save) and `SizeSetting` input guards against 0-area apertures/shadows/dormers — when touching plan load/save or size inputs, do not weaken or remove these guards without understanding the failure mode (`InvalidStateError` from corrupted plans). ### State — Recoil, split by domain + Atoms live under `src/store/` and are split by domain (`canvasAtom`, `roofAtom`, `estimateAtom`, `modalAtom`, `menuAtom`, `settingAtom`, …). When adding state, find the existing domain atom rather than introducing a new global. `RecoilWrapper.js` mounts the root; `QcastProvider.js` composes the rest of the global providers (session, global data, global loading) for the App Router root layout. ### Build / runtime quirks + - `next.config.mjs` sets `resolve.fallback = { fs: false }` and externalizes `canvas`, `utf-8-validate`, `bufferutil` as commonjs. Adding a node-only dep usually means adding it to that externals list. - `experimental.staleTimes` are all **0** on purpose — App Router cache is disabled so plan/estimate pages always refetch. Don't re-enable without checking the plan-stale failure mode. - `reactStrictMode: false`. Don't assume double-render semantics. @@ -69,15 +74,19 @@ Atoms live under `src/store/` and are split by domain (`canvasAtom`, `roofAtom`, - **Path alias** — prefer `@/...` over relative `../../..` chains. - **Logging** — never `console.log` directly in shipped code. Use `src/util/logger.js`, which no-ops unless `NEXT_PUBLIC_ENABLE_LOGGING=true`. `src/util/debugCapture.js` POSTs to `/api/debug` for server-side capture (also gated by the same flag). - **Commit messages** follow `.gitmessage.txt`: + ``` [일감번호] : [제목] [작업내용] : ``` + Recent commits use a slightly tighter `[2204] — ` form; mirror neighboring commits on the branch. + - **`.env.*`** can contain real secrets — never paste contents into PR bodies, issues, or chat. `.env.*.local` is gitignored for machine-local overrides. ## Reference docs in `docs/` + - `Canvas Status.md` — canvas feature status and right-click menu inventory per target type. - `Qcast coding convention.pdf`, `Qcast development guilde.pdf` — full conventions / dev guide. - `메세지 처리 가이드.pdf` — modal & alert message rules. @@ -86,8 +95,9 @@ Atoms live under `src/store/` and are split by domain (`canvasAtom`, `roofAtom`, - `dictionary.txt` — domain vocabulary (roof / panel terms in JP/KR). ## Always Do + - All answers and reasoning processes must be written in Korean. -- Once the task is complete, use a sub-agent to perform lint checks, type checks, and build checks. +- Once the task is complete, use a sub-agent to perform lint checks, and build checks. - When performing a lint check, ensure that any errors are resolved before proceeding, and make an effort to resolve any warnings that arise. - When committing, write the prefix in English, while the rest of the title and content in Korean. - Upon task completion, update the CLAUDE.md and README.md documents if necessary. diff --git a/skills-lock.json b/skills-lock.json new file mode 100644 index 00000000..2b4c26dc --- /dev/null +++ b/skills-lock.json @@ -0,0 +1,11 @@ +{ + "version": 1, + "skills": { + "grill-me": { + "source": "mattpocock/skills", + "sourceType": "github", + "skillPath": "skills/productivity/grill-me/SKILL.md", + "computedHash": "784f0dbb7403b0f00324bce9a112f715342777a0daee7bbb7385f9c6f0a170ea" + } + } +}