seed-design（种子设计）

SEED Design

당근의 디자인 시스템 SEED Design을 프로젝트에 도입하고 활용할 때 사용하는 통합 가이드입니다. 처음 셋업부터 컴포넌트 사용, 파운데이션 활용, CLI 운영까지 모든 단계를 안내합니다.

동작 방식

이 스킬이 호출되면 아래 순서로 동작합니다.

1단계: 프로젝트 상태 파악

사용자의 프로젝트를 분석하여 현재 상태를 파악합니다.

• seed-design.json 존재 여부 → 초기 설정 완료 여부
• package.json에서 @seed-design/react, @seed-design/css 설치 여부와 버전
• 번들러 종류 감지 (vite.config, rsbuild.config, webpack.config 등)
• seed-design/ 디렉토리 존재 여부 → 스니펫 설치 여부
• 패키지 매니저 감지 (lock 파일 기준):

- bun.lockb / bun.lock → bun - pnpm-lock.yaml → pnpm - yarn.lock → yarn - package-lock.json 또는 기본 → npm

이후 모든 패키지 설치/실행 명령어는 감지된 패키지 매니저에 맞춰 안내합니다.

2단계: 상황 분류 및 분기

파악한 상태와 사용자의 질문에 따라 적절한 가이드로 분기합니다.

사용자가 명시적으로 주제를 말한 경우 프로젝트 분석을 건너뛰고 해당 시나리오로 직행해도 됩니다.

3단계: 안내 + 실행

• 기존 문서 링크 제공: https://seed-design.io/react/components/{component-name}
• llms.txt URL로 상세 정보 참조: https://seed-design.io/llms/react/components/{component-name}.txt
• CLI docs 명령어로 문서/llms.txt/스니펫 링크 한 번에 조회: npx @seed-design/cli@latest docs {component-name}
• 사용자가 원하면 CLI 명령어를 직접 실행 (init, add 등)

4단계: 다음 단계 제안

현재 작업이 끝나면 자연스럽게 다음 단계를 안내합니다.

• 셋업 완료 → "이제 컴포넌트를 추가해볼까요?"
• 컴포넌트 추가 → "테마 설정이나 다른 컴포넌트도 필요하신가요?"
• 파운데이션 안내 → "실제 코드에서 이렇게 사용하면 됩니다"

정보 조회 도구

SEED Design의 모든 문서에는 llms.txt 형태의 LLM 최적화 문서가 있습니다. 컴포넌트 목록, 파운데이션 가이드 등 최신 정보가 필요하면 llms.txt를 WebFetch로 읽어옵니다.

llms.txt 인덱스

개별 문서 조회

https://seed-design.io/llms/react/components/{component-name}.txt
https://seed-design.io/llms/docs/foundation/color/color-system.txt

CLI docs 명령어

npx @seed-design/cli@latest docs {component-name}
# 출력:
# - docs: https://seed-design.io/react/components/action-button
# - llms.txt: https://seed-design.io/llms/react/components/action-button.txt
# - snippet: https://raw.githubusercontent.com/daangn/seed-design/refs/heads/dev/docs/registry/ui/action-button.tsx

Reference Files