team onboarding_ko

팀 온보딩: 설치, 업데이트, 제거 안내

언어: 🇺🇸 English | 🇰🇷 한국어

이 가이드는 GitHub 계정을 막 만든 팀원을 위한 문서다. terminal 명령을 shell에 복사해 Ghost-ALICE OS를 설치, 업데이트, 제거한다.

Contents

• 0. Prerequisites
• 1. Open A Terminal
• 2. First Install
  • macOS, Linux, WSL, or Git Bash
  • Windows Command Prompt or PowerShell
• 3. Optional Visibility Profile
• 4. Check Installation
• 5. Update Skills
• 6. Removal
  • Full Removal
  • Remove Only Selected Skills
  • Contract-End Or Team-Exit Cleanup
• 7. FAQ
  • "permission denied" or "404" appears
  • "git is not recognized" appears
  • "claude is not recognized" appears
  • Skills Do Not Appear In Claude Code After Installation
  • git pull Fails
  • Can I Type "update skills" Inside A Claude Code Session?
• Summary

0. Prerequisites

아래 항목은 PC에 설치되어 있어야 한다. 없는 항목을 먼저 설치한다.

Requirement	Check command	If missing
Git	git --version	git-scm.com에서 설치한다
Node.js	node -v	Node.js downloads에서 설치한다. Ghost-ALICE의 hook-enabled 설치는 tool-checkpoint dispatcher 실행에 Node.js가 필요하다
Claude Code	claude --version	official native install guide를 따른다
Codex (optional)	codex --version	사용하지 않으면 skip한다. 필요하면 npm i -g @openai/codex로 설치한다
GitHub account and repo access	browser에서 github.com/AidALL/ghost-alice를 열고 404가 아닌지 확인한다	team admin에게 org invite를 요청한다

Gemini CLI는 제거된 legacy target이며 현재 새 설치 경로의 일부가 아니다. 신규 설치 안내는 Claude Code와 Codex에 집중한다. 기존 Gemini 환경 정리는 maintainer에게 먼저 확인한다.

1. Open A Terminal

OS	Terminal
Windows	Command Prompt 또는 PowerShell
macOS	Terminal.app
Linux	기본 terminal

terminal이 익숙하지 않다면 KIST AIX Strategy Office가 배포한 Terminal Playground도 도움이 된다. 기본 terminal 명령을 가볍게 연습할 수 있다.

2. First Install

아래 명령을 한 줄씩 복사해 실행한다.

macOS, Linux, WSL, or Git Bash

# 1. Clone the repo after moving to the desired location
cd ~/Desktop
git clone https://github.com/AidALL/ghost-alice.git

# 2. Install skills for every detected AI CLI
cd ghost-alice
bash install.sh

Windows Command Prompt or PowerShell

REM 1. Clone the repo after moving to the desired location
cd %USERPROFILE%\Desktop
git clone https://github.com/AidALL/ghost-alice.git

REM 2. Install skills for every detected AI CLI
cd ghost-alice
.\install.cmd

official autopilot addon까지 함께 설치하려면 다음을 사용한다.

.\install.cmd --addon autopilot

설치가 성공하면 installer가 완료 메시지를 출력한다.

3. Optional Visibility Profile

default visibility profile은 strict다. 이 값은 user에게 보이는 governance message surface만 바꾼다. hooks, strict logs, Work-Impact Projection은 계속 동작한다.

bash install.sh --visibility dynamic

.\install.cmd --visibility dynamic

strict, dynamic, minimal 중 하나를 사용한다. 이전 spelling인 --agent-visibility도 compatibility alias로 계속 동작하지만 새 command는 --visibility를 사용한다.

4. Check Installation

bash install.sh --status

.\install.cmd --status

skill 이름 옆에 ● 또는 + marker가 나타나면 설치된 상태다.

5. Update Skills

skill이 업데이트되면 각 local checkout과 설치된 skill 사본을 동기화해야 한다. 먼저 repository를 업데이트한다.

cd ~/Desktop/ghost-alice
git pull --ff-only

git pull --ff-only가 멈추거나 conflict를 보이면 installer를 반복 실행하지 않는다. 먼저 Install troubleshooting을 읽는다.

skill body만 바뀐 경우 다음만으로 충분할 수 있다.

• Claude Code 사용자: skill은 symlink라 git pull --ff-only가 body 변경을 반영한다.
• installer, hooks, _shared, bootstrap, skill execution policy가 바뀐 경우: 사용하는 platform에 대해 installer를 다시 실행한다.
• Codex 사용자: Codex는 copy 설치를 사용하므로 git pull --ff-only 이후 installer를 다시 실행한다.

bash install.sh --platform claude

bash install.sh --platform codex

# Check installation status
bash install.sh --status

.\install.cmd --platform claude

.\install.cmd --platform codex

REM Check installation status
.\install.cmd --status

installer를 다시 실행한 뒤 status 결과가 overall: ok인지 확인한다. Claude Code가 stale managed hooks를 보고하면 같은 platform에 대해 installer를 다시 실행한다. pending-merge 경고가 남아 있으면 agent에게 미해결 merge review를 요청한 뒤 status를 다시 확인한다.

6. Removal

일반 제거는 로컬에 설치된 Ghost-ALICE OS 항목만 삭제한다. repository 자체를 삭제하거나 GitHub access를 변경하지 않는다.

Full Removal

bash install.sh --uninstall

.\install.cmd --uninstall

Remove Only Selected Skills

특정 skill만 제거하려면 skill 이름을 전달한다.

bash install.sh --uninstall hwpx

.\install.cmd --uninstall hwpx

Contract-End Or Team-Exit Cleanup

전용 offboarding flag는 public installer surface에서 제거됐다. contract 종료, account 회수, 팀원 퇴사 시에는 local Ghost-ALICE 설치에 대해 일반 full uninstall을 실행하고, repository access나 account 제거는 team administrator를 통해 처리한다. 더 넓은 device 정리가 필요하면 Ghost-ALICE 설치 footprint 밖의 local 파일을 삭제하기 전에 maintainer에게 확인한다.

7. FAQ

"permission denied" or "404" appears

현재 account로 GitHub repository에 접근할 수 없다. team admin에게 AidALL org invite를 요청한다.

"git is not recognized" appears

Git이 설치되어 있지 않다. git-scm.com에서 설치한 뒤 새 terminal을 연다.

"claude is not recognized" appears

Claude Code가 설치되어 있지 않다. 공식 install guide를 따른 뒤 새 terminal을 연다.

Skills Do Not Appear In Claude Code After Installation

terminal에서 bash install.sh --status 또는 .\install.cmd --status를 실행한다. ○ marker가 있으면 해당 skill은 설치되지 않은 상태이므로 installer를 다시 실행한다.

git pull Fails

local 파일 편집이 conflict를 일으킬 수 있다. Committer identity unknown, CONFLICT, Automatic merge failed, UU / AA가 보이면 먼저 Install troubleshooting을 읽는다.

git status --short --branch
git diff --name-only --diff-filter=U

Can I Type "update skills" Inside A Claude Code Session?

가능하다. agent가 필요하면 git pull --ff-only와 재설치를 실행할 수 있다. 직접 terminal에서 git pull --ff-only를 실행하는 편이 보통 더 빠르다.

Summary

Task	Command	Where	Frequency
첫 설치	git clone + bash install.sh / .\install.cmd	Terminal	1회
설치 확인	bash install.sh --status / .\install.cmd --status	Terminal	필요할 때
업데이트	git pull --ff-only	Terminal	필요할 때마다
전체 제거	bash install.sh --uninstall / .\install.cmd --uninstall	Terminal	필요할 때
contract 종료 정리	bash install.sh --uninstall / .\install.cmd --uninstall	Terminal	contract 종료 또는 팀 이탈 시