diff --git a/docs/ai/AI_GUIDE.md b/docs/ai/AI_GUIDE.md index 5f8e346..0f82b75 100644 --- a/docs/ai/AI_GUIDE.md +++ b/docs/ai/AI_GUIDE.md @@ -121,6 +121,11 @@ 4. 기존 텍스트와 데이터를 임의로 변경하지 않습니다. 5. 필요한 콘텐츠가 불명확하면 임의로 확정하지 않고 결과 보고에 확인 대상으로 적습니다. - **Git Submodule 사용 규칙(2026-10-23).** 소비 프로젝트에서 HMDesign을 사용할 때 요청 범위 밖은 바꾸지 않습니다. Submodule Commit 포인터는 사용자 승인 없이 바꾸지 않습니다. 소비 프로젝트의 기존 데이터와 기능을 우선 유지합니다. +- **기존 화면 전환 시 원본 보존(2026-10-23, 모든 화면·컴포넌트 — Header 포함).** 기존 화면을 HMDesign 컴포넌트로 전환·마이그레이션할 때 적용합니다. 위 "디자인 적용 시 변경 범위 제한"·"콘텐츠 생성 제한"·"Git Submodule 사용 규칙"과 함께 적용하며, 콘텐츠 생성 제한의 Header 예외는 기존 Header의 아이콘·문구·상태·기능을 바꾸거나 제거해도 된다는 뜻이 아닙니다. + 1. 원본과 같게 유지: 아이콘과 그 의미, 표시 문구·라벨·툴팁, 버튼·메뉴·입력 요소와 그 구성, 클릭·선택·입력 동작, 활성·비활성·선택·체크 등 상태 표시, 실제 데이터·기본값·표시 조건, 기존 기능과 사용자 작업 흐름. HMDesign 디자인 적용만을 이유로 제거·변경하지 않습니다. + 2. 제거·대체·변경은 다음 중 하나일 때만 허용합니다: (가) HMDesign 지침이 명시적으로 요구함, (나) HMDesign 컴포넌트가 그 요소·동작을 지원하지 않아 기존 형태 유지가 불가능함, (다) 사용자가 명시적으로 승인함. (나)는 먼저 기존 Props·Slot·`children`·조합(위 "없는 컴포넌트 처리 3단계")으로 유지할 수 있는지 확인한 뒤에만 인정하며, 지원하지 않는 그 요소 외의 다른 요소·기능은 바꾸지 않습니다. + 3. 다음 이유만으로는 바꾸지 않습니다: 더 깔끔해 보임, HMDesign 예시 화면에 없음, 중요도·사용 빈도가 낮아 보임, 구현 단순화, AI가 불필요하다고 판단함. 근거가 명시적 지침이나 확인된 컴포넌트 미지원이 아니라 AI의 판단이면 적용하지 않고 사용자에게 먼저 확인하며, 승인받지 못한 변경은 적용하지 않습니다. + 4. 결과 보고(7단계)에 **"원본 대비 변경"** 항목을 반드시 넣습니다. 제거·대체·변경한 UI 요소는 누락 없이 `원본 요소 | 변경 내용 | 변경 근거` 표로 적고(그대로 유지한 항목은 나열하지 않아도 됨), 근거는 **지침 조항**(파일·조항·규칙) / **컴포넌트 미지원**(확인한 미지원 항목과 대안 검토 결과) / **판단**(적용하지 않고 승인 요청) 중 하나로 구분합니다. 변경이 없으면 "원본 대비 변경 없음"이라고 적습니다. ### 없는 UI를 같은 스타일로 만들 때 확인할 항목 @@ -192,6 +197,12 @@ SW 일반 모드와 뷰어 모드는 같은 패키지·같은 CSS 파일이지 - AI가 새로 구현한 부분: 파일 경로 · 이유(카탈로그에 없음) · 안쪽에서 재사용한 컴포넌트 - 적용한 디자인 토큰: --hm-… (신규 UI가 읽은 것) - AI 구성 값 — 디자인 확인 필요: 없음 | 속성 · 값 · 이유(4단계 ③) +- 원본 대비 변경(기존 화면 전환 시 필수, 4단계 "원본 보존"): 원본 대비 변경 없음 | 아래 표 + + | 원본 요소 | 변경 내용 | 변경 근거 | + |---|---|---| + | 예: 기존 아이콘 | HMDesign 아이콘으로 대체 | 지침 조항(파일·조항) 또는 컴포넌트 미지원(미지원 항목·대안 검토) | + | 예: 기존 상태 표시 | 적용하지 않음 — 변경 필요 여부 확인 | 판단 — 사용자 승인 필요 | - 카탈로그와 .d.ts 차이: 없음 | … - 검증: Typecheck PASS · Build PASS · 브라우저(폭/상태) … · NOT VERIFIED: … - 제안(구현하지 않음): … diff --git a/packages/org-chart-react/ai/AI_GUIDE.md b/packages/org-chart-react/ai/AI_GUIDE.md index 5f8e346..0f82b75 100644 --- a/packages/org-chart-react/ai/AI_GUIDE.md +++ b/packages/org-chart-react/ai/AI_GUIDE.md @@ -121,6 +121,11 @@ 4. 기존 텍스트와 데이터를 임의로 변경하지 않습니다. 5. 필요한 콘텐츠가 불명확하면 임의로 확정하지 않고 결과 보고에 확인 대상으로 적습니다. - **Git Submodule 사용 규칙(2026-10-23).** 소비 프로젝트에서 HMDesign을 사용할 때 요청 범위 밖은 바꾸지 않습니다. Submodule Commit 포인터는 사용자 승인 없이 바꾸지 않습니다. 소비 프로젝트의 기존 데이터와 기능을 우선 유지합니다. +- **기존 화면 전환 시 원본 보존(2026-10-23, 모든 화면·컴포넌트 — Header 포함).** 기존 화면을 HMDesign 컴포넌트로 전환·마이그레이션할 때 적용합니다. 위 "디자인 적용 시 변경 범위 제한"·"콘텐츠 생성 제한"·"Git Submodule 사용 규칙"과 함께 적용하며, 콘텐츠 생성 제한의 Header 예외는 기존 Header의 아이콘·문구·상태·기능을 바꾸거나 제거해도 된다는 뜻이 아닙니다. + 1. 원본과 같게 유지: 아이콘과 그 의미, 표시 문구·라벨·툴팁, 버튼·메뉴·입력 요소와 그 구성, 클릭·선택·입력 동작, 활성·비활성·선택·체크 등 상태 표시, 실제 데이터·기본값·표시 조건, 기존 기능과 사용자 작업 흐름. HMDesign 디자인 적용만을 이유로 제거·변경하지 않습니다. + 2. 제거·대체·변경은 다음 중 하나일 때만 허용합니다: (가) HMDesign 지침이 명시적으로 요구함, (나) HMDesign 컴포넌트가 그 요소·동작을 지원하지 않아 기존 형태 유지가 불가능함, (다) 사용자가 명시적으로 승인함. (나)는 먼저 기존 Props·Slot·`children`·조합(위 "없는 컴포넌트 처리 3단계")으로 유지할 수 있는지 확인한 뒤에만 인정하며, 지원하지 않는 그 요소 외의 다른 요소·기능은 바꾸지 않습니다. + 3. 다음 이유만으로는 바꾸지 않습니다: 더 깔끔해 보임, HMDesign 예시 화면에 없음, 중요도·사용 빈도가 낮아 보임, 구현 단순화, AI가 불필요하다고 판단함. 근거가 명시적 지침이나 확인된 컴포넌트 미지원이 아니라 AI의 판단이면 적용하지 않고 사용자에게 먼저 확인하며, 승인받지 못한 변경은 적용하지 않습니다. + 4. 결과 보고(7단계)에 **"원본 대비 변경"** 항목을 반드시 넣습니다. 제거·대체·변경한 UI 요소는 누락 없이 `원본 요소 | 변경 내용 | 변경 근거` 표로 적고(그대로 유지한 항목은 나열하지 않아도 됨), 근거는 **지침 조항**(파일·조항·규칙) / **컴포넌트 미지원**(확인한 미지원 항목과 대안 검토 결과) / **판단**(적용하지 않고 승인 요청) 중 하나로 구분합니다. 변경이 없으면 "원본 대비 변경 없음"이라고 적습니다. ### 없는 UI를 같은 스타일로 만들 때 확인할 항목 @@ -192,6 +197,12 @@ SW 일반 모드와 뷰어 모드는 같은 패키지·같은 CSS 파일이지 - AI가 새로 구현한 부분: 파일 경로 · 이유(카탈로그에 없음) · 안쪽에서 재사용한 컴포넌트 - 적용한 디자인 토큰: --hm-… (신규 UI가 읽은 것) - AI 구성 값 — 디자인 확인 필요: 없음 | 속성 · 값 · 이유(4단계 ③) +- 원본 대비 변경(기존 화면 전환 시 필수, 4단계 "원본 보존"): 원본 대비 변경 없음 | 아래 표 + + | 원본 요소 | 변경 내용 | 변경 근거 | + |---|---|---| + | 예: 기존 아이콘 | HMDesign 아이콘으로 대체 | 지침 조항(파일·조항) 또는 컴포넌트 미지원(미지원 항목·대안 검토) | + | 예: 기존 상태 표시 | 적용하지 않음 — 변경 필요 여부 확인 | 판단 — 사용자 승인 필요 | - 카탈로그와 .d.ts 차이: 없음 | … - 검증: Typecheck PASS · Build PASS · 브라우저(폭/상태) … · NOT VERIFIED: … - 제안(구현하지 않음): … diff --git a/packages/org-chart/ai/AI_GUIDE.md b/packages/org-chart/ai/AI_GUIDE.md index 5f8e346..0f82b75 100644 --- a/packages/org-chart/ai/AI_GUIDE.md +++ b/packages/org-chart/ai/AI_GUIDE.md @@ -121,6 +121,11 @@ 4. 기존 텍스트와 데이터를 임의로 변경하지 않습니다. 5. 필요한 콘텐츠가 불명확하면 임의로 확정하지 않고 결과 보고에 확인 대상으로 적습니다. - **Git Submodule 사용 규칙(2026-10-23).** 소비 프로젝트에서 HMDesign을 사용할 때 요청 범위 밖은 바꾸지 않습니다. Submodule Commit 포인터는 사용자 승인 없이 바꾸지 않습니다. 소비 프로젝트의 기존 데이터와 기능을 우선 유지합니다. +- **기존 화면 전환 시 원본 보존(2026-10-23, 모든 화면·컴포넌트 — Header 포함).** 기존 화면을 HMDesign 컴포넌트로 전환·마이그레이션할 때 적용합니다. 위 "디자인 적용 시 변경 범위 제한"·"콘텐츠 생성 제한"·"Git Submodule 사용 규칙"과 함께 적용하며, 콘텐츠 생성 제한의 Header 예외는 기존 Header의 아이콘·문구·상태·기능을 바꾸거나 제거해도 된다는 뜻이 아닙니다. + 1. 원본과 같게 유지: 아이콘과 그 의미, 표시 문구·라벨·툴팁, 버튼·메뉴·입력 요소와 그 구성, 클릭·선택·입력 동작, 활성·비활성·선택·체크 등 상태 표시, 실제 데이터·기본값·표시 조건, 기존 기능과 사용자 작업 흐름. HMDesign 디자인 적용만을 이유로 제거·변경하지 않습니다. + 2. 제거·대체·변경은 다음 중 하나일 때만 허용합니다: (가) HMDesign 지침이 명시적으로 요구함, (나) HMDesign 컴포넌트가 그 요소·동작을 지원하지 않아 기존 형태 유지가 불가능함, (다) 사용자가 명시적으로 승인함. (나)는 먼저 기존 Props·Slot·`children`·조합(위 "없는 컴포넌트 처리 3단계")으로 유지할 수 있는지 확인한 뒤에만 인정하며, 지원하지 않는 그 요소 외의 다른 요소·기능은 바꾸지 않습니다. + 3. 다음 이유만으로는 바꾸지 않습니다: 더 깔끔해 보임, HMDesign 예시 화면에 없음, 중요도·사용 빈도가 낮아 보임, 구현 단순화, AI가 불필요하다고 판단함. 근거가 명시적 지침이나 확인된 컴포넌트 미지원이 아니라 AI의 판단이면 적용하지 않고 사용자에게 먼저 확인하며, 승인받지 못한 변경은 적용하지 않습니다. + 4. 결과 보고(7단계)에 **"원본 대비 변경"** 항목을 반드시 넣습니다. 제거·대체·변경한 UI 요소는 누락 없이 `원본 요소 | 변경 내용 | 변경 근거` 표로 적고(그대로 유지한 항목은 나열하지 않아도 됨), 근거는 **지침 조항**(파일·조항·규칙) / **컴포넌트 미지원**(확인한 미지원 항목과 대안 검토 결과) / **판단**(적용하지 않고 승인 요청) 중 하나로 구분합니다. 변경이 없으면 "원본 대비 변경 없음"이라고 적습니다. ### 없는 UI를 같은 스타일로 만들 때 확인할 항목 @@ -192,6 +197,12 @@ SW 일반 모드와 뷰어 모드는 같은 패키지·같은 CSS 파일이지 - AI가 새로 구현한 부분: 파일 경로 · 이유(카탈로그에 없음) · 안쪽에서 재사용한 컴포넌트 - 적용한 디자인 토큰: --hm-… (신규 UI가 읽은 것) - AI 구성 값 — 디자인 확인 필요: 없음 | 속성 · 값 · 이유(4단계 ③) +- 원본 대비 변경(기존 화면 전환 시 필수, 4단계 "원본 보존"): 원본 대비 변경 없음 | 아래 표 + + | 원본 요소 | 변경 내용 | 변경 근거 | + |---|---|---| + | 예: 기존 아이콘 | HMDesign 아이콘으로 대체 | 지침 조항(파일·조항) 또는 컴포넌트 미지원(미지원 항목·대안 검토) | + | 예: 기존 상태 표시 | 적용하지 않음 — 변경 필요 여부 확인 | 판단 — 사용자 승인 필요 | - 카탈로그와 .d.ts 차이: 없음 | … - 검증: Typecheck PASS · Build PASS · 브라우저(폭/상태) … · NOT VERIFIED: … - 제안(구현하지 않음): … diff --git a/packages/sw/ai/AI_GUIDE.md b/packages/sw/ai/AI_GUIDE.md index 5f8e346..0f82b75 100644 --- a/packages/sw/ai/AI_GUIDE.md +++ b/packages/sw/ai/AI_GUIDE.md @@ -121,6 +121,11 @@ 4. 기존 텍스트와 데이터를 임의로 변경하지 않습니다. 5. 필요한 콘텐츠가 불명확하면 임의로 확정하지 않고 결과 보고에 확인 대상으로 적습니다. - **Git Submodule 사용 규칙(2026-10-23).** 소비 프로젝트에서 HMDesign을 사용할 때 요청 범위 밖은 바꾸지 않습니다. Submodule Commit 포인터는 사용자 승인 없이 바꾸지 않습니다. 소비 프로젝트의 기존 데이터와 기능을 우선 유지합니다. +- **기존 화면 전환 시 원본 보존(2026-10-23, 모든 화면·컴포넌트 — Header 포함).** 기존 화면을 HMDesign 컴포넌트로 전환·마이그레이션할 때 적용합니다. 위 "디자인 적용 시 변경 범위 제한"·"콘텐츠 생성 제한"·"Git Submodule 사용 규칙"과 함께 적용하며, 콘텐츠 생성 제한의 Header 예외는 기존 Header의 아이콘·문구·상태·기능을 바꾸거나 제거해도 된다는 뜻이 아닙니다. + 1. 원본과 같게 유지: 아이콘과 그 의미, 표시 문구·라벨·툴팁, 버튼·메뉴·입력 요소와 그 구성, 클릭·선택·입력 동작, 활성·비활성·선택·체크 등 상태 표시, 실제 데이터·기본값·표시 조건, 기존 기능과 사용자 작업 흐름. HMDesign 디자인 적용만을 이유로 제거·변경하지 않습니다. + 2. 제거·대체·변경은 다음 중 하나일 때만 허용합니다: (가) HMDesign 지침이 명시적으로 요구함, (나) HMDesign 컴포넌트가 그 요소·동작을 지원하지 않아 기존 형태 유지가 불가능함, (다) 사용자가 명시적으로 승인함. (나)는 먼저 기존 Props·Slot·`children`·조합(위 "없는 컴포넌트 처리 3단계")으로 유지할 수 있는지 확인한 뒤에만 인정하며, 지원하지 않는 그 요소 외의 다른 요소·기능은 바꾸지 않습니다. + 3. 다음 이유만으로는 바꾸지 않습니다: 더 깔끔해 보임, HMDesign 예시 화면에 없음, 중요도·사용 빈도가 낮아 보임, 구현 단순화, AI가 불필요하다고 판단함. 근거가 명시적 지침이나 확인된 컴포넌트 미지원이 아니라 AI의 판단이면 적용하지 않고 사용자에게 먼저 확인하며, 승인받지 못한 변경은 적용하지 않습니다. + 4. 결과 보고(7단계)에 **"원본 대비 변경"** 항목을 반드시 넣습니다. 제거·대체·변경한 UI 요소는 누락 없이 `원본 요소 | 변경 내용 | 변경 근거` 표로 적고(그대로 유지한 항목은 나열하지 않아도 됨), 근거는 **지침 조항**(파일·조항·규칙) / **컴포넌트 미지원**(확인한 미지원 항목과 대안 검토 결과) / **판단**(적용하지 않고 승인 요청) 중 하나로 구분합니다. 변경이 없으면 "원본 대비 변경 없음"이라고 적습니다. ### 없는 UI를 같은 스타일로 만들 때 확인할 항목 @@ -192,6 +197,12 @@ SW 일반 모드와 뷰어 모드는 같은 패키지·같은 CSS 파일이지 - AI가 새로 구현한 부분: 파일 경로 · 이유(카탈로그에 없음) · 안쪽에서 재사용한 컴포넌트 - 적용한 디자인 토큰: --hm-… (신규 UI가 읽은 것) - AI 구성 값 — 디자인 확인 필요: 없음 | 속성 · 값 · 이유(4단계 ③) +- 원본 대비 변경(기존 화면 전환 시 필수, 4단계 "원본 보존"): 원본 대비 변경 없음 | 아래 표 + + | 원본 요소 | 변경 내용 | 변경 근거 | + |---|---|---| + | 예: 기존 아이콘 | HMDesign 아이콘으로 대체 | 지침 조항(파일·조항) 또는 컴포넌트 미지원(미지원 항목·대안 검토) | + | 예: 기존 상태 표시 | 적용하지 않음 — 변경 필요 여부 확인 | 판단 — 사용자 승인 필요 | - 카탈로그와 .d.ts 차이: 없음 | … - 검증: Typecheck PASS · Build PASS · 브라우저(폭/상태) … · NOT VERIFIED: … - 제안(구현하지 않음): … diff --git a/packages/ui/ai/AI_GUIDE.md b/packages/ui/ai/AI_GUIDE.md index 5f8e346..0f82b75 100644 --- a/packages/ui/ai/AI_GUIDE.md +++ b/packages/ui/ai/AI_GUIDE.md @@ -121,6 +121,11 @@ 4. 기존 텍스트와 데이터를 임의로 변경하지 않습니다. 5. 필요한 콘텐츠가 불명확하면 임의로 확정하지 않고 결과 보고에 확인 대상으로 적습니다. - **Git Submodule 사용 규칙(2026-10-23).** 소비 프로젝트에서 HMDesign을 사용할 때 요청 범위 밖은 바꾸지 않습니다. Submodule Commit 포인터는 사용자 승인 없이 바꾸지 않습니다. 소비 프로젝트의 기존 데이터와 기능을 우선 유지합니다. +- **기존 화면 전환 시 원본 보존(2026-10-23, 모든 화면·컴포넌트 — Header 포함).** 기존 화면을 HMDesign 컴포넌트로 전환·마이그레이션할 때 적용합니다. 위 "디자인 적용 시 변경 범위 제한"·"콘텐츠 생성 제한"·"Git Submodule 사용 규칙"과 함께 적용하며, 콘텐츠 생성 제한의 Header 예외는 기존 Header의 아이콘·문구·상태·기능을 바꾸거나 제거해도 된다는 뜻이 아닙니다. + 1. 원본과 같게 유지: 아이콘과 그 의미, 표시 문구·라벨·툴팁, 버튼·메뉴·입력 요소와 그 구성, 클릭·선택·입력 동작, 활성·비활성·선택·체크 등 상태 표시, 실제 데이터·기본값·표시 조건, 기존 기능과 사용자 작업 흐름. HMDesign 디자인 적용만을 이유로 제거·변경하지 않습니다. + 2. 제거·대체·변경은 다음 중 하나일 때만 허용합니다: (가) HMDesign 지침이 명시적으로 요구함, (나) HMDesign 컴포넌트가 그 요소·동작을 지원하지 않아 기존 형태 유지가 불가능함, (다) 사용자가 명시적으로 승인함. (나)는 먼저 기존 Props·Slot·`children`·조합(위 "없는 컴포넌트 처리 3단계")으로 유지할 수 있는지 확인한 뒤에만 인정하며, 지원하지 않는 그 요소 외의 다른 요소·기능은 바꾸지 않습니다. + 3. 다음 이유만으로는 바꾸지 않습니다: 더 깔끔해 보임, HMDesign 예시 화면에 없음, 중요도·사용 빈도가 낮아 보임, 구현 단순화, AI가 불필요하다고 판단함. 근거가 명시적 지침이나 확인된 컴포넌트 미지원이 아니라 AI의 판단이면 적용하지 않고 사용자에게 먼저 확인하며, 승인받지 못한 변경은 적용하지 않습니다. + 4. 결과 보고(7단계)에 **"원본 대비 변경"** 항목을 반드시 넣습니다. 제거·대체·변경한 UI 요소는 누락 없이 `원본 요소 | 변경 내용 | 변경 근거` 표로 적고(그대로 유지한 항목은 나열하지 않아도 됨), 근거는 **지침 조항**(파일·조항·규칙) / **컴포넌트 미지원**(확인한 미지원 항목과 대안 검토 결과) / **판단**(적용하지 않고 승인 요청) 중 하나로 구분합니다. 변경이 없으면 "원본 대비 변경 없음"이라고 적습니다. ### 없는 UI를 같은 스타일로 만들 때 확인할 항목 @@ -192,6 +197,12 @@ SW 일반 모드와 뷰어 모드는 같은 패키지·같은 CSS 파일이지 - AI가 새로 구현한 부분: 파일 경로 · 이유(카탈로그에 없음) · 안쪽에서 재사용한 컴포넌트 - 적용한 디자인 토큰: --hm-… (신규 UI가 읽은 것) - AI 구성 값 — 디자인 확인 필요: 없음 | 속성 · 값 · 이유(4단계 ③) +- 원본 대비 변경(기존 화면 전환 시 필수, 4단계 "원본 보존"): 원본 대비 변경 없음 | 아래 표 + + | 원본 요소 | 변경 내용 | 변경 근거 | + |---|---|---| + | 예: 기존 아이콘 | HMDesign 아이콘으로 대체 | 지침 조항(파일·조항) 또는 컴포넌트 미지원(미지원 항목·대안 검토) | + | 예: 기존 상태 표시 | 적용하지 않음 — 변경 필요 여부 확인 | 판단 — 사용자 승인 필요 | - 카탈로그와 .d.ts 차이: 없음 | … - 검증: Typecheck PASS · Build PASS · 브라우저(폭/상태) … · NOT VERIFIED: … - 제안(구현하지 않음): …