@simplysm/sd-claude 14.0.84 → 14.0.85

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.
@@ -33,6 +33,14 @@ Claude 에이전트가 코드 작성·설계·변경 시 따라야 할 행동
33
33
  - silent skip 금지 — 예외를 잡은 후 대안 없이 진행하면 후속 프로세스가 결손된 채 동작함.
34
34
  - **자동 복구** (예: 의존성 미설치 → 설치·재시도 = 완전한 동작 회복) 는 silent skip 아님.
35
35
 
36
+ ## 다중 작업 원자성
37
+
38
+ 한 사용자 동작이 여러 하위 작업·여러 항목(루프·배열·다건 처리)으로 구성될 때, 전부 성공 아니면 전부 실패로 처리:
39
+
40
+ - 일부 항목에서 문제 발생 → 이미 처리된 항목까지 취소(롤백)하고 동작 전체를 throw 로 중단.
41
+ - 안티패턴: 문제된 항목만 skip 하고 나머지를 완료 처리 — 데이터가 부분 반영되어 정합성이 깨짐.
42
+ - 부분 성공을 의도적으로 허용하려면(예: 배치 중 실패분만 리포트) 사용자에게 보고 후 합의에 따름.
43
+
36
44
  ## 사용자에게 노출되는 알림 작성 시 심각도 분류
37
45
 
38
46
  사용자에게 노출되는 알림(로그·토스트·다이얼로그 등)의 심각도 분류 기준:
@@ -12,6 +12,7 @@
12
12
  - Skill 도구는 사용자 호출 가능 스킬 섹션에 나열된 스킬에만 사용. 추측하거나 내장 CLI 명령에 사용하지 말 것.
13
13
  - Agent 도구(서브에이전트 호출)는 단계지침상 명시되어 있거나, 사용자가 명시적으로 지시한 경우에만 사용. 그 외에는 Grep·Read·Glob 등 기본 도구로 직접 처리.
14
14
  - 도구 호출이 에러를 반환하면 멈추고 에러 메시지부터 원인을 규명. 원인 규명 전에 같은 목적을 수단만 바꿔 재시도하지 말 것.
15
+ - Read, Grep, Read, Glob 등의 도구로 수행할 일을 PowerShell 도구로 수행하지 말것.
15
16
 
16
17
  # 행동 규칙
17
18
 
@@ -132,6 +133,12 @@ X 함수에 캐시 도입 검토 중. 기존 의존성 확인 결과 lru-cache
132
133
  추천: 1 — 단일 인스턴스 환경, TTL 요구사항 단순.
133
134
  ```
134
135
 
136
+ ## 사용자 답변 시
137
+
138
+ - 제시한 다항목·장문에 사용자가 일부만 이견을 내면, 나머지는 미확정 — 이견 반영해 전체를 다시 제시·재확인. 이견 없는 부분을 확정으로 굳히고 진행 금지.
139
+ - 나쁜 예: 30줄 제안 "맞나요?" → 한 줄만 "아님" → 그 줄만 고쳐 나머지 확정으로 진행.
140
+ - 좋은 예: → 정정 반영해 전체 다시 제시 → "이렇게 수정함, 맞나요?".
141
+
135
142
  ## 다단계 지침 진행 시
136
143
 
137
144
  지침상 여러 단계가 정의되어 있고, 단계 진행에 대한 사용자 확인을 받으라는 명시가 없는 경우 → 단계 산출물 보고 후 자동으로 다음 단계 진행. 단계 사이에 "다음 단계 진행할까요?"·"계속할까요?" 류 트리거 위임 질문 생성 금지.
@@ -212,7 +219,7 @@ X 함수에 캐시 도입 검토 중. 기존 의존성 확인 결과 lru-cache
212
219
 
213
220
  ## 응답 톤·표현
214
221
 
215
- **적용**: 모든 응답 + 산출물(spec.md·문서·코드 주석 등 Write/Edit 본문).
222
+ **적용**: 모든 응답 + 산출물(spec.md·문서·발표자료·코드 주석 등).
216
223
 
217
224
  ### 어휘·태도
218
225
 
@@ -290,7 +297,7 @@ X 함수에 캐시 도입 검토 중. 기존 의존성 확인 결과 lru-cache
290
297
 
291
298
  **상위 룰 중복 금지**:
292
299
 
293
- - 자동 로드되는 상위 룰(예: `sd-base-rules.md`)에 이미 명시된 내용을 하위 지침 문서(`CLAUDE.md`·스킬 SKILL.md·참고 자료 등)에 다시 옮기지 말 것.
300
+ - 자동 로드되는 상위 룰(예: `sd-design-rules.md`)에 이미 명시된 내용을 하위 지침 문서(`CLAUDE.md`·스킬 SKILL.md·참고 자료 등)에 다시 옮기지 말 것.
294
301
  - 하위 문서는 해당 스코프 고유 내용만 작성.
295
302
 
296
303
  **산문 종결**:
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: sd-config
3
3
  description: sd-* 스킬 사용에 필요/권장되는 프로젝트 설정을 항목별로 사용자와 확인하며 적용하는 스킬. Use when sd-* 를 쓰기 전 환경을 점검하거나 누락 항목을 채울 때.
4
+ model: haiku
4
5
  ---
5
6
 
6
7
  각 항목을 차례로 점검. 이미 값이 있으면 변경할지 묻고, 비어 있으면 추가 여부를 물음. 동의하면 항목 설명에 기본값이 있는 경우 그 값을 제안하고, 없으면 사용자에게 값을 물어서 해당 항목의 대상 파일에 기록. 대상 파일이 없으면 새로 만듦.
@@ -129,4 +129,4 @@ LLM 단독 판단의 한계: 동일 구성 화면이 한 곳도 없다는 이유
129
129
 
130
130
  ## 운용
131
131
 
132
- - 결정 근거: `sd-base-rules.md` "결정 근거" 적용.
132
+ - 결정 근거: 행동 규칙 "결정 근거" 적용.
@@ -17,7 +17,7 @@ spec.md 없이 진행하는 가벼운 코드 작업. 의도 합의 후 워크플
17
17
  - 대상 파일·모듈·패키지.
18
18
  - 변경의 입출력·동작 — 이름·시그니처·예외 동작 등.
19
19
 
20
- 근거 충분(사용자 발화 명시 + 기존 코드 패턴으로 추론 가능)이면 묻지 않고 진행. 부족분은 1건씩 질문 (sd-base-rules "사용자 질의 시"). 외부 자료(예: 디자인 시안·샘플 데이터·접근 자격증명)가 필요하면 이 단계에서 사용자에게 요청.
20
+ 근거 충분(사용자 발화 명시 + 기존 코드 패턴으로 추론 가능)이면 묻지 않고 진행. 부족분은 1건씩 질문 (행동 규칙 "사용자 질의 시"). 외부 자료(예: 디자인 시안·샘플 데이터·접근 자격증명)가 필요하면 이 단계에서 사용자에게 요청.
21
21
 
22
22
  ### 2단계: 분석
23
23
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: sd-docs
3
3
  description: `@simplysm/*` 라이브러리 패키지의 API 문서를 `.claude/references/sd-simplysm14/apis/<패키지명>/` 위치에 사용 트리거 기준으로 작성·갱신. Use when 라이브러리 API 문서를 새로 작성하거나 코드 변경을 반영해 갱신할 때.
4
- effort: "low"
4
+ model: haiku
5
5
  ---
6
6
 
7
7
  # sd-docs
@@ -11,7 +11,7 @@ description: 산출물(코드·문서 등) 을 적용 룰 기준으로 검증해
11
11
 
12
12
  2. **작업 도메인 명시** — 대상이 어떤 도메인의 산출물인가 식별 (예: LLM 문서 / 사람 문서 / UI / 코드).
13
13
 
14
- 3. **적용 룰 인용** — 도메인의 적용 룰 인용 (sd-base-rules·sd-design-rules·스킬·도메인별 룰 등). 룰 항목 직접 표기.
14
+ 3. **적용 룰 인용** — 도메인의 적용 룰 인용 (행동 규칙·sd-design-rules·스킬·도메인별 룰 등). 룰 항목 직접 표기.
15
15
 
16
16
  4. **룰 부합 검증** — 대상이 인용 룰에 부합하는가 점검. 위반 항목 식별.
17
17
 
@@ -30,4 +30,4 @@ description: 산출물(코드·문서 등) 을 적용 룰 기준으로 검증해
30
30
  - `[자동]` 판정 항목: `[자동]` 마커 표기 (변경 완료).
31
31
  - 결정 대상 항목: 마커 없음.
32
32
 
33
- 8. **결정 진행 모드 전환** — 결정 대상이 1건 이상이면 `sd-base-rules.md` "사용자 질의 시" 섹션이 정의한 결정 진행 모드로 전환 (사용자 트리거 대기 금지). 0건이면 종료.
33
+ 8. **결정 진행 모드 전환** — 결정 대상이 1건 이상이면 행동 규칙의 "사용자 질의 시" 섹션이 정의한 결정 진행 모드로 전환 (사용자 트리거 대기 금지). 0건이면 종료.
@@ -240,6 +240,6 @@ stdout 으로 summary JSON 출력. 포함 필드는 다음과 같음.
240
240
 
241
241
  ### 리뷰
242
242
 
243
- 전 케이스 PASS 후 sd-review 호출. 적용 룰: sd-base-rules 3단계의 "본문 작성 원칙"·"파일 분리 기준".
243
+ 전 케이스 PASS 후 sd-review 호출. 적용 룰: 행동 규칙과 3단계의 "본문 작성 원칙"·"파일 분리 기준".
244
244
 
245
245
  리뷰 결과로 수정 발생 시 4단계 재실행.
@@ -73,16 +73,16 @@ spec.md 첨부 재진입 시 상황별 권장 진입점:
73
73
 
74
74
  #### 초안 단위
75
75
 
76
- sd-base-rules "묶음 채택 금지" 적용 — 사용자가 한 번에 yes/no 로 답할 수 있는 최소 단위. 응답 1건에 선택지 세트 1개. §별 작성법 첫머리에 단위 명시.
76
+ 행동 규칙 "묶음 채택 금지" 적용 — 사용자가 한 번에 yes/no 로 답할 수 있는 최소 단위. 응답 1건에 선택지 세트 1개. §별 작성법 첫머리에 단위 명시.
77
77
 
78
78
  #### 스스로 검증 게이트
79
79
 
80
- 초안 출력 직전마다 자문. 한 가지라도 실패 시 초안 폐기 후 재작성 또는 사용자에게 질문. sd-base-rules "응답 전송 직전 자가 점검" 에 더해 적용되는 sd-spec 고유 검증.
80
+ 초안 출력 직전마다 자문. 한 가지라도 실패 시 초안 폐기 후 재작성 또는 사용자에게 질문. 행동 규칙 "응답 전송 직전 자가 점검" 에 더해 적용되는 sd-spec 고유 검증.
81
81
 
82
82
  1. **형식** — 해당 § 작성법 규약을 따랐는지 (해당 § 작성법 절을 재독한 후 헤더 구조·표 형식·마커 표기 점검).
83
83
  2. **출처** — 각 항목·필드·동작 1건마다 사용자 발언·자료를 인용할 수 있는지.
84
84
  - 인용 불가 = As-Is 답습 / 다른 §·example 패턴 복제 의심 → 제거 또는 별도 질문.
85
- - As-Is (회의록·매뉴얼·현행 화면) 는 추정 자료 (sd-base-rules "결정 근거 안티패턴").
85
+ - As-Is (회의록·매뉴얼·현행 화면) 는 추정 자료 (행동 규칙 "결정 근거 안티패턴").
86
86
  - 다른 §·example 에서는 **형식만** 가져오고, **내용물** (항목·컬럼·필드·액션·동작) 은 본 §의 §2.x/§3.x 본문·사용자 발언에서 직접 도출.
87
87
  3. **단순화 차단** — spec 명시 정의·식·분기·경계에 대해 초안에서 자체 단순화·근사화·안전 처리 (NULL 강제·0 클램프·방어 가드·분기 생략) 를 임의로 추가하지 않았는지.
88
88
  - 식은 그대로 풀어쓸 것.
@@ -252,7 +252,7 @@ spec.md 의 § 별 섹션 이름과 분류:
252
252
  | `[OPEN]` | 정보 부족·근거 없는 항목. 향후 확정 필요. |
253
253
 
254
254
  - 임의로 채우거나 누락하지 말고 `[OPEN]` 으로 표기.
255
- - 근거 부족 판정 기준은 sd-base-rules "결정 근거" 적용. As-Is 만 근거인 항목·답변 범위 흡수 등 안티패턴 자료는 근거 없음으로 보고 `[OPEN]` 으로 표기.
255
+ - 근거 부족 판정 기준은 행동 규칙의 "결정 근거" 적용. As-Is 만 근거인 항목·답변 범위 흡수 등 안티패턴 자료는 근거 없음으로 보고 `[OPEN]` 으로 표기.
256
256
  - 헤더 `[확정]` + 본문 `[OPEN]` 조합은 OPEN 을 인정한 상태로 섹션을 확정. 이후에는 OPEN 항목만 처리.
257
257
  - 사용자에게 물을 때 선택지: `맞나요? [OPEN 상태로 확정 / 섹션 전체 보류 / OPEN 하나씩 해결]`.
258
258
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: sd-unpack
3
3
  description: 메일·문서(eml/msg/pdf/docx/pptx/xlsx/xlsb, 레거시 doc/ppt/xls)를 첨부 포함 재귀적으로 풀어 평문 트리로 펼치기. Use when 위 형식 파일의 본문·첨부 전반을 훑어야 할 때 (분석·요약·정리·검토 등). 단순 단답 조회(특정 값/셀 확인)나 옆에 이미 펼친 `<basename>_<ext>/` 폴더가 있으면 호출 금지.
4
-
4
+ model: haiku
5
5
  ---
6
6
 
7
7
  # sd-unpack
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: sd-use
3
3
  description: 사용자 요청을 분석해 워크스페이스의 sd-* 스킬 중 가장 적합한 스킬을 추천하는 스킬. Use when 어떤 sd-* 스킬을 써야 할지 모를 때.
4
+ model: haiku
4
5
  ---
5
6
 
6
7
  `/sd-use <요청>` 의 `<요청>` 에 적합한 sd-* 스킬을 추천만 출력하고 종료. 추천 대상 스킬의 자동 실행·산출물 생성 금지.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@simplysm/sd-claude",
3
- "version": "14.0.84",
3
+ "version": "14.0.85",
4
4
  "description": "심플리즘 패키지 - Claude Code 셋업",
5
5
  "author": "심플리즘",
6
6
  "license": "Apache-2.0",