@simplysm/sd-claude 14.0.86 → 14.0.87
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -13,6 +13,17 @@ Claude 에이전트가 코드 작성·설계·변경 시 따라야 할 행동
|
|
|
13
13
|
- 명시된 정의 자체를 임의로 단순화하여 처리 금지:
|
|
14
14
|
- 정확한 구현 부담이 크면 단순화안을 사용자에게 보고 후 사용자 합의에 따름.
|
|
15
15
|
|
|
16
|
+
## 결측(null/undefined) 보존
|
|
17
|
+
|
|
18
|
+
데이터가 "값 없음"(null/undefined)을 가질 수 있으면, 그 결측을 타입·계산·출력 전 계층에서 그대로 전파. 결측을 임의 값으로 치환하거나 타입에서 비결측으로 숨기지 말 것.
|
|
19
|
+
|
|
20
|
+
- 결측을 기본값(`""`·`0`·`false`)으로 치환 금지 — "없음" 과 "그 값" 이 뭉개짐.
|
|
21
|
+
- nullable 소스를 비-nullable 필드·타입으로 받으려 강제 변환 금지 — 받는 타입·인터페이스를 nullable 로 맞출 것.
|
|
22
|
+
- 결측을 특정 값으로 다뤄야 하는 명시 요구가 있을 때만, 사용자 보고 후 그 지점에서 변환.
|
|
23
|
+
|
|
24
|
+
- 나쁜 예: 제품 분류(빈 값 가능)를 `category ?? ""` 로 받아 미분류와 빈 분류를 같은 것으로 취급.
|
|
25
|
+
- 좋은 예: 받는 타입을 `category?: string` 로 정의해 미분류(undefined)를 끝까지 유지.
|
|
26
|
+
|
|
16
27
|
## 변경 전 기존 패턴 조사
|
|
17
28
|
|
|
18
29
|
변경 전, 변경 영역의 기존 코드 패턴과 개발 매뉴얼을 먼저 조사.
|
|
@@ -329,7 +329,7 @@ spec.md 의 § 별 섹션 이름과 분류:
|
|
|
329
329
|
|
|
330
330
|
구성도와 장치 목록은 목적이 별개이므로 각각 독립적으로 작성.
|
|
331
331
|
|
|
332
|
-
- **ASCII 구성도**:
|
|
332
|
+
- **ASCII 구성도**: 현장 물리 구성 시각화 — 이해당사자 간 그림 맞추기.
|
|
333
333
|
- 포함 대상: 솔루션 노드 (서버·DB·클라이언트) + 노드 간 연결선 + 물리 위치 그룹 (IDC·사무실·창고) + 자동 연동되는 외부 시스템.
|
|
334
334
|
- 제외 대상: Actor, 외부 관계자 (인적·조직), 수동 채널 (메일·종이), 구체 제품명 (MySQL)·통신 프로토콜 (HTTPS), 장치 사양 (OS·해상도).
|
|
335
335
|
- **장치 목록**: 솔루션이 대상으로 하는 장치·환경 스펙 — 서버·DB·클라이언트 등. OS·버전·제품명·모델·해상도·하드웨어.
|
|
@@ -689,7 +689,7 @@ sub-section 헤더 레벨은 `## spec.md 형식` 의 "sub-section 헤더 레벨"
|
|
|
689
689
|
|
|
690
690
|
**자료-레벨 메타** (송신 측·자료 라이프사이클·갱신 주기·식별 키 구조 등 자료 *전체* 에 적용되는 객관 명세):
|
|
691
691
|
- 근거가 있을 때만 컬럼 표 위에 자유 작성 (불릿·단락·`라벨: 값` 형식 모두 허용).
|
|
692
|
-
- 컬럼 표 안에
|
|
692
|
+
- 컬럼 표 안에 억지로 담지 않음.
|
|
693
693
|
|
|
694
694
|
**컬럼 표**:
|
|
695
695
|
- 외부 자료가 여러 개 (`SAP.XML`·`D1.CSV` 등) 이면 자료별로 별도의 표 작성.
|