Files
HMDesign/packages/org-chart-react/ai/AGENTS_SNIPPET.md
T
shkim4 fb74cd756f docs(ai): add packaged AI guides for Web, SW and OrgChart
- 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
2026-10-19 17:13:36 +09:00

1.6 KiB

HMDesign 디자인 시스템

HMDesign 사용 유형: Web | SW | OrgChart | 혼합(영역별로 적기)

화면·컴포넌트를 구현하거나 수정하기 전에 다음을 지킨다.

  1. 설치된 HMDesign 패키지의 공통 가이드를 먼저 읽는다: node_modules/@hm-design/<설치된 패키지>/ai/AI_GUIDE.md (ui, sw, org-chart, org-chart-react 중 아무 사본이나 내용이 같다).
  2. 위 "사용 유형"이 없고 요청으로도 정할 수 없으면 코드 작성 전에 "어떤 HMDesign 디자인 시스템을 사용하시겠습니까? 1. Web 2. SW 3. OrgChart 4. 혼합 사용"을 묻는다. 정해져 있으면 다시 묻지 않는다.
  3. 선택한 패키지의 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도)
  4. 기존 컴포넌트 → Props → 조합 → (없는 부분만) 패키지 토큰으로 신규 구현 순서를 지킨다. 패키지 파일 수정·내부 경로 import·구현 복사·새 디자인 값 생성은 하지 않는다.
  5. Web / SW / OrgChart 스타일을 영역별로 분리하고, 완료 후 AI_GUIDE의 결과 보고 형식으로 재사용·신규·토큰·검증·NOT VERIFIED를 보고한다.