- Shared entry point docs/ai/AI_GUIDE.md (type selection Web / SW / OrgChart / mixed, steps 1-7, package style separation, report format, examples A-D) and AGENTS_SNIPPET.md, copied into every package ai/ folder - New ai/ docs for @hm-design/ui and @hm-design/org-chart (+ org-chart-react pointer): AI_USAGE, COMPONENT_CATALOG, DESIGN_RULES, COMPOSITION_PATTERNS - SW ai/ linked to the shared guide; catalog lists every Props type explicitly - "ai" added to package files of ui, org-chart, org-chart-react - scripts/ai-docs.mjs: sync:ai-docs / check:ai-docs (copies, files, catalog <-> exports, links) - Maintenance guide and verification record under docs/ai
1.6 KiB
1.6 KiB
HMDesign 디자인 시스템
HMDesign 사용 유형: Web | SW | OrgChart | 혼합(영역별로 적기)
화면·컴포넌트를 구현하거나 수정하기 전에 다음을 지킨다.
- 설치된 HMDesign 패키지의 공통 가이드를 먼저 읽는다:
node_modules/@hm-design/<설치된 패키지>/ai/AI_GUIDE.md(ui,sw,org-chart,org-chart-react중 아무 사본이나 내용이 같다). - 위 "사용 유형"이 없고 요청으로도 정할 수 없으면 코드 작성 전에 "어떤 HMDesign 디자인 시스템을 사용하시겠습니까? 1. Web 2. SW 3. OrgChart 4. 혼합 사용"을 묻는다. 정해져 있으면 다시 묻지 않는다.
- 선택한 패키지의
ai/AI_USAGE.md→COMPONENT_CATALOG.md→DESIGN_RULES.md→COMPOSITION_PATTERNS.md순으로 필요한 절을 읽는다.- Web:
node_modules/@hm-design/ui/ai/ - SW:
node_modules/@hm-design/sw/ai/ - OrgChart:
node_modules/@hm-design/org-chart/ai/(React는node_modules/@hm-design/org-chart-react/ai/AI_USAGE.md도)
- Web:
- 기존 컴포넌트 → Props → 조합 → (없는 부분만) 패키지 토큰으로 신규 구현 순서를 지킨다. 패키지 파일 수정·내부 경로 import·구현 복사·새 디자인 값 생성은 하지 않는다.
- Web / SW / OrgChart 스타일을 영역별로 분리하고, 완료 후 AI_GUIDE의 결과 보고 형식으로 재사용·신규·토큰·검증·NOT VERIFIED를 보고한다.