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)

.forgejo/workflows/ci.yml

@@ -0,0 +1,59 @@
+# designpaca CI — 자체 러너(linux-builder, host 모드)에서 돈다.
+# host 러너에는 Node 가 없을 수 있으므로 uses: 액션을 쓰지 않고 전부 run: 으로 처리한다.
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: linux-builder
+    steps:
+      - name: checkout
+        env: { CI_TOKEN: "${{ github.token }}" }
+        run: |
+          proto="${GITHUB_SERVER_URL%%://*}"; host="${GITHUB_SERVER_URL#*://}"
+          url="$proto://actions:${CI_TOKEN}@${host%/}/${GITHUB_REPOSITORY}.git"
+          [ -d .git ] || git init -q .
+          git remote remove origin 2>/dev/null || true
+          git remote add origin "$url"
+          git fetch -q --depth 1 origin "$GITHUB_REF"
+          git checkout -q -f FETCH_HEAD
+          git clean -qfdx
+
+      - name: 환경 확인
+        run: ./build/ci/verify-node.sh
+
+      - name: 의존성 설치
+        run: pnpm install --frozen-lockfile
+
+      - name: 스킬 문서 검사
+        run: node build/ci/lint-skill.mjs packages/skill
+
+      - name: 타입 검사
+        run: pnpm typecheck
+
+      - name: 테스트
+        run: pnpm test
+
+      - name: 빌드
+        run: pnpm build
+
+      - name: 배포물 점검 (npx 경로 검증)
+        run: |
+          node packages/cli/scripts/verify-package.mjs
+          # 실제 사용자가 겪는 경로 그대로 확인한다 — tarball 을 만들어 설치까지 해본다
+          cd packages/cli
+          tarball="$(npm pack --silent)"
+          tmp="$(mktemp -d)"
+          tar -xzf "$tarball" -C "$tmp"
+          test -f "$tmp/package/dist/skill/SKILL.md" || { echo "tarball 에 스킬이 없다" >&2; exit 1; }
+          node "$tmp/package/dist/index.js" --version
+          node "$tmp/package/dist/index.js" list
+          rm -rf "$tmp" "$tarball"
+
+      - name: 사이트 빌드
+        run: pnpm build:site

.forgejo/workflows/release.yml

@@ -0,0 +1,97 @@
+# designpaca 릴리스 — 태그 v* 푸시로 발동한다.
+#   1) 게이트: 검사·테스트·빌드
+#   2) npmjs 배포 + Forgejo 사설 레지스트리 미러
+#   3) Forgejo draft 릴리스에 tarball 첨부 (QA 후 수동 Publish 승격)
+#   4) 소개 페이지 Cloudflare Pages 배포
+#
+# 필요한 시크릿: NPM_TOKEN · FORGEJO_NPM_TOKEN · RELEASE_TOKEN · CF_API_TOKEN · CF_ACCOUNT_ID
+name: release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch: # 수동 리허설 (ci-rehearsal prerelease 로 나간다)
+
+jobs:
+  release:
+    runs-on: linux-builder
+    steps:
+      - name: checkout
+        env: { CI_TOKEN: "${{ github.token }}" }
+        run: |
+          proto="${GITHUB_SERVER_URL%%://*}"; host="${GITHUB_SERVER_URL#*://}"
+          url="$proto://actions:${CI_TOKEN}@${host%/}/${GITHUB_REPOSITORY}.git"
+          [ -d .git ] || git init -q .
+          git remote remove origin 2>/dev/null || true
+          git remote add origin "$url"
+          git fetch -q --depth 1 origin "$GITHUB_REF"
+          git checkout -q -f FETCH_HEAD
+          git clean -qfdx
+
+      - name: 환경 확인
+        run: ./build/ci/verify-node.sh
+
+      - name: 릴리스 정보 확정
+        run: |
+          case "$GITHUB_REF" in
+            refs/tags/v*)
+              tag="${GITHUB_REF#refs/tags/}"
+              echo "RELTAG=$tag" >> "$GITHUB_ENV"
+              echo "RELEASE_PRERELEASE=false" >> "$GITHUB_ENV"
+              echo "DO_PUBLISH=1" >> "$GITHUB_ENV"
+              # 태그와 package.json 버전이 어긋난 채 배포되는 사고를 막는다
+              pkgver="$(node -p 'require("./packages/cli/package.json").version')"
+              [ "v$pkgver" = "$tag" ] || { echo "태그($tag)와 package.json(v$pkgver)이 다르다" >&2; exit 1; }
+              ;;
+            *)
+              echo "RELTAG=ci-rehearsal" >> "$GITHUB_ENV"
+              echo "RELEASE_PRERELEASE=true" >> "$GITHUB_ENV"
+              echo "DO_PUBLISH=0" >> "$GITHUB_ENV"
+              ;;
+          esac
+
+      - name: 의존성 설치
+        run: pnpm install --frozen-lockfile
+
+      - name: 검사 · 테스트 · 빌드
+        run: |
+          node build/ci/lint-skill.mjs packages/skill
+          pnpm typecheck
+          pnpm test
+          pnpm build
+          node packages/cli/scripts/verify-package.mjs
+
+      - name: tarball 생성
+        run: |
+          mkdir -p out
+          cd packages/cli
+          tarball="$(npm pack --silent)"
+          mv "$tarball" "../../out/$tarball"
+          echo "TARBALL=out/$tarball" >> "$GITHUB_ENV"
+
+      - name: npm 배포 (npmjs + Forgejo 미러)
+        if: env.DO_PUBLISH == '1'
+        env:
+          NPM_TOKEN: "${{ secrets.NPM_TOKEN }}"
+          FORGEJO_NPM_TOKEN: "${{ secrets.FORGEJO_NPM_TOKEN }}"
+          FORGEJO_NPM_OWNER: "${{ vars.FORGEJO_NPM_OWNER }}"
+        run: ./build/ci/publish-npm.sh packages/cli
+
+      - name: 릴리스 업로드 (draft)
+        env: { RELEASE_TOKEN: "${{ secrets.RELEASE_TOKEN }}" }
+        run: ./build/ci/upload-release-asset.sh "$RELTAG" "$TARBALL"
+
+      - name: 소개 페이지 배포 (Cloudflare Pages)
+        env:
+          CLOUDFLARE_API_TOKEN: "${{ secrets.CF_API_TOKEN }}"
+          CLOUDFLARE_ACCOUNT_ID: "${{ secrets.CF_ACCOUNT_ID }}"
+        run: |
+          if [ -z "${CLOUDFLARE_API_TOKEN:-}" ]; then
+            echo "CF_API_TOKEN 이 없다 — 페이지 배포를 건너뛴다"
+            exit 0
+          fi
+          pnpm build:site
+          npx --yes wrangler@latest pages deploy apps/site/dist \
+            --project-name designpaca \
+            --branch main \
+            --commit-dirty=true