← ClaudeAtlas

ai-dev-setting-installlisted

Use when modifying assets (rules, skills, agents, hooks) in ai-dev-setting and deciding whether changes need reinstallation across projects, or when running setup/update-all commands.
jjackkun/claude-harness-hermes · ★ 1 · AI & Automation · score 72
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가 깨진 경우 (경로 이동 등)