메뉴
pnpm workspace build gotchas — lifecycle-script (pre/post) silence and surgical lockfile edits for workspace dependencies. Use when a build step silently does not run or when adding/removing a workspace dependency.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Pipeline for delegating one large mechanical change to a worker under a hard green-or-report gate — specify, dispatch mechanical-refactor-worker, independently re-verify the green claim, hand the working-tree diff to pr-review-reviewer, then commit. Route-only: it does no editing and forms no verdict. Use when delegating a big decision-free change on your own working tree.
Procedure for running multiple independent backlog items in parallel via worktree-isolated subagents with zero merge conflicts — partition file ownership before spawning, isolate each implementer in its own worktree, sequence overlapping work behind occupants, one coherent self-verified PR per agent, and serial orchestrator merge. Use when executing 2 or more independent items concurrently.
Thin router for the doc-vs-code architecture conformance audit (GATE-CONFORMANCE). Routes to the mechanical conformance scan plus the architecture-refresh agent loop (architecture-conformance-auditor / architecture-auditor + fixers), which own the audit behavior natively. Use before a release, after cross-package work, or when GATE-CONFORMANCE runs.
Router for the mandatory post-implementation sequence — SPEC sync, build/test, README, commit/PR, publish, content/ docs, docs deploy. Each step's detail lives in its owning skill/rule; this file only fixes the order and the gates. Execute automatically after implementation work; do not wait for the user to request it.
Orchestrator for the spec document gate pipeline. Reads current status from frontmatter, determines the next gate, invokes backlog-writer or backlog-gate-guard, and updates frontmatter status on PASS. Does nothing else.
Mandatory verification loop after any SPEC.md or contract document change. Compares spec against implementation code, fixes code to match spec, repeats until zero discrepancies, then runs regression tests. Spec is always the source of truth — never modify the spec within this workflow.
| name | pnpm-monorepo-build |
| description | pnpm workspace build gotchas — lifecycle-script (pre/post) silence and surgical lockfile edits for workspace dependencies. Use when a build step silently does not run or when adding/removing a workspace dependency. |
AGENTS.md > "Project Structure"AGENTS.md > "Build Requirements"Build/filter commands are listed in the root package.json scripts (pnpm run to enumerate;
pnpm --filter <pkg> build to scope). This skill owns only the two learned gotchas below.
pre/post)pnpm does not run npm-style pre<script>/post<script> hooks by default
(enable-pre-post-scripts is off). A postbuild will silently never run from pnpm build.
"build": "next build && <step>".devDependency (not an ambient/npx-fetched binary).When adding (or removing) a workspace:* dependency between packages, edit the lockfile
surgically — never regenerate it with a full pnpm install in a network-restricted/sandbox
environment.
package.json: add "<scope>/<pkg>": "workspace:*".pnpm-lock.yaml edit — add to that package's dependencies: block:
specifier: workspace:* + version: link:../<pkg> (sibling package) or
link:../../packages/<pkg> (app consuming a package).pnpm install --frozen-lockfile — must succeed without rewriting the lockfile, and
the lockfile diff must be limited to the intended block.NEVER commit a lockfile a full pnpm install regenerated in a network-restricted env: offline
resolution prunes thousands of lines — a corrupting change, not a dependency update. If
--frozen-lockfile fails, fix the surgical edit; never regenerate the whole lockfile.