boardgame-studio: Skill for Cursor

컴포넌트 정의

ruleset.md 에 적힌 구성물을 실제 규격과 데이터로 옮긴다. 산출물은 두 가지다.

• projects/<slug>/spec.json — 종류, 크기(mm), 수량
• projects/<slug>/components/<comp-id>.csv — 종류별 실제 데이터

규격 판단은 bgs-component-manager 에게 맡긴다. 문서 언어는 studio.config.json 의 language 를 따르되, 컴포넌트 id와 CSV 컬럼명은 영문 소문자로 쓴다. 도구가 참조하는 식별자라 언어와 무관하게 고정한다.

진행

- [ ] 1. 룰셋에서 구성물을 뽑는다
- [ ] 2. 종류별 규격을 정한다
- [ ] 3. spec.json 을 쓴다
- [ ] 4. CSV 스키마를 정한다
- [ ] 5. 데이터를 채운다
- [ ] 6. 검증한다

1. 구성물 뽑기

ruleset.md 의 구성물 절과 본문을 대조한다. 본문에서 쓰는데 구성물에 없는 것이 흔하다. "추적 마커를 옮긴다"고 써놓고 마커가 구성물에 없는 식이다.

각 컴포넌트마다 확인한다.

• 몇 종류인가, 종류마다 몇 장인가
• 앞뒤가 다른가, 뒷면이 필요한가
• 플레이어마다 필요한가 (인원별로 수량이 달라진다)

2. 규격

node tools/spec.mjs presets 로 표준 규격을 보고 고른다. 비표준을 쓰겠다면 이유를 확인한다.

여기서 인쇄 시트 수를 같이 확인한다. 미니 유로는 A4에 16장, 포커는 9장, 타로는 4장이다. 같은 60장 덱이라도 인쇄와 재단 시간이 4배 차이 나는데, 공모전 마감이 있으면 이게 실제 제약이 된다.

3. spec.json

{
  "game": { "title": "...", "players": [2, 4], "playtime": [45, 60] },
  "print": { "sheet": "A4", "margin_mm": 9, "dpi": 300, "cut_gap_mm": 0 },
  "anchor_sets": ["character", "scene"],
  "components": [
    { "id": "action-card", "type": "card", "label": "액션 카드",
      "count": 60, "size_mm": [63.5, 88], "art": "character", "back": "shared" }
  ]
}

• size_mm 만 적는다. 픽셀은 산출된다
• print 는 건드리지 않는다. A4 여백 9mm는 고정이다
• anchor_sets 는 아트 스타일 앵커 세트 이름이다. 이 게임에 필요한 만큼 선언한다. 인물 계열과 환경·사물 계열로 나누는 게 보통이지만, 게임에 따라 다르다
• art 는 어느 앵커 세트를 쓸지. 아트 없이 도형으로 갈 컴포넌트는 null
• back 은 shared(공통 뒷면), none(뒷면 없음), per-card(카드마다 다름). 프로토타입은 none 으로 충분한 경우가 많다. 슬리브에 넣고 뒤에 종이를 대면 된다

4. CSV 스키마

컴포넌트마다 무엇이 필요한지 사용자와 정한다. 흔히 이런 컬럼들이다.

• id — 카드 식별자. 인쇄물에 작게 찍어두면 플레이테스트에서 지적할 때 편하다
• name — 이름
• qty — 같은 카드를 몇 장 넣는지. 없으면 행 수가 곧 수량이다
• 수치 컬럼 — cost, power, vp 등. tools/balance.mjs 가 이 컬럼들을 분석한다
• text — 카드 텍스트
• art_prompt — 아트 생성용 주제. 나중에 채워도 된다

수치는 별도 컬럼으로 뺀다. text 안에 "비용 3"이라고 써두면 밸런스 분석이 읽지 못한다.

5. 데이터

CSV를 채운다. 한 번에 다 만들려 하지 않는다. 종류별로 하나씩 하고, 각각 끝날 때마다 룰셋과 어긋나지 않는지 확인한다.