shkim4/HMDesign
Private
Public Access
1
0 Fork 0
Code Activity
Files
main
HMDesign/docs/ai/AGENTS_SNIPPET.md
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.2 KiB
Raw Permalink Blame History

HMDesign 디자인 시스템

HMDesign 사용 유형: Web | SW 일반 | SW 뷰어 | OrgChart | 혼합(영역별로 적기, SW 영역은 모드까지)

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

  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. 혼합 사용"을 묻는다. SW인데 모드(일반/뷰어)가 불명확하면 "SW 화면을 어떤 모드로 만들까요? 1. SW 일반 모드 2. SW 뷰어 모드"를 묻는다(근거는 @hm-design/sw/ai/AI_USAGE.md §0). 정해져 있으면 다시 묻지 않는다.
  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/ (뷰어 모드는 AI_USAGE.md §0 다음 VIEWER.md)
    • OrgChart: node_modules/@hm-design/org-chart/ai/ (React는 node_modules/@hm-design/org-chart-react/ai/AI_USAGE.md도)
  4. 선택한 유형·모드 안에서 기존 컴포넌트 → Props → 조합 → (없는 부분만) 그 모드의 토큰·스타일로 신규 → (참고 값도 없으면) HMDesign 공통 규칙과 조화되게 구성하고 "AI 구성 값"으로 보고하는 순서를 지킨다. 패키지 파일 수정·내부 경로 import·구현 복사는 하지 않는다.
  5. Web / SW 일반 / SW 뷰어 / OrgChart 스타일을 영역별로 분리하고(한 SW 화면에 일반·뷰어 컴포넌트를 섞지 않음), 완료 후 AI_GUIDE의 결과 보고 형식으로 유형·모드, 재사용·신규·토큰·AI 구성 값·검증·NOT VERIFIED를 보고한다.
View Git Blame Copy Permalink