@simplysm/sd-claude 14.0.77 → 14.0.79

package/claude/skills/sd-unpack/scripts/handlers/pdf_handler.py

@@ -36,6 +36,10 @@ def run(input_path: Path, out_dir: Path) -> None:
             ]
             if counts["tables"]:
                 parts.append(f"tables {counts['tables']} (cells {counts['table_cells']})")
+            if counts["form_fields"]:
+                parts.append(f"form_fields {counts['form_fields']}")
+            if counts["annotations"]:
+                parts.append(f"annotations {counts['annotations']}")
             page_summaries.append(" — ".join([parts[0], ", ".join(parts[1:])]))
 
         # 임베드된 첨부 (embedded files)
@@ -82,8 +86,17 @@ def _pdf_page_to_jsonl(
     추출:
     1. get_text("dict") 의 모든 블록 (text_block·image_block) — 표 영역 겹쳐도 그대로 보존
     2. find_tables() 로 표 셀 단위 노드 추가 (블록과 중복 가능, Claude 가 양쪽 비교 판단)
+    3. page.widgets() 로 form field 노드 (양식 입력란)
+    4. page.annots() 로 annotation 노드 (주석·highlight·sticky note)
     """
-    counts = {"text_blocks": 0, "image_blocks": 0, "tables": 0, "table_cells": 0}
+    counts = {
+        "text_blocks": 0,
+        "image_blocks": 0,
+        "tables": 0,
+        "table_cells": 0,
+        "form_fields": 0,
+        "annotations": 0,
+    }
 
     # 블록 추출 (모든 블록 보존)
     page_dict = page.get_text("dict")
@@ -100,16 +113,13 @@ def _pdf_page_to_jsonl(
             for line in blk.get("lines", []):
                 spans = line.get("spans", [])
                 line_text = "".join(span.get("text", "") for span in spans)
-                if line_text.strip():
-                    text_lines.append(line_text)
-            text = "\n".join(text_lines).strip()
-            if not text:
-                continue
+                text_lines.append(line_text)
+            text = "\n".join(text_lines)
             node_lines.append({
                 "page": page_num,
                 "block": block_idx,
                 "type": "text_block",
-                "bbox": [round(c, 2) for c in bbox],
+                "bbox": list(bbox),
                 "text": text,
             })
             counts["text_blocks"] += 1
@@ -127,7 +137,7 @@ def _pdf_page_to_jsonl(
                 "page": page_num,
                 "block": block_idx,
                 "type": "image_block",
-                "bbox": [round(c, 2) for c in bbox],
+                "bbox": list(bbox),
                 "ref": ref,
             })
             counts["image_blocks"] += 1
@@ -159,17 +169,75 @@ def _pdf_page_to_jsonl(
                     "table_bbox": t_bbox,
                     "row": r_idx,
                     "col": c_idx,
-                    "text": str(cell_text).strip(),
+                    "text": str(cell_text),
                 })
                 counts["table_cells"] += 1
 
+    # form fields (양식 입력란)
+    try:
+        widgets = page.widgets() or []
+        for widget in widgets:
+            try:
+                rect = list(widget.rect)
+            except Exception:
+                rect = [0, 0, 0, 0]
+            value = widget.field_value
+            if value is None:
+                value = ""
+            field_type = widget.field_type_string or str(widget.field_type)
+            name = widget.field_name or ""
+            node_lines.append({
+                "page": page_num,
+                "type": "form_field",
+                "name": name,
+                "field_type": field_type,
+                "value": str(value),
+                "bbox": rect,
+            })
+            counts["form_fields"] += 1
+    except Exception:
+        pass
+
+    # annotations (주석·highlight·sticky note 등)
+    try:
+        annots = page.annots() or []
+        for annot in annots:
+            try:
+                rect = list(annot.rect)
+            except Exception:
+                rect = [0, 0, 0, 0]
+            atype = annot.type
+            subtype = atype[1] if isinstance(atype, (tuple, list)) and len(atype) > 1 else str(atype)
+            info = annot.info or {}
+            node = {
+                "page": page_num,
+                "type": "annotation",
+                "subtype": subtype,
+                "bbox": rect,
+            }
+            content = info.get("content")
+            if content:
+                node["content"] = content
+            author = info.get("title")  # info["title"] = author
+            if author:
+                node["author"] = author
+            subject = info.get("subject")
+            if subject:
+                node["subject"] = subject
+            node_lines.append(node)
+            counts["annotations"] += 1
+    except Exception:
+        pass
+
     meta = {
         "_meta": {
             "page": page_num,
-            "size": [round(page.rect.width, 2), round(page.rect.height, 2)],
+            "size": [page.rect.width, page.rect.height],
             "blocks": counts["text_blocks"] + counts["image_blocks"],
             "tables": counts["tables"],
             "table_cells": counts["table_cells"],
+            "form_fields": counts["form_fields"],
+            "annotations": counts["annotations"],
         }
     }
     lines = [json.dumps(meta, ensure_ascii=False)]

package/package.json

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

package/claude/skills/sd-spec/references/spec-authoring.md

@@ -1,298 +0,0 @@
-# spec.md 작성 규약
-
-워크플로(언제 무엇을 묻는지)는 [SKILL.md](../SKILL.md) 참조.
-
-## 섹션 구조
-
-| §   | 섹션             | 분류           |
-| --- | ---------------- | -------------- |
-| §1  | 개요             | 워크플로       |
-| §2  | 업무 프로세스    | 워크플로       |
-| §3  | 기타 요구사항    | 워크플로       |
-| §4  | 화면             | 워크플로       |
-| §5  | 자동 처리        | 워크플로       |
-| §6  | 공통 정의        | 공통/자연 도출 |
-| §7  | 도메인 모델      | 공통/자연 도출 |
-| §8  | 외부 인터페이스  | 공통/자연 도출 |
-| §9  | 본문 외 결정사항 | 메타           |
-| §10 | 변경 이력        | 메타           |
-
-§6/§7/§8/§9/§10 은 작성 워크플로 중 자연 도출됨 (별도 워크플로 단계 없음).
-
-## 마커
-
-### 헤더 마커 (섹션 상태)
-
-| 마커                                          | 의미                                                                                              |
-| --------------------------------------------- | ------------------------------------------------------------------------------------------------- |
-| `[확정: YYYY-MM-DD]`                          | 섹션 확정. 본문에 인라인 `[OPEN]` 있어도 무방.                                                    |
-| `[OPEN: YYYY-MM-DD]`                          | 섹션 미확정 (사용자 보류 또는 헤더 분할 직후 자동). 본문 = 재분석용 참조 포인터만. 임의안(BPMN/와이어프레임/항목 등) 채우지 X. |
-| `[확정: YYYY-MM-DD, 구현: YYYY-MM-DD]`        | §4 화면 / §5 자동 처리 한정. `[확정]` 마커에 `구현: 날짜` 를 콤마로 이어붙인 확장형. sd-impl 이 시연 검증까지 통과한 시점에 부착. 본문이 변경되면 `[확정]` 날짜 갱신 여부와 무관하게 `구현: …` 부분을 제거 (구버전 구현 무효화). |
-
-대괄호 쌍을 연달아 두면(`[확정: …][구현: …]`) 마크다운이 reference-style 링크로 해석해 렌더링이 깨지므로, **단일 대괄호 안 콤마 결합** 형식을 사용한다.
-
-### 본문 인라인 마커
-
-| 마커     | 의미                                      |
-| -------- | ----------------------------------------- |
-| `[OPEN]` | 정보 부족·근거 없는 항목. 향후 확정 필요. |
-
-- 임의 채우거나 누락하지 말고 `[OPEN]` 인라인 표기.
-- 근거 부족 판정 = sd-base-rules "결정 근거" 적용. As-Is 만 근거인 항목·답변 범위 흡수 등 안티패턴 자료는 근거 없음으로 보고 `[OPEN]`.
-- 헤더 `[확정]` + 본문 인라인 `[OPEN]` = OPEN 항목 인정한 상태로 섹션 확정. 향후 OPEN 만 처리.
-- 묻기 시 선택지: `맞나요? [OPEN 상태로 확정 / 섹션 전체 보류 / OPEN 하나씩 해결]`
-
-### 헤더 `[OPEN]` 본문 — 재분석용 참조 포인터
-
-발생 경로 2가지 (본문 메커니즘·재개 절차는 동일):
-
-- **사용자 명시 보류**: 임의안 제시 후 사용자가 보류 지시.
-- **헤더 분할 직후 자동 OPEN**: SKILL.md 2단계(§2.x/§3.x) · 5단계(§4.x/§5.x) 확정 직후 본문 미작성 상태로 일괄 OPEN. 본문은 자료 위치 1줄이면 충분 (분류·분할 시 파악된 위치 그대로).
-
-본문에 담을 항목 (임의안 X):
-
-- **자료 위치**: Requirement Source 파일·범위 (예: `회의록.md L12-30`, `첨부A.pdf p.3`).
-- **LLM 과의 대화 발췌**: 분석 세션 중 사용자가 보류 즈음 준 부분 의견·근거·미결 코멘트 1~2줄 직접 인용 (Requirement Source 발화 X — 그건 "자료 위치" 로 처리).
-- **자료 연결 메모**: 한 섹션이 여러 자료에 걸칠 때 연결 추정 한 줄.
-- **다른 § 확정 영향 메모**: OPEN 유지 중 다른 § 확정이 본 OPEN 의 재분석에 영향을 줄 때 누적되는 한 줄 메모. 형식: `§X.Y <섹션명> 확정 — <결정 한 줄>` (운용 규칙은 SKILL.md "OPEN 섹션 영향 푸시").
-
-재개 시 이 포인터로 LLM 이 자료 재독 → 임의안 재도출 → 확정되면 본문 전체를 임의안으로 교체하고 헤더 마커 `[OPEN]` → `[확정: 날짜]`.
-
-## 본문 내 참조 (이름 기반)
-
-본문 내 다른 섹션 참조 시 § 번호 대신 `[카테고리.이름]` 형식 사용. 다단 표기 가능.
-
-- `[모델.재고]`, `[모델.박스.수량]`, `[모델.박스.품목.코드]`, `[화면.재고 확인]`, `[프로세스.입고]`, `[기타.과거 재고 조회]`, `[자동 처리.재고 스냅샷]`, `[외부인터페이스.ERP 입고 통보]`, `[공통 정의.Location 라벨]`
-
-§ 번호는 분석 진행 중 자주 바뀌므로 이름 기반이 안정적.
-
-## §1 개요
-
-### §1.1 핵심 목적
-
-- 한줄 동사형 큰 단위 표현.
-- 0단계 도메인 관계도 기반 사이클·관계 표현. §2.x 동사구 항목 나열은 §1.2 의 역할이므로 X.
-
-### §1.2 주요 목표
-
-- 단위: 화면·기능 단위가 아니라 최종 사용자가 수행하는 업무 흐름 1건.
-- 표현: 한 줄 동사구. 최종 사용자 도메인 어휘.
-- §2 업무 프로세스 헤더와 1:1 매핑이 일반적.
-- §2.x 본문에 명시된 핵심 항목은 한 줄에 모두 담아 임의 축약·누락 X.
-
-### §1.3 최종 사용자/이해관계자
-
-- 실제 담당자 이름은 넣지 않음.
-- 설명은 일반화하여 작성.
-
-### §1.4 환경/장치
-
-구성도와 장치 목록은 목적이 별개. 각각 독립 작성.
-
-- ASCII 구성도: 현장이 어떻게 생겼는지 시각화 — 이해당사자 간 현장 그림 맞추기용.
-  - 포함: 솔루션 측 노드(서버·데이터베이스·클라이언트 장치) + 노드 간 연결선 + 물리 위치 그룹(IDC·사무실·창고 등) + 자동 연동 외부 시스템.
-  - 제외: Actor, 외부 관계자(인적·조직), 수동 채널(메일·종이 등), 구체 제품명(MySQL 등)·통신 프로토콜(HTTPS 등), 장치 상세 사양(OS·해상도 등).
-- 장치 목록: 솔루션이 대상으로 하는 장치/환경 스펙 — 서버·DB·클라이언트 장치 등. OS·버전·제품명·모델·해상도·하드웨어 등. 명시 스펙에 맞게 개발하며, 다른 스펙 환경에서의 동작은 책임 범위 외.
-
-## §2 업무 프로세스
-
-§2.x 분할 판별은 [SKILL.md 1단계](../SKILL.md). §1.2 주요 목표 1건 ≈ §2.x 1건 매핑이 일반적.
-
-### 헤더 명칭
-
-- 시스템·문서·메뉴·양식 명칭 그대로 X (예: 발주서·송장 등 문서명을 동사구에 쓰지 X).
-- 도메인 업무 동사구 + 외부 관계자 관계가 드러나도록 (예: `구매처 발주 변경 요청`).
-- 외부 관계자 식별은 [SKILL.md 0단계](../SKILL.md) 관계도 참조.
-
-### BPMN
-
-- 사용자에겐 ASCII 로 보여주고, 확정 후 mermaid 로 문서 저장.
-- 흐름 단위 = 외부 비즈니스 이벤트 트리거부터 결과·후속까지 풀 흐름. 단일 화면 입력 절차 X.
-- 노드 = 최종 사용자 액션·시스템 핵심 트랜잭션 (1행 동사구). 줄바꿈(`<br/>`) X.
-- Actor·장치·매체(PDA·PC·종이 등)는 액션 컨텍스트로 노드에 명시 OK (예: `창고 작업자: PDA 박스 바코드 스캔`). OS·해상도·API·DB 등 시스템 내부 디테일은 X.
-- 외부 채널 송신(메일·파일 다운로드 등)·외부 응답 수신(다음 사이클 자료 도착 등) 도 노드로 명시. 처리 노드는 사각(`T[...]`), 이벤트 노드는 둥근 노드(`E([...])`).
-- 분기 = 사용자 의사결정 분기만.
-- BPMN 아래·관련 섹션 위에 흐름 설명을 bullet 로 자유 나열 (별도 헤더 X). 노드 동사구만으로 안 잡히는 룰·조건·계산식·외부와의 약속·자료 출처 인용 등을 1줄씩. §4 화면·§5 자동 처리 본문 작성 시 이 bullet 들을 근거로 매핑하여 누락 방지. 단, §4 자체 디테일(필드·UI·파일 확장자) / §6·§7·§8 정형 명세는 여기 X — 각 §, 본문에선 이름 참조.
-
-### 관련 섹션
-
-BPMN 아래에 `관련 섹션:` 한 줄 — 본 섹션이 참조/의존하는 다른 섹션을 `[카테고리.이름]` 콤마 나열 (카테고리 제한 없음).
-
-## §3 기타 요구사항
-
-- 프로세스 단위는 아니지만 정형 분해(화면/자동 처리) 동반하는 사용자 직접 요구.
-- 본문에는 요구 의도(한 줄~한 문단) + `관련 섹션:` 한 줄 (참조/의존 섹션을 `[카테고리.이름]` 콤마 나열, 카테고리 제한 없음) 만.
-- 구현 디테일은 §4 화면 / §5 자동 처리 본문에서 다룸.
-
-## §4 화면
-
-### 화면 목록 표
-
-§4 첫머리에 5컬럼 표:
-
-| § | 분류 | 화면 | 유형 | 장치 |
-
-- 분류: 도메인 묶음/메뉴 그룹 자유 명칭 (예: `기준정보`, `입고`, `재고`). LLM 임의안 → 확정.
-- 유형: 마스터 / 트랜잭션 / 조회
-- 장치: PC / PDA / 기타
-- 화면 추가/제거 시 표도 갱신. 같은 분류끼리 인접 배치.
-
-### 화면 정의
-
-§4.x 표준 구조 (위→아래 순서):
-
-- 헤더 인덱스 (한 줄씩):
-  - `Actor: <역할>`
-  - `관련 섹션: [카테고리.이름], ...` — 본 화면이 참조/의존하는 다른 섹션 콤마 나열 (카테고리 제한 없음. 모달 호출·시트 영역 재활용 등 화면 간 의존도 포함)
-- 기능 개요: 불릿으로 화면 기능 설명
-- 와이어프레임
-- 항목: 데이터 항목만 (필터·시트 컬럼·입력/상세 폼). 액션 버튼은 "동작" 에.
-  - **표 제목은 와이어의 영역 라벨과 동일 명칭**으로 굵게 표기. 와이어 `<필터>` → `**필터**`, `<품목 목록 시트>` → `**품목 목록 시트**`, `<스캔 입력 폼>` → `**스캔 입력 폼**`.
-  - 한 영역에 종류가 다른 표가 여러 개 필요하면 (좌·우 분할의 양쪽 시트 등) 종류 부기: `**<영역 라벨> — <필터|시트 컬럼|입력 폼>**` (예: `**헤더 목록 — 필터**`, `**BOA 시트 — 시트 컬럼**`).
-  - 시트 화면 기본 구성: 상단 command 바의 `<필터>` + 시트 영역 (시트 컬럼) 2 그룹.
-  - 표 형식 — 도메인 매핑은 별도 컬럼으로 (필터는 시트 컬럼과 중복이라 도메인 매핑 컬럼 X):
-    - 입력 폼: `항목 | 종류 | 필수 | 도메인 매핑 | 비고`
-    - 시트 컬럼: `컬럼 | 종류 | 필수 | 도메인 매핑 | 비고`
-    - 필터: `항목 | 종류 | 필수 | 비고` (시트 컬럼이 매핑 정보 보유)
-  - 필수 컬럼: 필수 여부가 무의미한 경우(조회 시트 컬럼 등) `-`.
-  - 도메인 매핑 컬럼: `[모델.X.Y]` 표기 (양식 매핑과 일관). 매핑 없는 항목(선택 체크박스 등) 은 `-`.
-  - 비고 컬럼: 표시 내용 (이름과 도메인으로 자명하지 않을 때 어떤 값이 표시되는지) / 편집 방법 (편집 가능 항목의 동작 — 예: 클릭 시 모달, 인라인 편집) / 기타 자유 설명.
-  - 시트 컬럼 그룹핑 (해당 시): 시트 컬럼이 도메인적으로 묶일 때 표 안에 그룹 표시. 그룹 헤더 행 1줄 (`**그룹명**`, 다른 셀 빈 칸) + 자식 컬럼은 `└ ` 들여쓰기 prefix. 표 컬럼 수 유지.
-- 동작: 액션 버튼·이벤트 별 처리.
-- 시각 규칙 (해당 시): 행 단위·조건부 시각 표현(비활성 행 취소선·상태별 강조 색·아이콘 등). 컬럼 단위 표현은 항목 표 비고에 작성하므로 여기 X.
-- 도메인 규칙·로직 (해당 시): 표준 절(항목/동작/양식 매핑)로 안 담기는 화면 고유 도메인 요구는 자유 명칭의 절을 필요한 만큼 추가. 누락 없이 적는 것이 핵심.
-- 양식 매핑 (해당 시): 외부 양식 파일을 다루는 동작(업로드·다운로드) 별로 매핑 표. 표 컬럼: `파일 컬럼` + `도메인 모델 ([모델.X.Y])` + `변환·규칙 (해당 시)`. 양식별 별도 표 + 방향 명시 (예: `업로드 양식`, `다운로드 양식`). §6.x 에 명세된 양식이면 컬럼명 일치, 일회성이면 화면 안에서 직접 명세.
-
-- 화면 헤더에 (장치) 표기 유지: `### N.N 화면명 (PC) [확정: 날짜]` 또는 `(PDA)` 등.
-- 모달 화면은 별도 §4.x 로 분리 (부르는 쪽 동작에 "→ [화면.X] 을 모달로 띄움" 명시). 화면명에 "(모달)" 등 사용 맥락 표기 X — 같은 화면이 다른 곳에서 다르게 호출될 수 있음.
-- 화면 일부 영역(시트·탭)이 다른 화면에서 모달로 재활용되면 별도 §4.x 분리 X. 대신 그 화면 동작 절 끝에 영역별 모달 호출 시 제약(편집 가능 여부 / 선택 전용 / multiselect 등) 한 줄씩 명시. 호출하는 쪽 동작은 "→ [화면.X] 의 <영역> 을 모달로 띄움" 으로 표기.
-
-### 마스터 화면 표준
-
-- ID 컬럼이 편집 버튼 역할(`[E N]`).
-- 첫 컬럼은 선택 체크박스(`[ ]`).
-- 시트 상단 버튼바: `[등록] [선택 삭제] [선택 복구] [엑셀 업로드] [엑셀 다운로드]`.
-- ID 정렬 역방향.
-
-### 상단 command 바
-
-페이지 제목 바로 아래, 시트/폼 영역 위. 페이지 전체 또는 현재 레코드 단위 액션 바.
-
-- 좌측: 필터 입력 + 조회 (list) / 진입 컨텍스트 표시 (detail)
-- 우측: 페이지·레코드 단위 액션 (있을 때만)
-- 좌/우 사이 ` │ ` 세로 구분선
-
-우측 버튼 그룹 순서 (좌→우):
-
-1. 기본 CRUD (저장 / 삭제 / 복구 등)
-2. 워크플로 상태 전환 (확정 / 취소 / 승인 / 반려 등)
-3. 유틸리티 (원본 다운로드 / 프린트 / PDF 등)
-
-list·detail 동일. 새 버튼은 해당 그룹 끝에 추가.
-시트 상단 버튼바도 동일 그룹 순서 적용 (마스터 화면 표준은 구체 인스턴스).
-
-### 와이어프레임 (텍스트)
-
-ASCII 그림 공통 규칙은 output-style `sd-tone` 의 "ASCII 그림" 절 참조.
-
-**원칙**: 영역 배치·구획만 잡는다. 디테일(필드·시트 컬럼·실제 값·아이콘 placeholder·fixed 경계·비활성 행 등 시각 표현)은 와이어에 X — 항목 표·동작 절·도메인 규칙 절이 단일 출처.
-
-- 데이터 영역은 영역 타입 + 짧은 라벨로 추상화: `<필터>`, `<폼>`, `<시트>`, `<목록>`, `<PO 목록>`, `<라인 시트 - 작성영역>` 등. 영역 종류가 한눈에 안 잡히면 라벨 보강.
-- 액션 버튼은 텍스트 유지 (`[조회]`, `[저장]`, `[등록]` 등) — 버튼 위치가 와이어의 정보. 아이콘만 있는 버튼도 텍스트로 표기.
-- 화면이 영역(좌/우 분할·탭·상단 command 바·시트 상단 버튼바 등)으로 나뉘면 박스 라인으로 구획 표시.
-- 상태(작성중/확정 등)에 따라 영역 구획이 크게 달라지면 상태별로 와이어프레임 분리. 제목은 `와이어프레임 (<상태명>):` (예: `와이어프레임 (확정 전):`, `와이어프레임 (확정 후):`).
-
-## §5 자동 처리
-
-스케줄러/이벤트 트리거로 도는 시스템 백그라운드 처리. 표준 프로토콜·채널을 통한 외부 자료 수집·적재(메일 폴링 + 첨부 적재, FTP 자료 흡수 등) 도 §5 — 시스템별 협상 없는 표준 인터페이싱은 §8 X.
-
-서브섹션: Flowchart / 목적 / 트리거 / 처리 / 예외 처리 / 양식 매핑 (해당 시) / 관련 섹션.
-
-- 양식 매핑 (해당 시): 외부 양식 파일을 다루는 처리(읽기·쓰기) 별로 매핑 표. 표 컬럼: `파일 컬럼` + `도메인 모델 ([모델.X.Y])` + `변환·규칙 (해당 시)`. 양식별 별도 표 + 방향 명시 (예: `읽기 양식`, `쓰기 양식`). §6.x 에 명세된 양식이면 컬럼명 일치, 일회성이면 처리 본문에서 직접 명세.
-- 마지막 `관련 섹션:` 한 줄에 참조/의존 섹션을 `[카테고리.이름]` 콤마 나열 (카테고리 제한 없음).
-
-### Flowchart
-
-- 사용자에겐 ASCII 로 보여주고, 확정 후 mermaid 로 문서 저장.
-- 노드 = 시스템 처리 단계 (1행 동사구).
-- 분기 = 시스템 조건 분기·예외.
-- 시작 = 트리거 (시간·이벤트). 종결 = 결과.
-- 특수 케이스(상태 머신 / 호출 시퀀스 등)는 mermaid 의 다른 다이어그램 type(stateDiagram-v2 / sequenceDiagram 등) 사용 가능.
-
-## §6 공통 정의
-
-- §6.1 용어 사전 고정. 도메인 어휘·약어·시스템 내 의미 정의.
-- 그 외 시스템 전반 규격(바코드 형식, 라벨, 공통 정책 등)은 §6.2~ 로 추가.
-- 특정 §2/§3 본문 단계에서 자연 흡수되는 규칙(업로드 자료 컬럼 매핑·자료 해석 규칙 등)은 §6 X → 사용처 본문에 둠.
-
-### 외부 자료 명세
-
-§6 외부 자료 = **시스템 외부에서 정의되어 도메인 모델로 자명하지 않은** 자료 (예: 외부 시스템이 송신하는 파일, 거래처가 보내는 표준 양식, 정해진 외부 규격). 도메인 모델의 자체 엑셀 업로드/다운로드 양식은 §6 X — §7 도메인 모델 + §4/§5 양식 매핑으로 자명.
-
-위 정의를 만족하는 §6.x 는 자료별 표 필수. 외부 자료의 모든 컬럼/필드를 1행 1정의로 나열 (자료 자체 객관 명세).
-
-자료-레벨 메타(송신 측·자료 라이프사이클·갱신 주기·식별 키 구조 등 자료 *전체* 에 적용되는 객관 명세)는 근거 있을 때 컬럼 표 위에 자유롭게 작성 (불릿/단락/`라벨: 값` 모두 허용, 자료 성격에 맞게). 컬럼 표 안에 욱여넣지 X.
-
-- 외부 자료가 여러 개 (예: `SAP.XML`, `D1.CSV`) 면 자료별 별도 표.
-- 표 컬럼: 자료 성격에 따라 LLM 임의안 → 확정. 예: `컬럼명/식별자` + `필수/선택` + `설명/규칙`.
-- 모든 컬럼 행 유지.
-- "설명/규칙" 류 컬럼은 **그 컬럼이 무엇인지(데이터 정의: 형식·값 범위·의미·제약)** 만 기재. **용도(어디에 어떻게 쓰이는지)** X — 용도·매핑은 사용처(§4 양식 매핑 / §5 양식 매핑) 에서 다룸.
-- 각 셀 값은 근거 채택 가능 자료(원본 자료 명시 정의·사용자 발언 등) 있을 때만 채움. 추정·임의 작성 X.
-- "원본 따름"·"전체 명세는 X.xlsx 참조" 등 외부 참조로 본문 정의 대체 X.
-- 원본 자료가 LLM 접근 불가/누락/모호 → 임의 처리 X. 사용자에게 자료 또는 명세 정보 요청.
-
-## §7 도메인 모델
-
-- 식별 키: 모든 엔티티에 `ID` 필드 (숫자, 자동 부여) 명시.
-- 비즈니스 키 (코드 등): 별도 명시. 수정 가능 (PK 가 아니므로).
-- 활성/비활성 boolean = 소프트 삭제 플래그. 마스터에는 완전 삭제 없음. UI 의 "삭제/복구" 액션과 매핑 → §6.1 용어 사전에 한 줄 명문화.
-- 섹션 구조: `필드:` 표 + `키/제약:` 불릿.
-- 필드 표 컬럼: `필드 | 타입 | 필수 | 비고`.
-- 비고 컬럼: **그 필드가 무엇인지(데이터 정의: 형식·값 범위·의미·제약·예시)** 만 기재. **용도·출처·외부 양식/외부 시스템과의 매핑** X — 그건 §4 양식 매핑 / §5 양식 매핑 / §8 자료 매핑 에서 다룸.
-
-## §8 외부 인터페이스
-
-§8 = 상대 시스템 고유 인터페이스 약속 (시스템마다 자료 매핑·방식이 달라 협상이 필요한 것).
-
-- 포함 예: 상대 ERP/거래처가 자체 정의한 API·EDI 규격, 외부 시스템 webhook 페이로드.
-- 제외 예: 표준 프로토콜·채널 (메일 SMTP/IMAP/Exchange/Graph, FTP, 표준 OAuth 등). 시스템별 협상 없음 → §5 자동 처리에서 트리거·처리·양식 매핑으로 흡수.
-
-본문은 도메인 약속 레벨까지만. 구체 endpoint URL·HTTP method·query 파라미터·인증 흐름 단계(grant_type·scope·token endpoint)·SDK 메소드명 등 구현 디테일은 X — 구현이 알아서. (§2 BPMN·§4 와이어·§7 도메인 모델과 동일 원칙)
-
-§8.x 표준 구조 (위→아래 순서):
-
-- 기본 정보 (헤더 없이 불릿 3개):
-  - `상대 시스템: <시스템명>`
-  - `방향: <방향 표기>`
-  - `전송 방식: <방식>`
-- `자료 매핑:` 헤더 + 표 (상대 시스템 필드 ↔ 본 시스템 출처)
-- `예외 처리:` 헤더 + 본문 (실패 케이스별 위험/대처/재시도 한계)
-- `관련 섹션:` 한 줄 — 호출자 등 참조/의존 섹션을 `[카테고리.이름]` 콤마 나열 (카테고리 제한 없음)
-
-한 §8.x 당 묻기 단위:
-
-1. 기본 정보 + 자료 매핑 → "맞나요?"
-2. 예외 처리 → "맞나요?"
-
-## §9 본문 외 결정사항
-
-§1~§8 어디에도 자연스럽게 들어가지 않는 결정·메모만. §1~§8 의 적절한 자리에 박을 수 있는 결정은 §9 X (누락 도피처로 사용 금지).
-
-### 분석 제외 항목
-
-1단계 헤더 분류 + 이후 본문 작성 중 식별된 "제외" 결정을 누적. 본 spec 에서 다루지 않지만 다른 spec / sd-dev / 운영 잔손 등으로 후속 처리될 항목 포함. 형식 (`- <요구 한 줄>` 1행 + 자식 불릿 2~3종):
-
-```
-- <요구 한 줄>
-  - 후속 처리: <다른 spec 신규 / 다른 spec 합류 / sd-dev / 운영 잔손 등>
-  - 자료 위치: <Requirement Source 파일·범위 (예: 회의록.md L12-30)>
-  - 메모: <대화 발췌 1~2줄, 필요 시>
-```
-
-- `후속 처리` · `자료 위치` 필수. `메모` 는 후속 처리 시 참고할 단서가 있을 때만.
-- 다른 spec / sd-dev 후속 처리 항목은 자료 위치를 충실히 — 후속 도구가 재독해야 함.
-
-## §10 변경 이력
-
-- 본문 수정·추가 사항을 날짜순으로 누적 기록.
-- 형식: `- YYYY-MM-DD: <변경 내용>` (간결하고 명확하게 작성)

package/claude/skills/sd-spec/references/spec-md-template.md

@@ -1,29 +0,0 @@
-# {name} 요구 분석서
-
-## 1. 개요
-
-### 1.1 핵심 목적
-
-### 1.2 주요 목표
-
-### 1.3 최종 사용자/이해관계자
-
-### 1.4 환경/장치
-
-## 2. 업무 프로세스
-
-## 3. 기타 요구사항
-
-## 4. 화면
-
-## 5. 자동 처리
-
-## 6. 공통 정의
-
-## 7. 도메인 모델
-
-## 8. 외부 인터페이스
-
-## 9. 본문 외 결정사항
-
-## 10. 변경 이력

package/claude/skills/sd-wip/SKILL.md

@@ -1,38 +0,0 @@
----
-name: sd-wip
-description: 현재 대화의 분석 컨텍스트를 `_wip.md` 또는 `.wips/...md` 에 누적 기록하거나(기본), 누적된 wip 을 압축한다(명시 요청 시). Use when "wip 정리/갱신/저장", "세션 옮길래", "wip 압축" 요청 시.
----
-
-# sd-wip
-
-여러 세션에 걸친 분석 컨텍스트를 wip 파일에 모아, 다른 새 세션에서 산출물(있다면) + wip 만 첨부해도 대화를 그대로 이어갈 수 있게 한다.
-
-## 모드 판정
-
-사용자 입력에 **wip 파일 첨부 + "압축" 명시 요청** 이 모두 있으면 **압축 모드**, 그 외는 **누적 모드**.
-
-- 누적 모드: 현재 대화의 신규 분석분을 wip 파일 끝에 시간순 append. 카테고리 분류 X.
-- 압축 모드: 첨부된 wip 본문 전체를 7축 구조로 재작성해 덮어쓰기. 절차는 [references/compact.md](references/compact.md).
-
-운용 공통:
-
-- 갱신은 사용자 명시 요청 시에만. 자동 갱신 X.
-- 합의 사항이 산출물로 이동하면 wip 에서 해당 부분 제거.
-
-## 파일 라우팅
-
-- **산출물 있는 대화** (본 세션에서 사용자 컨펌된 작성/수정 대상 파일 1건, 예: spec.md, impl.md) → 그 산출물 옆 `_wip.md`.
-  - 누적 모드에서도 산출물 옆 `_wip.md` 가 있는지 **MUST** 능동 확인. 있으면 그 파일에 append.
-- **산출물 없는 일반 대화** → `.wips/{yyMMddHHmmss}_{slug}.md`.
-  - 기존 `.wips/*.md` 가 입력에 첨부되어 있으면 그 파일에 append.
-  - 첨부 없으면 새 파일 생성. `slug` 는 대화 주제 짧은 한·두 단어 (LLM 임의안, 사용자 수정 가능). 타임스탬프는 `date +%y%m%d%H%M%S`.
-
-## 누적 모드 절차
-
-1. 라우팅 결정 (위 규칙). 대상 파일이 없으면 새로 생성하며 헤더 `# 작업 메모` 한 줄로 시작.
-2. 직전 갱신 이후의 신규 분석분만 추출:
-   - 사용자 발화: 의도·결정·정정·명시 가이드·가설·가정·보류
-   - LLM 발화: 제안·임의안·대안 중 사용자가 동의/정정한 것
-3. 추출분을 시간순 메모로 파일 끝에 append. 기존 본문은 건드리지 X. 카테고리 헤더(`## 결정 흐름`, `## 사용자 정정 패턴` 등) 만들지 X.
-   - 형식: `- <한 줄 메모>` 또는 짧은 문단. 결정·정정·가설·자료 위치 등 본질을 빠뜨리지 않고 자연어로 적되, 분류 헤더로 묶지 않는다.
-4. 산출물에 이미 표면화된 결과·매핑은 wip 에 옮기지 X. (결과에 이르는 흐름·근거·정정·가설·메타 가이드만)

package/claude/skills/sd-wip/evals/fixtures/with-artifact/projects/acct/_wip.md

@@ -1,3 +0,0 @@
-# 작업 메모
-
-- spec §2.3 원가 모듈 부문별 배부 로직: 사용자가 "직접배부/단계배부/상호배부 3안 중 고를게" 라고 보류. SENTINEL_ARTIFACT_LINE 기준점.

package/claude/skills/sd-wip/evals/fixtures/with-artifact/projects/acct/spec.md

@@ -1,15 +0,0 @@
-# 회계 시스템 spec
-
-## 1. 개요
-[확정] 회계 시스템 ERP 연동, 매입/매출/원가 3개 모듈.
-
-## 2. 모듈
-
-### 2.1 매입
-[확정] 공급사 마스터 SAP 연동, 일별 배치.
-
-### 2.2 매출
-[확정] 세금계산서 발행 외부 e-Tax 라이브러리 사용.
-
-### 2.3 원가
-[OPEN] 부문별 배부 로직 — 사용자 추후 정의.

package/claude/skills/sd-wip/evals/fixtures/with-existing-wip/.wips/260101120000_acct.md

@@ -1,6 +0,0 @@
-# 작업 메모
-
-- 회계 시스템 분석 시작. ERP 연동 대상 모듈은 매입/매출/원가 3개로 합의됨.
-- 매입 모듈: 공급사 마스터를 SAP 와 연동, 일별 배치. SENTINEL_EXISTING_LINE_A 기준 정합성 체크 필요.
-- 매출 모듈: 세금계산서 발행은 외부 e-Tax 라이브러리 사용, 자체 구현 X 로 합의.
-- 원가 모듈: 부문별 배부 로직은 사용자가 추후 정의. SENTINEL_EXISTING_LINE_B 보류 항목.

package/claude/skills/sd-wip/evals/fixtures/with-existing-wip-for-compact/.wips/260101120000_acct.md

@@ -1,14 +0,0 @@
-# 작업 메모
-
-- 회계 시스템 분석 시작. ERP 연동 대상 모듈은 매입/매출/원가 3개로 합의됨.
-- 매입 모듈은 처음에 일배치/실시간 두 안 검토. 사용자 정정: "실시간은 부하 우려" → 일배치로 확정.
-- 매입: 공급사 마스터 SAP 연동, 일별 배치, 차이 발생 시 알림.
-- 매출 모듈: 세금계산서 발행 자체구현 검토 → 사용자가 "그건 외부 라이브러리 써" 정정 → e-Tax 라이브러리 사용 확정.
-- 매출: 매출 인식 기준은 수출/내수 분리. 수출은 통관완료일, 내수는 출하일.
-- 원가 모듈: 부문별 배부 로직 → 사용자 보류 ("기준 정해서 다시 알려줄게").
-- 가정: 회계 기간 마감은 매월 5일 (사용자 미확정, 표준 가정으로 진행 중).
-- 가설: 외화 환산은 매월 말일 환율 일괄 적용 — 사용자 미확정.
-- 자료 위치: ./docs/회계요구사항.docx p.3 "원가 배부" 항목, p.7 "외화 처리" 항목.
-- 사용자 가이드: "매입/매출 모듈 우선, 원가는 후순위로 진행".
-- LLM 임의안: 매입 마스터 동기화 주기 1시간 → 사용자 정정: "일배치면 일배치지 뭐가 시간이야".
-- 사용자 명시: 시스템 내부 용어 (예: "마스터데이터 동기화") 노출 X, 사용자 화면 표기는 "공급사 정보 갱신" 으로 통일.

package/claude/skills/sd-wip/evals/golden.jsonl

@@ -1,4 +0,0 @@
-{"id": "case-001-new-accumulate", "input": "방금 회계 시스템 분석 진행했어. ERP 연동 대상은 매입/매출/원가 3개 모듈로 합의됐고, 매입은 SAP 일배치 연동, 매출은 외부 e-Tax 라이브러리 사용. 원가 배부 로직은 사용자가 추후 정의하기로 보류. 이거 wip 정리해줘.", "rubric": [".wips/ 디렉토리에 .md 파일이 정확히 1개 생성되었는가", "생성된 .md 파일 이름이 12자리 숫자로 시작하고 그 다음 언더스코어가 오는 패턴(예: 260518204500_xxx.md)인가", "생성된 .md 파일 본문에 '## 결정 흐름', '## 사용자 정정 패턴', '## 가설·가정', '## 자료 컨텍스트' 헤더가 모두 등장하지 않는가", "생성된 .md 파일 본문에 '회계' 또는 '매입' 또는 '매출' 또는 '원가' 중 최소 한 단어가 포함되었는가"], "fixture": "empty"}
-{"id": "case-002-existing-accumulate", "input": "지난 세션에 .wips/260101120000_acct.md 까지 분석해왔어. 이번 세션에서 매출 인식 기준을 수출=통관완료일, 내수=출하일 로 분리하기로 결정했어. wip 갱신해줘.", "rubric": [".wips/260101120000_acct.md 파일 본문에 'SENTINEL_EXISTING_LINE_A' 문자열이 그대로 남아있는가", ".wips/260101120000_acct.md 파일 본문에 'SENTINEL_EXISTING_LINE_B' 문자열이 그대로 남아있는가", ".wips/ 디렉토리에 .md 파일이 정확히 1개만 존재하는가 (새 파일 생성 X)", ".wips/260101120000_acct.md 파일 본문에 '수출' 또는 '통관완료일' 또는 '출하일' 중 최소 한 단어가 추가되었는가", ".wips/260101120000_acct.md 파일 본문에 '## 결정 흐름' 헤더가 새로 등장하지 않는가"], "fixture": "with-existing-wip"}
-{"id": "case-003-compact", "input": ".wips/260101120000_acct.md 가 너무 길어졌어. 이거 압축 정리해줘.", "rubric": [".wips/260101120000_acct.md 파일이 갱신된 상태로 존재하는가", "갱신된 본문에 '## 결정', '## 결정 흐름', '## 사용자 정정 패턴', '## 사용자 명시 가이드', '## 가설·가정', '## 보류·미합의', '## 자료 컨텍스트' 헤더 중 최소 4개 이상이 등장하는가", ".wips/ 디렉토리에 .md 파일이 정확히 1개만 존재하는가"], "fixture": "with-existing-wip-for-compact"}
-{"id": "case-004-artifact-accumulate", "input": "projects/acct/spec.md 분석 이어왔어. §2.1 매입에서 공급사 마스터 동기화 주기를 1시간 검토했다가 사용자가 일배치로 정정했음. wip 갱신해줘.", "rubric": ["projects/acct/_wip.md 파일 본문에 'SENTINEL_ARTIFACT_LINE' 문자열이 그대로 남아있는가", "projects/acct/_wip.md 파일 본문에 '동기화' 또는 '일배치' 또는 '공급사' 중 최소 한 단어가 추가되었는가", "샌드박스에 .wips/ 디렉토리가 생성되지 않았는가 (산출물 옆 _wip.md 라우팅이 적용됨)"], "fixture": "with-artifact"}

package/claude/skills/sd-wip/references/compact.md

@@ -1,79 +0,0 @@
-# 압축 모드 절차
-
-누적된 wip 파일을 7축 구조로 재작성해 덮어쓴다. **정확성·완전성 1순위. 시간·용량 비용 감수. 단순 요약 X.**
-
-## 5단계
-
-### 단계 1: 입력 전수 스캔
-
-입력 source:
-
-- 첨부된 wip 파일 본문 전체
-- 현재 대화 turn (첫 turn ~ 마지막)
-
-각 source 에서 추출:
-
-- 사용자 발화: 의도·결정·정정·명시 코멘트·가이드·가설·가정
-- LLM 발화: 제안·결정 흐름·임의안·대안 제시
-- 기존 wip 본문 항목: 결정·결정 흐름·정정 패턴·가이드·가설·보류·자료 컨텍스트
-
-요약식으로 건너뛰기 X. turn 단위·항목 단위로 본다.
-
-### 단계 2: 7축 분류
-
-추출 항목을 다음 7축으로 분류:
-
-1. **결정** — 사용자 확정·합의 사항
-2. **결정 흐름** — 결정 이르기까지 근거·대안·트레이드오프
-3. **사용자 정정 패턴** — LLM 이 틀린 부분 → 사용자 명시 정정 (재발 방지용)
-4. **사용자 명시 가이드** — 메타 행동 지침·작업 원칙
-5. **가설·가정** — 확정 안 받았지만 작업 흐름에 영향
-6. **보류·미합의** — 보류된 결정·미합의 논의
-7. **자료 컨텍스트** — 자료 위치·핵심 발췌
-
-### 단계 3: 산출물 중복 제거
-
-산출물(있다면)에 이미 표면화된 결과·매핑·포인터는 wip 에 옮기지 X.
-**유지 대상**: 결과는 산출물에 들어갔지만 그 결과에 이르는 흐름·근거·정정·가설·메타 가이드.
-
-### 단계 4: 7축 구조로 덮어쓰기
-
-대상 wip 파일을 아래 구조로 덮어쓴다 (기존 본문 base 두지 X, 처음부터 재구성).
-
-```markdown
-# 작업 메모
-
-현재 분석 컨텍스트 압축. 산출물(있다면) 과 함께 읽어 새 세션에서 대화를 그대로 이어가도록.
-
-## 결정
-- <결정 항목 1줄씩>
-
-## 결정 흐름
-### <결정 항목 1>
-- 결정: <무엇>
-- 근거: <왜>
-- 대안: <어떤 대안이 있었는지>
-- 정정 흐름: <사용자 정정 있었으면 그 흐름>
-
-## 사용자 정정 패턴
-- <정정 1줄씩>
-
-## 사용자 명시 가이드
-- <가이드 1줄씩>
-
-## 가설·가정
-- <가설 1줄씩>
-
-## 보류·미합의
-- <보류 항목 1줄씩>
-
-## 자료 컨텍스트
-- `<파일 경로>` <L범위 또는 페이지> — `핵심 발췌` 또는 메모
-```
-
-- 정보량 누락 X. "한 페이지 요약" = 누락이지 압축 아님.
-- 산출물 본문 표현은 옮기지 X (단계 3).
-
-### 단계 5: 누락 검증
-
-단계 1 의 입력 source 재스캔. 단계 2 의 7축 전체에 대해 누락 검증. 누락 발견 시 단계 4 보강. 검증 통과 후 작업 종료.