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)
This commit is contained in:
Yun Chan 2026-08-20 10:48:00 +09:00
commit 8808c672dc
135 changed files with 38838 additions and 0 deletions

View file

@ -0,0 +1,50 @@
import assert from "node:assert/strict";
import { test } from "node:test";
import { extractBlock, hasBlock, removeBlock, upsertBlock } from "../src/marker.ts";
const M = "designpaca";
test("빈 문서에 블록을 넣는다", () => {
const out = upsertBlock("", M, "본문");
assert.ok(hasBlock(out, M));
assert.equal(extractBlock(out, M), "본문");
});
test("기존 문서 뒤에 붙이고 원문을 보존한다", () => {
const doc = "# 내 지침\n\n건드리지 마라.\n";
const out = upsertBlock(doc, M, "우리 블록");
assert.ok(out.startsWith("# 내 지침"));
assert.ok(out.includes("건드리지 마라."));
assert.equal(extractBlock(out, M), "우리 블록");
});
test("두 번째 호출은 블록 내용만 교체한다", () => {
const first = upsertBlock("# 문서\n\n앞부분\n", M, "v1");
const second = upsertBlock(first, M, "v2");
assert.equal(extractBlock(second, M), "v2");
assert.ok(!second.includes("v1"));
assert.ok(second.includes("앞부분"));
// 블록이 두 개로 늘어나면 안 된다
assert.equal(second.split("designpaca:start").length - 1, 1);
});
test("블록 뒤에 사용자가 쓴 내용도 보존한다", () => {
const doc = upsertBlock("앞\n", M, "블록") + "\n뒤에 쓴 내용\n";
const out = upsertBlock(doc, M, "새 블록");
assert.ok(out.includes("앞"));
assert.ok(out.includes("뒤에 쓴 내용"));
assert.equal(extractBlock(out, M), "새 블록");
});
test("제거하면 우리 블록만 사라진다", () => {
const doc = upsertBlock("# 문서\n\n내용\n", M, "블록");
const out = removeBlock(doc, M);
assert.ok(!hasBlock(out, M));
assert.ok(out.includes("# 문서"));
assert.ok(out.includes("내용"));
});
test("블록이 없는 문서를 제거해도 그대로다", () => {
const doc = "# 문서\n";
assert.equal(removeBlock(doc, M), doc);
});