| name | seed-component-map |
| description | SEED Design 저장소에서 한 컴포넌트의 Rootage, Recipe, Headless, React/Lynx 구현, package export, Registry, 문서, 예제, 테스트 연결을 현재 체크아웃 기준으로 조회한다. 컴포넌트 변경 전 영향 범위 파악, 플랫폼 동등성 확인, 생성물과 원천 구분, 공개 표면 확인에 사용한다. |
SEED Component Map
SEED 저장소 자체를 단일 원천으로 삼아 한 컴포넌트의 연결 지도를 만든다. 정적 카탈로그나 외부 서버를 사용하지 않는다. 스크립트는 현재 체크아웃을 읽기만 하며 같은 파일 상태에서는 같은 JSON을 반환한다.
실행
저장소 안에서 컴포넌트 하나를 지정한다.
bun skills/seed-component-map/scripts/component-map.ts ProgressCircle
kebab-case도 사용할 수 있다.
bun skills/seed-component-map/scripts/component-map.ts action-button
한 번에 한 컴포넌트만 조회한다. 여러 컴포넌트가 필요하면 각각 실행한다.
결과 읽기
결과 JSON에는 다음 항목이 있다.
component: 입력을 정규화한 이름과 탐색 상태
platforms: 실제 표면이 발견된 react, lynx 플랫폼
rootage: 직접 수정하는 Rootage 원천
recipeSources: React와 Lynx Recipe 원천
generatedOutputs: Rootage, CSS, 변수 생성물. 직접 수정하지 않는다.
headless: 플랫폼별 Headless 원천
implementations: React와 Lynx Styled UI 구현
packageExports: 컴포넌트 barrel에서 패키지 루트까지 이어지는 공개 export
registry: Registry 구현과 등록 파일
docs: 공통, React, Lynx 문서
examples: 문서 예제와 저장소 예제 앱의 vendored 표면
tests: 단위 테스트와 Storybook story
ambiguities: 정확한 이름을 찾지 못했을 때 다시 조회할 후보
component.state는 다음 셋 중 하나다.
matched: 정확한 컴포넌트 표면을 찾음
ambiguous: 정확한 표면은 없지만 이름이 겹치는 후보가 있음
not-found: 정확한 표면과 후보를 모두 찾지 못함
작업 절차
- 변경 전에 대상 컴포넌트 맵을 한 번 조회한다.
- 필요한 배열의 경로를 직접 읽어 실제 책임과 공개 API를 확인한다.
generatedOutputs는 수정 대상에서 제외하고 대응하는 Rootage 또는 Recipe 원천을 찾는다.
ambiguous면 ambiguities[].candidate의 정확한 이름으로 다시 실행한다.
- 구현이나 변경이 필요하면
../seed-create-component/SKILL.md의 게이트와 검증 절차를 따른다.
맵 결과만으로 동작을 추측하지 않는다. 이 스킬은 경로를 찾는 역할만 하며 코드 변경, 생성, 검증을 대신하지 않는다.
탐색 범위
스크립트는 다음 표면만 탐색한다.
packages/rootage, packages/qvism-preset, packages/lynx-qvism-preset
packages/css, packages/lynx-css
packages/react-headless, packages/lynx-react-headless
packages/react, packages/lynx-react
packages/stackflow의 공개 컴포넌트와 primitive
docs/content, docs/registry, docs/stories, docs/examples
examples
심링크와 빌드·캐시 디렉터리는 따라가지 않는다. 지원 표면이 새로 생기면 정적 결과 파일을 추가하지 말고 scripts/component-map.ts의 탐색 범위를 갱신한다.