CWF 1.0.0: check-concepts.sh 경로 검증 실패 (프로젝트 스코프)

[YeoulHi]

환경 정보

• OS: WSL2 Linux (6.6.87.2-microsoft-standard)
• Claude Code: v2.1.52
• CWF 버전: 0.8.10 → 1.0.0 (최근 업데이트)
• 설치 스코프: User scope (단일 사용자 설치)
• 프로젝트 타입: Personal PKM + Node v22

---

문제 상황

CWF 0.8.10에서 1.0.0으로 업데이트 후, check-concepts.sh 스크립트 실행 시 다음 오류가 발생합니다:

```bash
$ bash /home/duwls/.claude/plugins/cache/corca-plugins/cwf/1.0.0/scripts/check-concepts.sh --summary
[FAIL] missing registry: plugins/cwf/concepts/registry.yaml
```

---

원인 분석

1.0.0에서 새로운 거버넌스 개념 체계가 도입되면서:

• `concepts/` 디렉토리 신규 추가
• `concepts/registry.yaml` 필수 파일 추가
• `scripts/check-concepts.sh` 신규 추가

그러나 `check-concepts.sh` 스크립트가 참조하는 경로가:
```
plugins/cwf/concepts/registry.yaml (상대 경로, 부분 명시)
```

이 경로가 다음 중 어디를 기준으로 하는지 불명확합니다:

• CWF 플러그인 루트: `/home/duwls/.claude/plugins/cache/corca-plugins/cwf/1.0.0/`
• 프로젝트 루트: `/home/duwls/pkm/` (또는 사용자 프로젝트)
• 현재 작업 디렉토리 (cwd)

---

예상되는 원인

스크립트 내부에서 `registry.yaml`을 다음과 같이 참조하는 것으로 보임:
```bash

현재: 상대 경로 기준 (불명확)

REGISTRY_PATH="${CWF_PLUGIN_DIR}/plugins/cwf/concepts/registry.yaml"

또는

REGISTRY_PATH="./plugins/cwf/concepts/registry.yaml"
```

실제로는 다음과 같아야 할 것으로 예상:
```bash
REGISTRY_PATH="${CWF_PLUGIN_DIR}/concepts/registry.yaml"

또는

REGISTRY_PATH="$(dirname "$0")/../concepts/registry.yaml"
```

---

재현 방법

1. CWF 0.8.10 → 1.0.0으로 업데이트
2. 다음 명령 실행:
   ```bash
   bash ~/.claude/plugins/cache/corca-plugins/cwf/1.0.0/scripts/check-concepts.sh --summary
   ```
3. 오류 확인:
   ```
   [FAIL] missing registry: plugins/cwf/concepts/registry.yaml
   ```

---

영향 범위

• 0.8.10에서 1.0.0으로 업데이트한 모든 사용자
• 특히 프로젝트 스코프 설치 또는 다중 프로젝트 환경에서 문제 가능성 높음
• `cwf:retro`, `cwf:review` 등 개념 검증을 의존하는 skill의 동작 불안정성

---

요청 사항

1. 긴급: `check-concepts.sh`의 `registry.yaml` 경로 해석 로직 검토 및 수정
2. 추가: 경로 해석 실패 시 다음과 같은 명확한 오류 메시지 제공:
   ```
   Error: registry.yaml not found at .
   Please check:
   • CWF 설치 경로:
   • 기대 경로:
   • CWF_PLUGIN_DIR 환경변수 설정 여부
     ```
3. 문서화: README.md에 경로 해석 규칙 및 환경 설정 방법 추가

---

추가 정보

• 0.8.10에서는 `concepts/` 디렉토리가 없어 이 문제 미발생
• 1.0.0의 새로운 governance 개념은 긍정적이나, 설치 경로 관례가 명확하지 않음
• 한국 WSL2 개발자 환경에서 테스트 완료

---

빠른 피드백 부탁드립니다. 감사합니다!

[spilist]

@YeoulHi 앗 제가 여기 이슈가 달렸는지 전혀 몰랐네요. 죄송하고, 제보 감사합니다.

다만 그동안 업데이트된 에이전트들에 맞게, 아예 처음부터 재설계를 해보고 있습니다. 그때 되면 한번 더 댓글 달도록 하겠습니다.