aiwf 0.3.23 → 0.4.0

package/docs/modernization/reviews/2026-10-03-claude-cli/DIRECTION.ko.md

@@ -0,0 +1,84 @@
+# Claude 계획 리뷰 — 방향·범위·우선순위
+
+작성: 2026-10-03. 상태: **AI 리뷰 완료, 휴먼 리뷰 대기**.
+
+[검토 대상 계획](../../CLI-PRODUCTIVITY.ko.md), [통합 판단](../../CLAUDE-PLAN-REVIEW-2026-10-03.ko.md).
+
+- 실제 CLI: Claude Code `2.1.288`.
+- 세션 ID: `0f7eb76e-d5a5-4859-b6a6-9756fa26af16`.
+- 요청·관측 모델: `claude-sonnet-5-5` (`modelUsage` 확인).
+- 요청 effort: `high`. 결과 JSON에 실제 적용 effort가 없어 관측 effort는 미확인.
+- 검토 당시 계획 SHA256: `426d38f8d52001678083979ca7418c64c6d0b780fa8ef504aec1d6aa5c6b7ab8`.
+- 실행 결과: exit 0, `subtype: success`, `is_error: false`, 권한 거부 0, stderr 0 bytes.
+- 도구: `Glob, Grep, Read`. 원문 결과를 별도 수정 없이 아래에 옮겼다. 행 번호는 위 hash의 계획을 기준으로 한다.
+- 셸·테스트 실행 및 파일 편집은 리뷰 세션에 제공하지 않았다. 모델 리뷰는 자동 테스트 통과나 휴먼 승인이 아니다.
+
+아래는 최종 리뷰 답변이며, 프롬프트·전체 세션 JSON·실행 로그는 저장소 밖의 비공개 임시 경로에 유지한다.
+
+---
+
+# CLI-PRODUCTIVITY.ko.md 계획 리뷰 (review-1: 목적·범위·우선순위·도입 부담)
+
+## 결론: 조건부 적합
+
+방향은 맞습니다. 현재 도구로 실제 UC 하나를 먼저 돌리고, 병목이 확인될 때만 자동화한다는 순서입니다. 다만 문서 본문은 그 순서를 따르지 않고 `verify`, receipt, runner의 설계를 먼저 상세히 씁니다. 파일럿의 종료·확장 조건이 없어서 "관찰된 병목이 있을 때만 확장"이라는 원칙이 실제로는 작동하지 않습니다. 아래 P1과 P2를 고치면 적합입니다. 이견이 없는 부분은 "유지할 강점"에 적었습니다.
+
+## 지적
+
+### P1. 파일럿이 1순위로 선언되지만 설계 항목이 없고, 확장 판단 기준도 없음
+- 사실: 13~16행은 "실제 UC 하나를 먼저 수행하고, 반복한 것을 `verify`로 통합하고, 병목이면 runner를 만든다"고 씁니다. 그런데 본문 섹션은 `첫 단계`(67행), `두 번째 단계`(91행)가 구현 설계이고, 파일럿 섹션(142행)은 대상 예제와 측정값 표만 있습니다.
+- 사실: 측정 표(146~152행)에는 기준선, 임계값, 중단 조건이 없습니다. 154행도 비교 부등식만 주고 수치는 비워 두었습니다. 그래서 "수작업이 반복됐다"를 몇 번·몇 분부터 `verify`나 runner로 올리는지 정해져 있지 않습니다.
+- 사실: 파일럿의 끝은 packet이 `awaiting_review`인 상태입니다(workflow SKILL.md 33행). 목표→명세→구현→검증은 이어지지만, 사람이 packet을 읽고 결과를 어디에 어떻게 남기는지는 계획에 없습니다. DIRECTION.ko.md 9행의 "검토자가 한 묶음으로 읽는다"에 해당하는 단계가 파일럿에서 빠져 있습니다.
+- 사실: 기존 근거 FULL-TEST-2026-10-03.md(25~27행)는 예제 UC의 서비스 범위만 다뤘습니다. UI와 로그인은 제외했고, 소비 프로젝트 파일럿이 아닙니다. 계획 144행도 이를 smoke 용도로만 쓴다고 인정합니다.
+- 영향: 파일럿이 완료됐는지, 결과로 무엇을 만들지 판단할 기준이 없습니다. 결국 이미 상세히 설계된 runner로 자연스럽게 넘어가게 됩니다.
+- 최소 수정안: 파일럿 섹션에 다음 네 가지만 추가합니다. (a) 대상 UC 선정 기준, (b) 기록 양식: 단계별 실제 시간, 수작업 전사 횟수, 누락·오류, 사람 검토자가 packet을 읽은 결과와 재요청 횟수, (c) 확장 트리거: 예를 들어 같은 수작업이 2개 UC에서 반복되고 합계가 N분 이상이면 `verify`로 올린다, (d) 종료 조건: 자동화 없이 충분하면 종료. N 값은 사용자가 정할 휴먼 결정으로 남겨도 됩니다.
+
+### P2. 두 번째 단계가 범용 task runner·증명 체계로 번지는 설계
+- 사실: 93~127행은 receipt 9항목, 입력 manifest와 제외 정책, `fresh/stale/unknown`, 환경 allowlist, 프로세스 취소·Windows `.cmd` 차이, packet v2, v1 투영을 정의합니다. 성공 조건 표(131~138행)도 runner 행에서 정상·실패·미시작·시작 오류·timeout·취소·출력 초과·저장 실패를 모두 요구합니다.
+- 사실: workflow는 "기존 프로젝트 도구와 현재 에이전트를 사용하고 별도 런타임을 설치하지 않는다"고 합니다(SKILL.md 12행). DIRECTION.ko.md 32행도 같은 방향입니다. 반면 111행의 "프로젝트가 명시적으로 정의한 검사 ID"는 소비 프로젝트에 새 검사 정의 설정 형식이 생긴다는 뜻입니다. UC/BR/TC→check 매핑도 필수라고 하는데, 그 형식을 어디에 둘지는 정하지 않았습니다. core는 upstream 바이트 보존 대상이라 `aiwf-core`에는 둘 수 없고, `aiwf-spec`/CLI의 새 계약이 됩니다. 이 소유권 결정이 계획에 없습니다.
+- 추론: 병목이라는 측정이 없는 상태(29행에서 "측정은 없다"고 인정)에서 이 크기의 계약을 먼저 쓰면 도입 부담이 크고 유지비용이 큽니다. 154행의 손익 부등식이 오히려 이 범위를 반대합니다.
+- 영향: 로컬 receipt는 변조 방지가 아니라고 125행이 스스로 인정합니다. 그런데 비용은 증명 체계 수준입니다. 효용 대비 비용이 불균형합니다.
+- 최소 수정안: 두 번째 단계는 "파일럿에서 결과 전사가 병목으로 측정되면 별도 설계 문서를 쓴다"는 한 문단과 트리거만 남깁니다. 세부 receipt·입력 manifest·성공 조건은 부록이나 후속 문서로 옮기거나 "초안·미채택" 표시를 붙입니다. 매핑 형식의 소유 플러그인(`aiwf-spec`)은 한 줄로 명시합니다.
+
+### P2. 유지보수 자동화가 "첫 단계"로 올라와 파일럿 우선순위를 흐림
+- 사실: 근거 표 1순위(26행)는 AIWF 저장소의 한글 검토 보고서입니다. 67~75행 "첫 단계"의 첫 소제목도 "AIWF 저장소를 유지하는 사람"입니다. 같은 문서 18행은 이를 "새 제품 기능의 선행 조건으로 만들지 않는다"고 하므로 순서가 모순됩니다.
+- 사실: 현재 병목은 도구 부재가 아니라 사람 검토 0건(26행의 70개 대기, `human_review` 기록은 manifest.json에서 검색되지 않음)입니다. checker가 이미 원문·번역·해시·링크를 검사합니다. 보고서가 줄이는 것은 검토 준비 시간인데, 검토 자체가 시작되지 않았습니다. 시간 절감 추정도 계획이 "추론·중간"으로 분류했습니다.
+- 사실: CI 연결(75행)은 기존 명령을 재사용하므로 비용이 작고 적절합니다. `.github/`가 없다는 점도 확인했습니다.
+- 영향: 사용자 지침인 "문서 관리 우선"은 만족하지만, 그 해석이 AIWF 저장소 내부 도구로 쏠려 소비 프로젝트 UC의 명세 최신성 확인이라는 제품 핵심이 뒤로 밀립니다.
+- 최소 수정안: 문서 검토 보고서는 `verify`와 같은 단계에 묶지 말고 "사람 검토가 시작되어 준비 시간이 실제 병목으로 기록되면 도입"으로 이동합니다. 기존 CI 연결만 즉시 가능한 항목으로 남깁니다. 1순위 행은 "파일럿"으로 바꿉니다.
+
+### P3. DIRECTION.ko.md의 플러그인 수가 현재 구성과 불일치
+- 사실: DIRECTION.ko.md 40행은 "현재 배포는 6개 core/workflow/stack 플러그인"이라고 합니다. README.ko.md 51~60행과 docs/ko-skills/README.md 19~28행은 위임 애드온 2개를 포함한 8개입니다. 이번 변경이 이 파일의 44행을 수정했지만 40행은 그대로입니다.
+- 영향: 문서 정확성 우선 지침과 어긋납니다.
+- 최소 수정안: 40행을 "8개(위임 애드온 2개는 선택)"로 수정합니다. 한글 검토본이나 manifest 해시와는 무관한 문서라서 영향은 없다고 추정합니다. 확인은 못 했습니다.
+
+### P3. 범위 밖 항목과 시점 고정 검증 기록
+- 사실: 140행의 Node 20 EOL·runtime 지원 정책은 파일럿과 직접 관계가 없습니다. 또 166~177행의 검증 결과는 파일 수정 후에는 오래된 기록이 됩니다. 계획 본문은 SHA256 기준으로 고정되지 않습니다.
+- 최소 수정안: runtime 결정은 별도 항목으로 분리하고 이 문서에서는 한 줄 참조로 줄입니다. 166행 이하는 "작성 시점의 기록, 이후 수정은 재검증 필요"를 명시하거나 대상 해시를 병기합니다.
+
+## 현재 core와 workflow의 책임 경계 평가 (사실)
+- 경계는 일관됩니다. core 7개는 upstream 그대로, `aiwf-spec`은 workflow 1개와 CLI, 별도 모델 런타임은 없습니다(DIRECTION.ko.md 28~34행). 계획 113행의 "모델 호출·교차 CLI는 기존 위임 스킬 계약 유지"도 맞습니다.
+- 모호한 곳은 한 군데입니다. runner가 만드는 UC/BR/TC→check 매핑과 검사 정의의 소유 위치입니다(P2 참조).
+
+## 유지할 강점
+- 새 스킬·명령 수를 성공 지표로 삼지 않고, 문서 누락·오래된 결과 재사용 감소를 기준으로 둔 점(20행).
+- 미구현 상태를 일관되게 표기하고, README·한글 README·aiwf-spec 번역·catalog·DIRECTION에 연결한 점. 승인·merge·배포를 자동화 부수효과에서 제외했고(127행), 완료·승인·수용을 분리했습니다.
+- `exit 0`이 구조 검사 전체 실행을 뜻하지 않는다는 점(`VALIDATOR_MISSING`)을 `incomplete`로 구분한 설계.
+- 병렬 실행, Sprintable, 무인 실행, 영향 기반 테스트 축소를 명확히 뒤로 미룬 점(156~162행).
+- 승인 기록은 `awaiting_review`를 유지하고 에이전트가 승인을 만들지 않는다는 원칙.
+
+## 가장 작은 다음 단계 (제안)
+1. 사용자가 지정한 소비 프로젝트의 UC 1개를 현재 `workflow`와 CLI 4개 명령만으로 실행합니다. 단계별 시간, 수작업 전사 건수, 누락·오류를 한 장의 기록으로 남깁니다.
+2. 실제 사람 검토자가 packet을 읽고 재요청 사유를 기록합니다. 이것이 휴먼 리뷰 단계의 증거가 됩니다.
+3. 그 기록으로 `verify`가 필요한지 판단합니다.
+4. 저비용 병행 항목은 기존 `npm`·Python 검사를 CI에 연결하는 것 하나뿐입니다. 문서 보고서는 보류합니다.
+
+미룰 항목: receipt/packet v2/runner 세부 계약, 문서 검토 보고서, 독립 doctor, Node 지원 하한 결정, 변경 영향 기반 테스트 축소, Sprintable, 병렬·무인 실행.
+
+## 미확인 사항과 휴먼 결정
+- 확인하지 못한 것: 계획 166~177행에 적힌 `npm test` 85개 통과 등 실행 결과는 이 세션에서 재실행하지 않았습니다. 계획의 주장 그대로입니다. `src/lib/spec-workflow.js`의 evidence 허용 필드와 `spec_lint.py`의 INFO 동작은 이 세션에서 직접 읽지 않았고, 다른 세션 담당인 기술 audit 범위로 남깁니다. `docs/ko-skills/aiwf-spec/README.ko.md`와 manifest 해시 일치 여부, README.md 영문 변경의 세부 내용도 확인하지 않았습니다. manifest의 `awaiting_review` 70개는 확인했습니다.
+- 사용자가 정할 것: 파일럿 대상 소비 프로젝트와 UC, 확장 트리거의 임계값 N, 검토자 지정, 문서 검토 보고서의 도입 시점, runtime 하한 정책의 별도 처리 여부.
+- 한글 검토본의 의미 검토와 휴먼 승인은 이 리뷰로 대체되지 않습니다. 모두 `awaiting_review`입니다.
+
+## 수행 기록
+파일 변경 없음. 셸·테스트·`docs:check` 실행 없음. 권한 거부 없음. 사용한 도구는 Read, Grep, Glob뿐이고 다른 세션 결과는 보지 않았습니다. 세션 시작 hook에 스킬 호출 지시가 있었지만, 이 세션의 제한(스킬 도구가 목록에 없고, 지정된 읽기 전용 범위)에 따라 호출하지 않았습니다.

package/examples/spec-workflow/README.md

@@ -0,0 +1,54 @@
+# Spec Workflow Example: 지출 내역 제출
+
+AIUP(AI Unified Process) 명세 산출물을 최소 구성으로 끝까지 보여주는 예제다.
+헤딩, 라벨, 상태 토큰, 식별자는 파서 호환을 위해 영어를 유지하고, 서술 내용은 한국어로 적는다.
+
+## 구성
+
+| 경로 | 내용 |
+|------|------|
+| `docs/vision.md` | 제품 비전, 문제, 결과, 범위 밖 |
+| `docs/requirements.md` | 기능 요구사항 FR-001 |
+| `docs/glossary.md` | 도메인 용어와 금지 동의어 |
+| `docs/entity_model.md` | 엔터티와 속성 |
+| `docs/use_cases.puml` | 유스케이스 다이어그램 |
+| `docs/use_cases/UC-001-submit-expense.md` | 유스케이스 명세 |
+| `docs/test_cases/TC-001-submit-expense.md` | 테스트 케이스 |
+
+## 상태
+
+- 유스케이스 UC-001: Reviewed
+- 테스트 케이스 TC-001: Reviewed
+- 요구사항 FR-001: Open
+- 비전, 요구사항, 용어집, 엔터티 모델: Reviewed
+
+식별자와 파일 이름은 도구 호환을 위해 영어 슬러그(`UC-001-submit-expense`, `TC-001-submit-expense`)를 쓰고,
+화면에 보이는 유스케이스 이름과 본문 서술은 한국어를 쓴다. 추적의 기준 키는 한국어 제목이 아니라 ID(UC-001, TC-001)다.
+
+## 검증
+
+저장소 루트에서 다음을 실행한다.
+
+```bash
+python3 plugins/aiwf-core/skills/spec-review/scripts/spec_lint.py \
+  --docs examples/spec-workflow/docs --strict --no-baseline
+
+python3 plugins/aiwf-core/skills/use-case-spec/scripts/validate_use_case.py --strict \
+  examples/spec-workflow/docs/use_cases/UC-001-submit-expense.md
+
+python3 plugins/aiwf-core/skills/spec-review/scripts/spec_lint.py \
+  --docs examples/spec-workflow/docs --trace
+```
+
+## 이 예제가 증명하는 것과 증명하지 않는 것
+
+이 예제는 명세 문서가 파서의 구조 규칙과 문서 사이의 상호 참조 규칙을 통과함을 보여준다.
+린트 통과는 다음을 뜻하지 않는다.
+
+- 비즈니스 수용: 실제 이해관계자가 내용과 범위를 검토해 승인했다는 증거가 아니다.
+- 한국어 의미 완전성: 린터는 영어 기준의 구조와 어휘를 검사하므로, 한국어 서술의 누락, 모호함, 문서 사이의 모순을 탐지하지 않는다.
+- 구현 일치: 코드가 이 명세를 구현했는지는 별도의 검증 대상이다.
+
+따라서 `Status: Reviewed`는 문서 상태이지 승인, 완료, 비즈니스 수용의 선언이 아니다.
+
+지출 제출은 설명을 위한 가상 제품이다. 실제 회사 규정이나 고객 요구사항을 근거로 작성한 문서가 아니다.

package/examples/spec-workflow/docs/entity_model.md

@@ -0,0 +1,33 @@
+# Entity Model
+
+> Status: Reviewed
+
+## Entity Relationship Diagram
+
+```mermaid
+erDiagram
+    SUBMITTER ||--o{ EXPENSE_REPORT : "submits"
+```
+
+### SUBMITTER
+
+지출 내역을 제출하는 사람을 나타낸다.
+
+| Attribute | Description        | Data Type | Length/Precision | Validation Rules      |
+|-----------|--------------------|-----------|------------------|-----------------------|
+| id        | 제출자 고유 식별자 | Long      | 19               | Primary Key, Sequence |
+| name      | 제출자 이름        | String    | 100              | Not Null              |
+
+### EXPENSE_REPORT
+
+제출된 지출 내역 한 건을 나타낸다.
+
+| Attribute    | Description      | Data Type | Length/Precision | Validation Rules                    |
+|--------------|------------------|-----------|------------------|-------------------------------------|
+| id           | 지출 내역 식별자 | Long      | 19               | Primary Key, Sequence               |
+| amount       | 제출 금액        | Decimal   | 10,2             | Not Null, greater than 0  |
+| description  | 사용 내용        | String    | 200              | Optional                            |
+| submitted_at | 제출 시각        | DateTime  | -                | Not Null                            |
+| submitter_id | 제출자 참조      | Long      | 19               | Not Null, Foreign Key (SUBMITTER.id) |
+
+**Constraints:** 지출 내역의 금액은 0보다 커야 한다.

package/examples/spec-workflow/docs/glossary.md

@@ -0,0 +1,9 @@
+# Glossary
+
+> Status: Reviewed
+
+| Term      | Definition                                                     | Avoid     |
+|-----------|----------------------------------------------------------------|-----------|
+| 제출자    | 지출 내역을 작성해 제출하는 사람.                              | 신청자    |
+| 지출 내역 | 정산을 위해 제출하는 금액과 사용 내용의 묶음.                  | 경비 청구 |
+| 승인자    | 제출된 지출 내역을 검토하고 승인 여부를 결정하는 사람.         |           |

package/examples/spec-workflow/docs/requirements.md

@@ -0,0 +1,10 @@
+# Requirements
+
+> Status: Reviewed
+
+## Functional Requirements
+
+| ID     | Title          | User Story                                                                  | Priority | Status |
+|--------|----------------|-----------------------------------------------------------------------------|----------|--------|
+| FR-001 | 지출 내역 제출 | As a 제출자, I want 지출 내역을 제출하기 so that 승인자가 검토할 수 있다.   | High     | Open   |
+

package/examples/spec-workflow/docs/test_cases/TC-001-submit-expense.md

@@ -0,0 +1,37 @@
+# Test Case: 지출 내역 제출
+
+## Overview
+
+**ID:** TC-001  
+**Goal:** 제출자가 지출 내역을 제출하고 접수 번호를 받는 흐름을 끝까지 확인한다.  
+**Priority:** High  
+**Status:** Reviewed  
+
+## Roles
+
+- 제출자 (지출 금액과 사용 내용을 입력하고 제출한다)
+
+## Preconditions
+
+- 제출자 계정이 준비되어 있다 (테스트 데이터 시드)
+
+## Flow
+
+| Step | Name | Description | Test Data | Use Case |
+|------|------|-------------|-----------|----------|
+| 1 | 제출 시작 | 제출자가 지출 내역 제출을 시작한다 | - | [UC-001](../use_cases/UC-001-submit-expense.md) |
+| 2 | 잘못된 금액 입력 | 제출자가 금액과 사용 내용을 입력한다 | -100, 팀 회식 | [UC-001](../use_cases/UC-001-submit-expense.md) |
+| 3 | 오류 확인 | 금액 오류 메시지가 표시되고 제출된 내역이 없음을 확인한다 | - | - |
+| 4 | 금액 수정 | 제출자가 금액을 수정한다 | 12000 | [UC-001](../use_cases/UC-001-submit-expense.md) |
+| 5 | 제출 확정 | 제출자가 제출을 확정한다 | - | [UC-001](../use_cases/UC-001-submit-expense.md) |
+| 6 | 접수 확인 | 접수 번호가 표시되는지 확인한다 | - | - |
+
+## Validation
+
+1. **접수 상태**: 최종 지출 내역이 제출 상태로 표시된다.
+2. **금액 보존**: 기록된 금액이 12000으로 표시된다.
+
+## Postconditions
+
+- 지출 내역 1건이 제출 상태로 남는다 (금액 12000, 사용 내용 팀 회식).
+- 접수 번호가 기록된다.

package/examples/spec-workflow/docs/use_cases/UC-001-submit-expense.md

@@ -0,0 +1,63 @@
+# Use Case: 지출 내역 제출
+
+## Overview
+
+**Use Case ID:** UC-001  
+**Use Case Name:** 지출 내역 제출  
+**Primary Actor:** 제출자  
+**Goal:** 제출자가 지출 내역을 제출하여 승인자가 검토할 수 있게 한다.  
+**Trigger:** 제출자가 지출 내역 제출을 요청한다.  
+**Status:** Reviewed  
+
+**Requirements:** [FR-001](../requirements.md)
+
+## Preconditions
+
+- 제출자가 시스템에 로그인되어 있다
+- 제출할 지출 내역의 금액과 사용 내용을 알고 있다
+
+## Main Success Scenario
+
+1. 제출자가 지출 내역 제출을 시작한다.
+2. 시스템이 지출 내역 입력 화면을 표시한다.
+3. 제출자가 지출 금액과 사용 내용을 입력한다.
+4. 시스템이 입력한 금액이 0보다 큰지 확인한다.
+5. 제출자가 제출을 확정한다.
+6. 시스템이 지출 내역을 제출 상태로 기록하고 접수 번호를 표시한다.
+
+## Alternative Flows
+
+### A1: 유효하지 않은 금액
+
+**Trigger:** 입력한 금액이 0 이하이다 (step 4)  
+**Flow:**
+
+1. 시스템이 금액은 0보다 커야 한다는 메시지를 표시한다.
+2. 제출자가 금액을 수정한다.
+3. Use case continues at step 4.
+
+### A2: 제출 처리 실패
+
+**Trigger:** 시스템이 지출 내역을 기록할 수 없다 (step 6)  
+**Flow:**
+
+1. 시스템이 제출을 완료하지 못했음을 알린다.
+2. Use case ends.
+
+## Postconditions
+
+### Success Postconditions
+
+- 지출 내역이 제출 상태로 기록되어 있다
+- 제출자에게 접수 번호가 부여되어 있다
+
+### Failure Postconditions
+
+- 지출 내역이 제출 상태로 기록되지 않는다
+- 기존에 기록된 지출 내역은 변경되지 않는다
+
+## Business Rules
+
+### BR-001: 금액 조건
+
+제출하는 지출 금액은 0보다 커야 한다.

package/examples/spec-workflow/docs/use_cases.puml

@@ -0,0 +1,12 @@
+@startuml Use Cases Overview
+left to right direction
+
+actor "제출자" as submitter
+
+rectangle "지출 정산 시스템" {
+    usecase "UC-001\n지출 내역 제출" as UC001
+}
+
+submitter --> UC001
+
+@enduml

package/examples/spec-workflow/docs/vision.md

@@ -0,0 +1,21 @@
+# Vision
+
+> Status: Reviewed
+
+## Product
+
+지출 정산 시스템
+
+## Problem
+
+팀 구성원이 지출 내역을 구두나 메신저로 보고하면 승인자가 금액과 사용 내용을 다시 확인해야 하므로 누락과 착오가 생긴다.
+
+## Outcome
+
+제출자가 지출 내역을 제출하면 접수 번호를 받고, 승인자가 검토할 수 있는 상태가 된다.
+
+## Non-Goals
+
+- 지출 승인과 반려 결정
+- 회계 시스템으로의 자동 전기
+- 지출 증빙 이미지의 자동 인식

package/package.json

@@ -1,36 +1,34 @@
 {
     "name": "aiwf",
-    "version": "0.3.23",
-    "description": "AI Workflow Framework for Claude Code with multi-language support (Korean/English)",
-    "main": "index.js",
+    "version": "0.4.0",
+    "description": "AI Workflow Framework: use-case-driven specs and evidence for coding agents",
+    "main": "./src/lib/spec-workflow.js",
     "type": "module",
     "bin": {
-        "aiwf": "./src/cli/index.js",
-        "aiwf-lang": "./src/cli/language-cli.js",
-        "aiwf-sprint": "./src/cli/sprint-cli.js"
+        "aiwf-spec": "./src/cli/spec-cli.js"
     },
     "scripts": {
-        "test": "node --experimental-vm-modules node_modules/.bin/jest",
+        "test": "node --test tests/spec-workflow/*.test.mjs",
+        "pretest": "npm run docs:check",
+        "docs:check": "node scripts/check-korean-docs.mjs",
+        "docs:check:local": "node scripts/check-korean-docs.mjs --check-local",
         "check:deps": "node scripts/check-dependencies.js",
-        "prepublishOnly": "npm run check:deps",
-        "lang:status": "node src/cli/index.js lang status",
-        "lang:set": "node src/cli/index.js lang set",
-        "lang:reset": "node src/cli/index.js lang reset",
-        "validate:commands": "node scripts/validate-commands.js",
-        "update:file-lists": "node scripts/update-file-lists.js",
-        "update:file-lists:dry-run": "node scripts/update-file-lists.js --dry-run",
-        "update:file-lists:verbose": "node scripts/update-file-lists.js --verbose"
+        "prepublishOnly": "npm run docs:check && npm run check:deps",
+        "test:spec": "npm test",
+        "validate:spec-plugin": "node scripts/validate-spec-plugin.mjs",
+        "test:spec-upstream": "python3 plugins/aiwf-core/skills/use-case-spec/scripts/validate_use_case.py --self-test && python3 plugins/aiwf-core/skills/test-case/scripts/bpmn_paths.py --self-test && python3 plugins/aiwf-core/skills/spec-review/scripts/spec_lint.py --self-test",
+        "validate:spec-example": "python3 plugins/aiwf-core/skills/spec-review/scripts/spec_lint.py --docs examples/spec-workflow/docs --strict --no-baseline"
     },
     "keywords": [
         "aiwf",
         "ai",
         "workflow",
-        "framework",
         "claude-code",
-        "multilingual",
-        "korean",
-        "english",
-        "project-management"
+        "codex",
+        "spec-driven",
+        "use-case",
+        "evidence",
+        "sprintable"
     ],
     "author": "moonklabs",
     "license": "MIT",
@@ -43,93 +41,27 @@
     },
     "homepage": "https://github.com/moonklabs/aiwf#readme",
     "engines": {
-        "node": ">=14.0.0"
+        "node": ">=20.0.0"
     },
     "files": [
-        "src/",
-        "docs/",
-        "config/",
-        "utils/",
-        "lib/",
-        "commands/",
-        "templates/",
-        "rules/",
-        "personas/",
-        "hooks/",
-        "scripts/",
-        "ai-tools/",
-        "index.js",
+        "src/cli/spec-cli.js",
+        "src/lib/spec-workflow.js",
+        ".claude-plugin/marketplace.json",
+        "scripts/check-dependencies.js",
+        "scripts/install-spec-skills.mjs",
+        "scripts/validate-spec-plugin.mjs",
+        "docs/modernization/",
+        "examples/spec-workflow/",
         "README.md",
         "README.ko.md",
         "CHANGELOG.md",
-        "GUIDE.md",
-        "GUIDE.ko.md"
-    ],
-    "dependencies": {
-        "chalk": "^5.3.0",
-        "chokidar": "^3.5.3",
-        "commander": "^11.1.0",
-        "fs-extra": "^11.3.0",
-        "glob": "^10.3.10",
-        "js-yaml": "^4.1.0",
-        "ora": "^8.0.1",
-        "prompts": "^2.4.2",
-        "table": "^6.8.1",
-        "tar": "^6.2.1",
-        "tiktoken": "^1.0.21",
-        "yaml": "^2.3.4",
-        "figlet": "^1.7.0"
-    },
-    "devDependencies": {
-        "jest": "^30.0.3"
-    },
-    "aiwf": {
-        "moduleCategories": {
-            "core": [
-                "utils/paths.js",
-                "utils/messages.js",
-                "utils/language-utils.js"
-            ],
-            "yolo": [
-                "utils/engineering-guard.js",
-                "utils/checkpoint-manager.js"
-            ],
-            "persona": [
-                "lib/ai-persona-manager.js",
-                "lib/context-engine.js",
-                "lib/metrics-collector.js",
-                "lib/task-analyzer.js",
-                "lib/token-optimizer.js"
-            ],
-            "installer": [
-                "lib/installer.js",
-                "lib/backup-manager.js",
-                "lib/file-downloader.js",
-                "lib/rollback-manager.js",
-                "lib/validator.js"
-            ],
-            "cache": [
-                "lib/template-cache-system.js",
-                "lib/offline-detector.js",
-                "lib/template-downloader.js",
-                "lib/template-version-manager.js"
-            ],
-            "github": [
-                "lib/github-integration.js",
-                "lib/state/state-index.js",
-                "lib/state/priority-calculator.js",
-                "lib/state/task-scanner.js"
-            ],
-            "common": [
-                "lib/resource-loader.js"
-            ]
-        },
-        "criticalModules": [
-            "utils/engineering-guard.js",
-            "utils/checkpoint-manager.js"
-        ],
-        "dynamicImports": [
-            "utils/engineering-guard.js"
-        ]
-    }
-}
+        "plugins/aiwf-core/",
+        "plugins/aiwf-spec/",
+        "plugins/aiwf-delegate-claude/",
+        "plugins/aiwf-delegate-codex/",
+        "plugins/aiwf-vaadin-jooq/",
+        "plugins/aiwf-angular-jpa/",
+        "plugins/aiwf-blazor-dotnet/",
+        "plugins/aiwf-nestjs-nextjs/"
+    ]
+}

package/plugins/aiwf-angular-jpa/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "aiwf-angular-jpa",
+  "version": "0.7.0",
+  "description": "AI Unified Process construction skills for Spring Boot + Spring Data JPA and Angular applications.",
+  "author": {
+    "name": "Marc Affolter",
+    "email": "marc_affolter@outlook.com",
+    "url": "https://unifiedprocess.ai"
+  },
+  "license": "Apache-2.0"
+}