ai-dev-setting-installlisted
Install: claude install-skill jjackkun/claude-harness-hermes
# ai-dev-setting 설치 메커니즘
## 핵심 원칙
Linux/macOS: `assets/` 하위 파일은 **symlink**로 각 프로젝트에 연결된다.
`assets/rules/common/coding-style.md`를 수정하면 재설치 없이 즉시 반영된다.
Windows: **copy** 방식. 수정 후 반드시 재설치 필요.
## 파일 수정 후 반영 여부
| 수정 내용 | Linux | Windows |
|-----------|-------|---------|
| `assets/rules/**` | 즉시 반영 (symlink) | update-all 필요 |
| `assets/skills/**` | 즉시 반영 (symlink) | update-all 필요 |
| `assets/agents/**` | 즉시 반영 (symlink) | update-all 필요 |
| `assets/hooks/**` | 즉시 반영 (symlink) | update-all 필요 |
| `presets/*.conf` 추가 | setup으로 신규 설치 필요 | 동일 |
| 신규 프로젝트 등록 | `setup.sh` 실행 필요 | 동일 |
## 설치/업데이트 명령
```bash
# 신규 프로젝트 설정 (대화형 fzf UI)
bash setup.sh # Claude 대상
bash setup.sh --codex # Codex 대상
bash setup.sh --both # 둘 다
# 등록된 모든 프로젝트 재설치
bash update-all.sh # Claude 대상
bash update-all.sh --target codex # Codex 대상
bash update-all.sh --target both # 둘 다
# setup.sh --update-all 도 동일
bash setup.sh --update-all --target both
```
## 설치 레지스트리
- Claude: `.installed-projects`
- Codex: `.installed-projects.codex`
`update-all.sh`는 이 레지스트리를 읽어 `presets.lock`을 기준으로 재설치한다.
경로가 사라진 프로젝트는 자동으로 레지스트리에서 제거된다.
## 확인 방법
```bash
# symlink 연결 확인
ls -la /path/to/project/.claude/rules/common
# → lrwxrwxrwx ... -> /home/.../ai-dev-setting/assets/rules/common
```
## 언제 update-all이 필요한가
- Windows 환경의 모든 파일 수정 후
- 신규 preset/rule/skill 추가 후 기존 프로젝트에도 적용하려 할 때
- symlink가 깨진 경우 (경로 이동 등)