Ghost-ALICE OS
| Language: 🇺🇸 English | 🇰🇷 한국어 |
Ghost-ALICE OS는 AI 에이전트의 작업을 관리하는 거버넌스 계층입니다. 지원하는 에이전트 실행 환경에서 사용자의 의도, 작업 범위, 검증 근거, 실행 상태를 확인할 수 있도록 관리합니다.
기존 에이전트 실행 환경 위에서 동작하며, 에이전트가 완료를 선언하기 전에 작업 과정과 근거를 검토할 수 있도록 돕습니다. 프롬프트 모음이나 챗봇 연결 도구, 독립 실행형 에이전트 런타임을 제공하는 저장소는 아닙니다.
버전 0.5.1
Core 0.5.1과 Ghost-ALICE Autopilot 0.5.1은 현재 response-route와 완료 계약을 사용합니다. Ghost-ALICE Autopilot에는 Core 0.5.1 이상이 필요합니다. 두 프로젝트 모두 Apache-2.0으로 제공됩니다.
승인된 작업의 진행과 복구
응답 모델은 사용자의 목적과 제약을 유지하며 승인된 작업을 수행하고, 반대 근거가 필수 결과나 의존 관계에 영향을 주는지 판단합니다. 필요한 작업을 수정하면서 지원되는 결과와 미해결 요구를 보존합니다.
- 입력 훅은 원문을 저장하지 않고 현재 사용자 입력을 기록합니다. 응답 모델이 승인된 작업을 선택하면 호스트 도구가 그 선택을 Core에 전달하고 Core가 검증·저장합니다.
- 모델은 호스트에 필요한 도구 실행을 요청하고 실제 관찰을 읽습니다. 변하지 않은 유효한 근거의 원본 출처와 검증 시각을 유지합니다.
- 모델은 각 주장을 원본 근거와 먼저 비교하고 답변 전체를 사용자 목적·제약과 비교합니다. Core는 두 판단을 인증·기록하고 상태와 참조를 반환합니다.
- 모델은 네이티브 호스트를 통해 답변을 제출합니다. Core의 Stop 가드는 제출된 검토 기록을 검사합니다. 미해결 필수 작업은 드러냅니다.
경로나 저장된 계획이 권한을 만들지는 않습니다. 근거가 있는 답변도 미완료 작업을 정확히 보고할 수 있습니다. 새 입력은 라우팅을 다시 열지만 변하지 않은 근거를 무효화하지 않으며, 기록 오류 때문에 같은 업무를 재실행하지 않습니다.
단독 흐름은 Core 아키텍처, 상세 계약은 세션 게이트 매트릭스를 참고해 주세요. Autopilot 설치로 추가되는 근거 반영과 승인 계획의 계속 작업은 Autopilot 아키텍처에서 설명합니다.
빠른 시작
복제한 Ghost-ALICE 저장소 폴더에서 Core와 공식 Ghost-ALICE Autopilot을 한 번에 설치해 주세요. 설치기가 사용 가능한 에이전트 플랫폼을 자동으로 감지합니다.
bash install.sh --addon autopilot
저장소 복제, 운영체제별 실행 명령, 플랫폼 선택, 업데이트와 문제 해결은 상세 설치 안내를 확인해 주세요.
공식 애드온
Ghost-ALICE Autopilot은 명시적으로 승인된 작업을 해당 세션의 범위와 예산 안에서 항목 단위로 이어갑니다. 설치 자체가 실행 승인을 부여하지는 않습니다. 별도 저장소인 AidALL/ghost-alice-autopilot에서 관리합니다.
운영체제별 명령, 사용자 정의 애드온, 플랫폼 선택과 제거는 설치 안내와 공식 애드온 참조를 확인해 주세요.
문서 안내
| 필요한 정보 | 안내 문서 |
|---|---|
| 전체 설치·업데이트 명령 | 설치와 업데이트 |
| 제거 범위와 정리 방식 | 제거와 정리 |
| 업데이트 실패, 병합 충돌, 재설치 복구 | 문제 해결 |
| 저장소 구조 | 저장소 구조 |
| 스킬 목록과 참조 정보 | 스킬 카탈로그 |
| 세션 처리 단계와 필수 검사 규칙 | 세션 게이트 매트릭스 |
| 설치기의 플랫폼별 호환성 기준 | 설치기 플랫폼 호환성 |
| 설계 원칙과 아키텍처 | GitHub 위키 |
| 공식 애드온 사용법 | 공식 애드온 참조 |
| 애드온 제작 방법 | 위키: 애드온 작성 |
프로젝트가 지키는 기준
- Ghost-ALICE OS는 에이전트 세션의 작업을 관리하는 운영 계층이며, 범용 운영체제는 아닙니다.
- 사용자의 의도, 작업 범위, 검증 기준, 설치 상태를 핵심 관리 대상으로 다룹니다.
- 응답 모델이 기록된 의도에서 현재 작업을 선택하고, Core가 제출 경로를 검증한 뒤 호스트 도구가 허용된 행동을 실행합니다.
- 완료 주장은 담당 검증 근거가 필요하며, 변하지 않은 유효한 근거는 원래 출처와 시각으로 재사용합니다.
- 설치기는 자신이 관리하는 파일과 설정을 추적하며, 관리 대상임을 입증할 수 없으면 삭제 범위를 넓히지 않습니다.
작업 관리 메시지의 표시 수준은 다음 명령으로 조절하실 수 있습니다.
- Claude Code에서는 작업 공간 명령인
/visibility strict|dynamic|minimal을 사용합니다. - Codex를 포함한 모든 플랫폼에서
_shared/agent_visibility_cli.py를 통해 같은 프로필 값을 확인하고 변경하실 수 있습니다. Codex에는/visibility명령이 없습니다. - 설치 시 기본값은
dynamic입니다. 초기 프로필은bash install.sh --visibility dynamic또는.\install.cmd --visibility dynamic으로 설정하실 수 있습니다.--agent-visibility도 호환성을 위한 별칭으로 유지됩니다. - 표시 수준은 사용자에게 보이는 작업 관리 메시지만 바꿉니다. 훅 실행, 엄격한 감사 로그, 작업 영향 분류인 Work-Impact Projection은 축소하지 않습니다.
전체 제거가 필요하시면 다음 명령을 사용해 주세요.
bash install.sh --uninstall
.\install.cmd --uninstall
기여와 검증
스킬, 설치기 동작, 공개 명령을 변경하기 전에는 AGENTS.md를 읽어 주세요. 새 스킬을 만들거나 기존 스킬을 수정하신 뒤에는 official-docs/derived/skill-compliance-checklist.md의 Phase 1-5를 통과해야 합니다.
공개 문서와 명령 안내의 일관성은 다음 명령으로 검증하실 수 있습니다.
python3 scripts/validate_public_surfaces.py
세션 검사 규칙 검증 명령은 저장소의 skill-catalog/session-gates.json과 사용자용 정책 안내를 함께 확인합니다.
python scripts/check_skill_gate_contract.py
설치기 호환성 검사 그룹은 다음 명령으로 조회하고 실행하실 수 있습니다.
python3 scripts/run_installer_compat_tests.py --list
python3 scripts/run_installer_compat_tests.py --group public-surface-contract
라이선스
Ghost-ALICE OS 프로젝트가 소유한 소스 코드와 문서는 Apache License, Version 2.0으로 제공됩니다. 자세한 내용은 LICENSE, NOTICE, THIRD_PARTY_NOTICES.md를 확인해 주세요.