Private

Public Access

0 Fork 0

Files

T

shkim4 7621934f69 docs(ai): split SW usage into general / viewer mode in packaged AI guides

- Usage types are now Web / SW (general mode, viewer mode) / OrgChart / mixed.
  Shared AI_GUIDE step 1 asks for the SW mode only when the request or the
  project setting (HMDesign 사용 유형: SW 일반 | SW 뷰어) leaves it open;
  examples B0/B1/B2 cover "HMDesign SW로 화면을 만들어 주세요", general and viewer.
- Missing-component handling in three steps (reuse in the chosen type/mode ->
  build with that mode's tokens -> HMDesign-consistent style, reported as
  "AI 구성 값 — 디자인 확인 필요"), plus SW general/viewer separation rules.
- sw/ai: AI_USAGE §0 mode selection, catalog §8 lists all 33 SWViewer* exports,
  DESIGN_RULES §11 viewer tokens, PATTERNS 7 viewer composition; examples B/F
  marked as general mode. ui/ai and org-chart/ai aligned with the new types.
- AGENTS_SNIPPET, AGENTS.md and MAINTAINING updated; copies synced.
- scripts/ai-docs.mjs: shared-copy check ignores CRLF/LF (core.autocrlf=true
  checks out packages/sw as LF and the rest as CRLF).
- Verification record updated (code samples typechecked, built and rendered).

2026-10-19 17:34:15 +09:00

2.0 KiB

Raw Permalink Blame History

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

먼저 AI_GUIDE.md(공통 1~7단계)를 읽습니다. 이 패키지는 OrgChart Core의 React 수명주기 어댑터일 뿐이며 자체 디자인·레이아웃이 없습니다. 사용 유형은 공통 체계(1 Web / 2 SW 일반·뷰어 / 3 OrgChart / 4 혼합)를 따르며 이 패키지는 3 OrgChart 또는 혼합의 조직도 영역에서 씁니다. OrgChart 작업 규칙·API·디자인·없는 UI 처리 3단계는 Core 패키지의 ai/ 폴더가 기준이며 여기에 반복하지 않습니다.

읽을 문서	설치 후 위치
사용 유형·혼합 규칙, 생성 방식(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는 없습니다.

2.0 KiB Raw Permalink Blame History

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

이 패키지에서 확인할 것

2.0 KiB

Raw Permalink Blame History