@simplysm/sd-claude 14.0.87 → 14.0.89

package/claude/{skills/sd-docs/references/subagent-prompt.md → workflows/sd-docs.rules.md}

@@ -1,31 +1,25 @@
-# subagent 호출 프롬프트 (sd-docs)
+# API 문서 작성 규칙 (sd-docs)
 
-메인 에이전트가 패키지 1개당 1번씩 `general-purpose` subagent 를 호출할 때 쓰는 프롬프트 양식. `<PACKAGE_NAME>` 과 `<PACKAGE_DIR>` 자리만 치환.
+패키지 1개의 API 문서를 작성·갱신할 때 따르는 규칙. 산출 자리는 `.claude/references/sd-simplysm14/apis/<패키지명>/` (`<패키지명>` = `@simplysm/` 접두사 제외한 짧은 이름. 예: `@simplysm/foo` → `apis/foo/`).
 
----
-
-## 프롬프트 (이 마커 아래 전부를 그대로 subagent 에 전달)
-
-너는 `<PACKAGE_NAME>` 패키지(소스 위치: `<PACKAGE_DIR>/src/`)의 API 문서를 작성·갱신하는 subagent. 산출 자리는 `.claude/references/sd-simplysm14/apis/<PACKAGE_NAME 의 `@simplysm/` 접두사를 제외한 짧은 이름>/` (예: `@simplysm/foo` → `apis/foo/`). 아래 규칙을 끝까지 따름.
-
-### 1. 입력 분석
+## 1. 입력 분석
 
 다음만 진실 근거로 사용 — 외부 자료·과거 git 기록·다른 패키지의 사용처는 참조 금지.
 
-- `<PACKAGE_DIR>/src/index.ts` 의 export — **entry 시작점**. 여기서 노출된 심볼만 문서 대상.
+- `<패키지 디렉토리>/src/index.ts` 의 export — **entry 시작점**. 여기서 노출된 심볼만 문서 대상.
 - 위 entry 가 재노출하는 각 심볼의 정의 파일(타입 시그니처 + 본문).
 - 위 정의 파일 또는 동일 패키지 안의 다른 파일에 달린 JSDoc 주석.
 - `tests/` 디렉토리 중 해당 패키지를 import 해 검증하는 테스트 코드 (존재할 경우에만).
 
 타입 시그니처에서 직접 드러나지 않는 사용 패턴을 보강해야 하면 위 4개 소스 안에서만 추론.
 
-### 2. 사용 트리거 군 분류
+## 2. 사용 트리거 군 분류
 
 entry 의 export 심볼들을 "한 작업 컨텍스트에서 함께 참조될 군"으로 묶음. 예: 에러 처리 군, 값 타입 군, 큐/이벤트 군. 분류 기준은 폴더 구조나 심볼 종류가 아니라 **사용 시점**(언제 같이 읽힐 것인가) 기준.
 
 군이 모호하거나 작아 트리거가 1~2개뿐인 심볼은 별도 군을 만들지 말고 README 의 공통 인라인 섹션에 배치.
 
-### 3. 산출 단위 판정
+## 3. 산출 단위 판정
 
 기본은 `README.md` 1장. 다음 조건을 **모두** 만족하는 군만 별도 `<군명>.md` 로 분할.
 
@@ -34,19 +28,17 @@ entry 의 export 심볼들을 "한 작업 컨텍스트에서 함께 참조될
 
 위 조건을 만족하지 않으면 README 안에 유지.
 
-### 4. 풀 재작성 모드 (범위: `apis/<패키지명>/` 자리만)
+## 4. 풀 재작성 모드 (범위: `apis/<패키지명>/` 자리만)
 
-- 기존 `apis/<패키지명>/README.md` 와 분할 `<군명>.md` 가 있어도 **참고하지 않고 처음부터 작성**. 코드 + 본 프롬프트의 형식 룰(아래 README 형식 섹션·분할 .md 형식 섹션·작성 원칙 섹션) 만을 진실 근거로 삼음.
-- 기존 파일 내용·표현 보존 시도 금지. 룰 변경(예: 식별자 풀이 의무) 이 자동 반영되도록 매 호출마다 패키지별 산출물(README + 분할 `<군명>.md`) 을 다시 작성.
+- 기존 `apis/<패키지명>/README.md` 와 분할 `<군명>.md` 가 있어도 **참고하지 않고 처음부터 작성**. 코드 + 본 문서의 형식 규칙(아래 README 형식·분할 .md 형식·작성 원칙) 만을 진실 근거로 삼음.
+- 기존 파일 내용·표현 보존 시도 금지. 규칙 변경(예: 식별자 풀이 의무) 이 자동 반영되도록 매번 패키지별 산출물(README + 분할 `<군명>.md`) 을 다시 작성.
 - 결과적으로 코드가 변경되지 않은 패키지도 표현이 달라질 수 있음 — 정상.
 - 코드에서 사라진 군의 분할 파일은 삭제.
-- **범위 밖**: 상위 `.claude/references/sd-simplysm14/README.md` 는 건드리지 말 것 (메인 에이전트가 인덱스 섹션 항목만 갱신, subagent 와 무관).
+- **범위 밖**: 상위 `.claude/references/sd-simplysm14/README.md` 는 건드리지 말 것 (인덱스 섹션은 취합 단계에서 별도 처리).
 
-### 5. README.md 형식
+## 5. README.md 형식
 
-각 패키지의 `apis/<패키지명>/README.md` 는 다음 구조를 따름.
-
-H1 은 `# @simplysm/<short-name>` 형식으로 고정 (예: `# @simplysm/foo`).
+각 패키지의 `apis/<패키지명>/README.md` 는 다음 구조를 따름. H1 은 `# @simplysm/<short-name>` 형식으로 고정.
 
 ```markdown
 # @simplysm/<short-name>
@@ -61,6 +53,7 @@ H1 은 `# @simplysm/<short-name>` 형식으로 고정 (예: `# @simplysm/foo`).
 ## <인라인 군 이름 1>
 
 각 심볼별로 짧은 시그니처 + 옵션·prop·필드·enum literal(열거형 리터럴 값) 1줄 풀이 + 즉시 사용 가능한 사용법을 작성. 본질적으로 큰 군이라 분할된 경우 이 섹션은 두지 않고, 위 인덱스에서 `자세히:` 링크로 안내.
+```
 
 **식별자 풀이 의무**: 시그니처에 나오는 옵션·prop·필드·enum literal 각각에 1줄 풀이 부착. 풀이 구성 = `<무엇을 함>` + (enum/boolean 인 경우) `<값별 동작 차이>` + `<언제 쓰는지 단서 1조각>`. 이름만 나열하는 형식 금지.
 
@@ -77,15 +70,9 @@ inputs: selectMode, autoSelect: "click"|"focus", useAutoSort, focusMode: "row"|"
 - focusMode: "row"|"cell" — 키보드 포커스 단위. "row" = 행 전체 이동, "cell" = 셀 단위 이동. 셀 편집·복사 화면이면 "cell".
 ```
 
-## <인라인 군 이름 2>
-...
-```
-
-### 6. 분할 .md 형식
-
-`<군명>.md` 는 다음 구조를 따름.
+## 6. 분할 .md 형식
 
-분할 `.md` 의 H1 도 동일 형식 + 군명을 붙임: `# @simplysm/<short-name> — <군명>`.
+`<군명>.md` 는 다음 구조를 따름. H1 은 `# @simplysm/<short-name> — <군명>` 형식.
 
 ```markdown
 # @simplysm/<short-name> — <군명>
@@ -94,25 +81,23 @@ inputs: selectMode, autoSelect: "click"|"focus", useAutoSort, focusMode: "row"|"
 
 ## <심볼>
 
-시그니처, 옵션·prop·필드·enum literal 1줄 풀이(위 README 형식 섹션의 "식별자 풀이 의무" 와 동일 적용), 사용 예, 주의사항.
-
-## <심볼>
-...
+시그니처, 옵션·prop·필드·enum literal 1줄 풀이(위 "식별자 풀이 의무" 와 동일 적용), 사용 예, 주의사항.
 ```
 
-### 7. 작성 원칙
+## 7. 작성 원칙
 
 - 산출물의 소비자는 Claude 에이전트. 사람 가독성보다 에이전트가 즉시 따를 수 있는 간결·명확성이 우선.
 - **코드 본문에 드러난 동작은 JSDoc 이 없어도 기재**. 옵션·prop·필드·enum literal 의 동작을 본문(분기·기본값·사용처) 에서 추론해 풀이. 단, 본문에서 확인 불가한 외부 추측·미검증 동작은 기재 금지.
-- **식별자만 나열 금지** — 위 README 형식 섹션·분할 .md 형식 섹션의 "식별자 풀이 의무" 강제. 이름을 콤마로 나열하고 끝내지 말 것. 자명해 보여도 enum literal 의 값별 동작, boolean 의 토글 효과, 함수형 prop 의 호출 시점은 반드시 풀이.
+- **식별자만 나열 금지** — 위 "식별자 풀이 의무" 강제. 이름을 콤마로 나열하고 끝내지 말 것. 자명해 보여도 enum literal 의 값별 동작, boolean 의 토글 효과, 함수형 prop 의 호출 시점은 반드시 풀이.
 - 사용 예는 실제 호출 코드 형태로 1~3줄 분량, 군마다 1개 가량.
 - 분량을 늘리기 위한 부연·중복·꾸밈 금지. 단, 식별자 풀이는 "분량 늘리기" 가 아니라 필수 정보로 취급 — 풀이 생략을 통한 분량 절약 금지.
 
-### 8. 산출 보고
+## 8. 구조화 결과 반환
 
-작성·갱신을 마치면 호출자(메인 에이전트) 에게 다음 항목을 1단락으로 보고.
+작성·갱신을 마치면 다음 항목을 구조화해 반환 (상위 README 인덱스 취합·사용자 보고에 사용).
 
-- 신규 작성인지 갱신인지 구분.
-- 산출·갱신한 파일 목록 (README 와 분할 `.md` 모두 포함).
-- 패키지의 한 줄 트리거 요약 (메인 에이전트가 상위 README 인덱스에 옮겨 적을 문장).
-- 삭제한 파일이 있으면 그 목록.
+- `shortName`: `@simplysm/` 제외한 짧은 이름.
+- `mode`: 신규 작성인지 갱신인지.
+- `writtenFiles`: 산출·갱신한 파일 목록 (README + 분할 `.md` 모두).
+- `deletedFiles`: 삭제한 파일 목록 (코드에서 사라진 군, 없으면 빈 목록).
+- `triggerSummary`: 패키지의 한 줄 트리거 요약 (상위 README 인덱스에 옮겨 적을 문장).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-claude",
-  "version": "14.0.87",
+  "version": "14.0.89",
   "description": "심플리즘 패키지 - Claude Code 셋업",
   "author": "심플리즘",
   "license": "Apache-2.0",

package/claude/skills/sd-demo/evals/fixtures/inventory-list/.specs/inventory/spec.md

@@ -1,99 +0,0 @@
-# 재고 관리 요구 분석서
-
-## 1. 개요
-
-### 1.1 핵심 목적 [확정: 2026-05-26]
-
-창고별 품목 재고 현황 조회 시스템
-
-### 1.2 주요 목표 [확정: 2026-05-26]
-
-- 창고별·품목별 재고 현황 조회
-
-### 1.3 최종 사용자/이해관계자 [확정: 2026-05-26]
-
-- 창고 관리자: PC 로 재고 현황 조회
-
-### 1.4 환경/장치 [확정: 2026-05-26]
-
-```
-   ┌─────────┐
-   │   PC    │
-   └────┬────┘
-        │
-        ▼
-   ┌──────────┐
-   │ WMS 서버 │
-   └──────────┘
-```
-
-- PC — 창고 관리자가 재고 화면 조회에 사용
-  - OS: Windows 11
-  - Browser: Chrome 최신
-  - 해상도: 1920 x 1080
-
-## 4. 화면
-
-| §   | 분류 | 화면      | 유형 | 장치 |
-| --- | ---- | --------- | ---- | ---- |
-| 4.1 | 재고 | 재고 조회 | 조회 | PC   |
-
-### 4.1 재고 조회 (PC) [확정: 2026-05-26]
-
-Actor: 창고 관리자
-관련 섹션: [모델.재고]
-
-기능 개요:
-
-- 창고별·품목별 재고 현황 조회
-
-#### 와이어프레임
-
-```
-┌────────────────────────────────────────────────────────────────────┐
-│ 재고 조회                                                          │
-│ [조회]  <필터>                                                     │
-├────────────────────────────────────────────────────────────────────┤
-│ <재고 목록 시트>                                                   │
-└────────────────────────────────────────────────────────────────────┘
-```
-
-#### 항목
-
-**필터**
-
-| 항목      | 종류      | 필수 | 비고                     |
-| --------- | --------- | ---- | ------------------------ |
-| 창고      | 정적 선택 | X    | 전체·창고 목록           |
-| 품목 검색 | 텍스트    | X    | 코드 또는 명칭 부분 일치 |
-
-**재고 목록 시트**
-
-| 컬럼   | 종류 | 필수 | 도메인 매핑          | 비고      |
-| ------ | ---- | ---- | -------------------- | --------- |
-| 창고   | 문자 | -    | [모델.재고.창고]     |           |
-| 품목   | 문자 | -    | [모델.재고.품목명]   |           |
-| 재고량 | 숫자 | -    | [모델.재고.수량]     | 우측 정렬 |
-| 갱신일 | 날짜 | -    | [모델.재고.갱신일]   |           |
-
-#### 동작
-
-- `[조회]` 클릭: 검색 필터 조건으로 목록 갱신
-
-#### 빈 상태
-
-- 검색 결과 없음: "조회된 재고가 없습니다." 표시
-
-## 8. 도메인 모델
-
-### 8.1 재고 [확정: 2026-05-26]
-
-필드:
-
-| 필드   | 타입 | 필수 | 비고             |
-| ------ | ---- | ---- | ---------------- |
-| ID     | 숫자 | O    | 자동 부여        |
-| 창고   | 문자 | O    | 창고명           |
-| 품목명 | 문자 | O    | 품목명           |
-| 수량   | 숫자 | O    | 재고 수량        |
-| 갱신일 | 날짜 | O    | 마지막 갱신 일자 |

package/claude/skills/sd-demo/evals/fixtures/inventory-list/packages/demo-client/package.json

@@ -1,12 +0,0 @@
-{
-  "name": "@demo/client",
-  "version": "0.0.0",
-  "private": true,
-  "type": "module",
-  "dependencies": {
-    "@angular/core": "^21.0.0",
-    "@ng-icons/core": "^32.0.0",
-    "@ng-icons/tabler-icons": "^32.0.0",
-    "@simplysm/angular": "^14.0.0"
-  }
-}

package/claude/skills/sd-demo/evals/fixtures/inventory-list/packages/demo-client/src/index.ts

@@ -1,3 +0,0 @@
-export { InventoryMasterListComponent } from "./screens/inventory/inventory-master.list";
-export { OutboundListComponent } from "./screens/outbound/outbound.list";
-export { InboundListComponent } from "./screens/inbound/inbound.list";

package/claude/skills/sd-demo/evals/fixtures/inventory-list/packages/demo-client/src/screens/inbound/inbound.list.ts

@@ -1,150 +0,0 @@
-import {
-  ChangeDetectionStrategy,
-  Component,
-  ViewEncapsulation,
-  effect,
-  inject,
-  signal,
-  untracked,
-} from "@angular/core";
-import {
-  injectPermsSignal,
-  mark,
-  SdCrudListComponent,
-  SdSheetColumnDirective,
-  SdTextfieldComponent,
-  SdToastProvider,
-} from "@simplysm/angular";
-
-interface IInboundItem {
-  id: number;
-  receiptNo: string;
-  supplierName: string;
-  itemName: string;
-  quantity: number;
-  receivedAt: string;
-}
-
-interface IFilter {
-  searchText: string;
-}
-
-@Component({
-  selector: "app-inbound-list",
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  encapsulation: ViewEncapsulation.None,
-  standalone: true,
-  imports: [SdCrudListComponent, SdSheetColumnDirective, SdTextfieldComponent],
-  template: `
-    <div class="flex-column fill">
-      <sd-crud-list
-        title="입고 내역 조회"
-        [(ready)]="ready"
-        [initialized]="initialized()"
-        [(busyCount)]="busyCount"
-        [items]="items()"
-        [(selectedKeys)]="selectedKeys"
-        [(page)]="page"
-        [totalPageCount]="pageLength()"
-        [(sorts)]="sortingDefs"
-        [trackByFn]="trackByFn"
-        [restricted]="!perms().includes('use')"
-        (filterSubmit)="onFilterSubmit()"
-      >
-        <ng-template #filterTpl>
-          <div class="form-box-inline">
-            <div>
-              <label>검색</label>
-              <sd-textfield [(value)]="filter().searchText" (valueChange)="mark(filter)" />
-            </div>
-          </div>
-        </ng-template>
-
-        <sd-sheet-column [key]="'receiptNo'" [header]="'입고 번호'">
-          <ng-template [cell]="items()" let-item="item">
-            <div class="p-xs-sm">{{ item.receiptNo }}</div>
-          </ng-template>
-        </sd-sheet-column>
-
-        <sd-sheet-column [key]="'supplierName'" [header]="'공급처'">
-          <ng-template [cell]="items()" let-item="item">
-            <div class="p-xs-sm">{{ item.supplierName }}</div>
-          </ng-template>
-        </sd-sheet-column>
-
-        <sd-sheet-column [key]="'itemName'" [header]="'품목'">
-          <ng-template [cell]="items()" let-item="item">
-            <div class="p-xs-sm">{{ item.itemName }}</div>
-          </ng-template>
-        </sd-sheet-column>
-
-        <sd-sheet-column [key]="'quantity'" [header]="'수량'">
-          <ng-template [cell]="items()" let-item="item">
-            <div class="p-xs-sm tx-right">{{ item.quantity }}</div>
-          </ng-template>
-        </sd-sheet-column>
-      </sd-crud-list>
-
-      @if (initialized() && items().length === 0) {
-        <div class="p-default tx-center tx-theme-gray-default">조회된 입고 내역이 없습니다.</div>
-      }
-    </div>
-  `,
-})
-export class InboundListComponent {
-  private readonly _sdToast = inject(SdToastProvider);
-
-  perms = injectPermsSignal(["inbound"], ["use"]);
-
-  ready = signal(false);
-  initialized = signal(false);
-  busyCount = signal(0);
-
-  items = signal<IInboundItem[]>([]);
-  selectedKeys = signal<number[]>([]);
-  page = signal(0);
-  pageLength = signal(0);
-  sortingDefs = signal<{ key: string; desc: boolean }[]>([]);
-
-  filter = signal<IFilter>({ searchText: "" });
-  lastFilter = signal<IFilter>({ searchText: "" });
-
-  trackByFn = (item: IInboundItem) => item.id;
-
-  protected readonly mark = mark;
-
-  constructor() {
-    effect(() => {
-      if (!this.perms().includes("use") || !this.ready()) {
-        this.initialized.set(true);
-        return;
-      }
-
-      this.lastFilter();
-      this.page();
-      this.sortingDefs();
-
-      void untracked(async () => {
-        this.busyCount.update((v) => v + 1);
-        await this._sdToast.try(async () => {
-          await this._refresh();
-        });
-        this.busyCount.update((v) => v - 1);
-        this.initialized.set(true);
-      });
-    });
-  }
-
-  onFilterSubmit(): void {
-    this.page.set(0);
-    this.lastFilter.set({ ...this.filter() });
-  }
-
-  doRefresh(): void {
-    if (!this.perms().includes("use")) return;
-    mark(this.lastFilter);
-  }
-
-  private async _refresh(): Promise<void> {
-  }
-}

package/claude/skills/sd-demo/evals/fixtures/inventory-list/packages/demo-client/src/screens/inventory/inventory-master.list.ts

@@ -1,143 +0,0 @@
-import {
-  ChangeDetectionStrategy,
-  Component,
-  ViewEncapsulation,
-  effect,
-  inject,
-  signal,
-  untracked,
-} from "@angular/core";
-import {
-  injectPermsSignal,
-  mark,
-  SdCrudListComponent,
-  SdSheetColumnDirective,
-  SdTextfieldComponent,
-  SdToastProvider,
-} from "@simplysm/angular";
-
-interface IInventoryMasterItem {
-  id: number;
-  warehouseCode: string;
-  itemCode: string;
-  itemName: string;
-  active: boolean;
-}
-
-interface IFilter {
-  searchText: string;
-}
-
-@Component({
-  selector: "app-inventory-master-list",
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  encapsulation: ViewEncapsulation.None,
-  standalone: true,
-  imports: [SdCrudListComponent, SdSheetColumnDirective, SdTextfieldComponent],
-  template: `
-    <div class="flex-column fill">
-      <sd-crud-list
-        title="재고 마스터"
-        [(ready)]="ready"
-        [initialized]="initialized()"
-        [(busyCount)]="busyCount"
-        [items]="items()"
-        [(selectedKeys)]="selectedKeys"
-        [(page)]="page"
-        [totalPageCount]="pageLength()"
-        [(sorts)]="sortingDefs"
-        [trackByFn]="trackByFn"
-        [restricted]="!perms().includes('use')"
-        (filterSubmit)="onFilterSubmit()"
-      >
-        <ng-template #filterTpl>
-          <div class="form-box-inline">
-            <div>
-              <label>검색</label>
-              <sd-textfield [(value)]="filter().searchText" (valueChange)="mark(filter)" />
-            </div>
-          </div>
-        </ng-template>
-
-        <sd-sheet-column [key]="'warehouseCode'" [header]="'창고'">
-          <ng-template [cell]="items()" let-item="item">
-            <div class="p-xs-sm">{{ item.warehouseCode }}</div>
-          </ng-template>
-        </sd-sheet-column>
-
-        <sd-sheet-column [key]="'itemCode'" [header]="'품목 코드'">
-          <ng-template [cell]="items()" let-item="item">
-            <div class="p-xs-sm">{{ item.itemCode }}</div>
-          </ng-template>
-        </sd-sheet-column>
-
-        <sd-sheet-column [key]="'itemName'" [header]="'품목명'">
-          <ng-template [cell]="items()" let-item="item">
-            <div class="p-xs-sm">{{ item.itemName }}</div>
-          </ng-template>
-        </sd-sheet-column>
-      </sd-crud-list>
-
-      @if (initialized() && items().length === 0) {
-        <div class="p-default tx-center tx-theme-gray-default">조회된 재고 마스터가 없습니다.</div>
-      }
-    </div>
-  `,
-})
-export class InventoryMasterListComponent {
-  private readonly _sdToast = inject(SdToastProvider);
-
-  perms = injectPermsSignal(["inventory.master"], ["use", "edit"]);
-
-  ready = signal(false);
-  initialized = signal(false);
-  busyCount = signal(0);
-
-  items = signal<IInventoryMasterItem[]>([]);
-  selectedKeys = signal<number[]>([]);
-  page = signal(0);
-  pageLength = signal(0);
-  sortingDefs = signal<{ key: string; desc: boolean }[]>([]);
-
-  filter = signal<IFilter>({ searchText: "" });
-  lastFilter = signal<IFilter>({ searchText: "" });
-
-  trackByFn = (item: IInventoryMasterItem) => item.id;
-
-  protected readonly mark = mark;
-
-  constructor() {
-    effect(() => {
-      if (!this.perms().includes("use") || !this.ready()) {
-        this.initialized.set(true);
-        return;
-      }
-
-      this.lastFilter();
-      this.page();
-      this.sortingDefs();
-
-      void untracked(async () => {
-        this.busyCount.update((v) => v + 1);
-        await this._sdToast.try(async () => {
-          await this._refresh();
-        });
-        this.busyCount.update((v) => v - 1);
-        this.initialized.set(true);
-      });
-    });
-  }
-
-  onFilterSubmit(): void {
-    this.page.set(0);
-    this.lastFilter.set({ ...this.filter() });
-  }
-
-  doRefresh(): void {
-    if (!this.perms().includes("use")) return;
-    mark(this.lastFilter);
-  }
-
-  private async _refresh(): Promise<void> {
-  }
-}