shkim4/HMDesign
Private
Public Access
1
0 Fork 0
Code Activity
Files
fb74cd756f5a529d15762d1da2143288a7ded634
HMDesign/packages/org-chart-react/ai/AI_USAGE.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.7 KiB
Raw Blame History

@hm-design/org-chart-react — AI 코딩 도구 사용 안내

먼저 AI_GUIDE.md(공통 1~7단계)를 읽습니다. 이 패키지는 OrgChart Core의 React 수명주기 어댑터일 뿐이며 자체 디자인·레이아웃이 없습니다. OrgChart 작업 규칙·API·디자인은 Core 패키지의 ai/ 폴더가 기준입니다.

읽을 문서 설치 후 위치
OrgChart 작업 순서·생성 방식(Chart Only / Full Page)·데이터 규칙 node_modules/@hm-design/org-chart/ai/AI_USAGE.md
React OrgChart Props 전체 + Core API node_modules/@hm-design/org-chart/ai/COMPONENT_CATALOG.md §1
디자인·CSS 입력 node_modules/@hm-design/org-chart/ai/DESIGN_RULES.md
React·Vanilla 조합 예시 node_modules/@hm-design/org-chart/ai/COMPOSITION_PATTERNS.md

Core는 이 패키지의 runtime dependency이므로 함께 설치됩니다. 패키지 관리자가 중첩 설치한 경우 node_modules/@hm-design/org-chart-react/node_modules/@hm-design/org-chart/ai/에 있습니다.

이 패키지에서 확인할 것

  • Entry: @hm-design/org-chart-react(runtime export OrgChart 하나, HM UI 불필요) / @hm-design/org-chart-react/hm-dialog(OrgChart + HMEmployeeDialog, @hm-design/ui 0.1.0 선택 peer와 Web CSS 필요).
  • 타입: OrgChartProps, OrgChartEmployeeSelection, OrgChartEmployeePopupProps와 Core 공개 타입(type-only 재export). JsonOrgChartDataSource 같은 runtime helper는 @hm-design/org-chart에서 import합니다.
  • Peer: react ^19.0.0. react-dom은 앱이 제공합니다.
  • "use client" 경계가 유지됩니다. SSR/hydration은 검증 범위 밖입니다.
  • 공개 ref·imperative handle·children·data·title Props는 없습니다.
View Git Blame Copy Permalink