designpaca 초기 구현 — 스킬 · 설치 CLI · 배포 파이프라인

웹 디자인 파이프라인 스킬과 이를 5개 에이전트에 설치하는 CLI 를 담은 모노레포.

스킬 (packages/skill)
- SKILL.md 261줄 + 참조 문서 16개 3,349줄. progressive disclosure 로
  본문은 절차와 인덱스만, 지식은 references/ 로 분리
- 0~6단계 파이프라인. 규모에 따라 전체·연장·국소 세 경로로 분기
- 하드 게이트 12개는 grep·카운트로 검증 가능한 것만. 취향 판단은 제외
- 미학 프리셋 5종, AI 슬롭 지문 목록, 한글 조판 규칙,
  SVG 필터·three.js·인터랙티브 모션·HTML-in-Canvas 실전 지침

설치 CLI (packages/cli, packages/core)
- npx designpaca 온보딩 TUI. Claude Code · Codex · Cursor · Windsurf · AGENTS.md
- 매니페스트에 설치 시점 해시를 기록해 사용자가 고친 파일은 update 가 건너뛴다
- 타깃별로 본문의 references/ 경로를 실제 설치 위치로 재작성
- AGENTS.md 는 항상 로드되므로 본문 대신 303자 포인터만 주입
- Windsurf 는 12,000자 상한 초과 시 설치를 차단

배포 (build/ci, .forgejo/workflows)
- 태그 v* → 검사·테스트·빌드 → npmjs 배포 + Forgejo 레지스트리 미러
  → draft 릴리스 → Cloudflare Pages. 재실행 멱등

근거 (research/)
- 약 250개 웹 소스 조사 결과와 도그푸딩 검증 2건. 스킬의 모든 수치는 여기서 나온다

테스트 22개 통과 (core 16 · cli 6)

build/ci/publish-npm.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# designpaca 패키지를 npmjs 에 배포하고 Forgejo 사설 레지스트리에 미러링한다.
+#
+# 필요 환경:
+#   NPM_TOKEN          npmjs 자동화 토큰 (필수)
+#   FORGEJO_NPM_TOKEN  Forgejo 개인 액세스 토큰 (선택 — 없으면 미러를 건너뛴다)
+#   FORGEJO_NPM_OWNER  Forgejo 패키지 소유자 (기본: yunchan)
+#   GITHUB_SERVER_URL  Forgejo 주소 (Actions 가 준다)
+#
+# 이미 배포된 버전이면 조용히 건너뛴다 — 워크플로 재실행이 실패로 끝나지 않게.
+set -euo pipefail
+
+PKG_DIR="${1:-packages/cli}"
+cd "$PKG_DIR"
+
+name="$(node -p 'require("./package.json").name')"
+version="$(node -p 'require("./package.json").version')"
+echo "배포 대상: ${name}@${version}"
+
+published() { # <registry-url>
+  npm view "${name}@${version}" version --registry "$1" >/dev/null 2>&1
+}
+
+# ── 1) npmjs ──
+if [ -z "${NPM_TOKEN:-}" ]; then
+  echo "NPM_TOKEN 이 없다 — npmjs 배포를 건너뛴다" >&2
+else
+  npmrc="$(mktemp)"
+  echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > "$npmrc"
+  export NPM_CONFIG_USERCONFIG="$npmrc"
+
+  if published "https://registry.npmjs.org/"; then
+    echo "npmjs: ${version} 은 이미 배포돼 있다 — 건너뛴다"
+  else
+    npm publish --access public --registry "https://registry.npmjs.org/" --provenance=false
+    echo "npmjs 배포 완료: ${name}@${version}"
+  fi
+  rm -f "$npmrc"
+  unset NPM_CONFIG_USERCONFIG
+fi
+
+# ── 2) Forgejo 미러 ──
+if [ -z "${FORGEJO_NPM_TOKEN:-}" ]; then
+  echo "FORGEJO_NPM_TOKEN 이 없다 — 사설 레지스트리 미러를 건너뛴다"
+  exit 0
+fi
+
+owner="${FORGEJO_NPM_OWNER:-yunchan}"
+server="${GITHUB_SERVER_URL:-https://git.chanpaca.net}"
+host="${server#*://}"; host="${host%/}"
+registry="${server%/}/api/packages/${owner}/npm/"
+
+npmrc="$(mktemp)"
+{
+  echo "registry=${registry}"
+  # 스킴을 뺀 형태로 적어야 Forgejo 가 인증을 인식한다
+  echo "//${host}/api/packages/${owner}/npm/:_authToken=${FORGEJO_NPM_TOKEN}"
+} > "$npmrc"
+export NPM_CONFIG_USERCONFIG="$npmrc"
+
+if published "$registry"; then
+  echo "Forgejo: ${version} 은 이미 미러돼 있다 — 건너뛴다"
+else
+  npm publish --registry "$registry"
+  echo "Forgejo 미러 완료: ${registry}"
+fi
+rm -f "$npmrc"