Ghost-ALICE OS

Repository Structure

언어: 🇺🇸 English 🇰🇷 한국어

이 문서는 root README에서 분리된 repository map이다. README는 간결한 public entry point로 유지하고, 이 page가 상세 구조를 담는다.

Contents

Top-Level Documents

Path Role
README.md 간결한 public entry point와 documentation hub
README_ko.md Korean paired public entry point
AGENTS.md project rules와 runtime gate SSOT
CLAUDE.md Claude Code project rule entrypoint
docs/index.html GitHub Pages homepage

Installer And Platforms

Path Role
install.sh macOS, Linux, WSL, Git Bash installer entrypoint
install.ps1 Windows PowerShell installer entrypoint
install.cmd Windows CMD wrapper
platforms/codex/ Codex bootstrap source
hooks/ repository hook-related files

installer 전체 architecture는 installer architecture를 본다.

Shared Utilities

Path Role
_shared/ installers와 skills가 공유하는 helpers
_shared/secrets/ external credential lookup helpers
_shared/mcp/ MCP installation helpers
scripts/ catalog, validation, installer compatibility, public surface verification scripts

Core Governance And Runtime Gates

Path Role
session-intent-analyzer/ session-intent-analyzer intent state producer의 canonical path
task-router/ capability routing을 도출하는 internal core gate
boundary-contract/ work boundary contract gate
coding-convention/ development workflow family
skill-catalog/ runtime에서 사용하는 generated gate metadata

Official Docs And Policies

Path Role
official-docs/derived/ Ghost-ALICE analysis, philosophy, compliance, closed-loop SSOT
docs/policies/ runtime, platform, evaluator policy documents
docs/ko/policies/ Korean counterparts for policy documents
docs/plans/ public roadmap policy and planning boundaries
docs/ko/plans/ Korean counterparts for planning documents

Installed Runtime State

다음 path는 repository 밖의 user home directory 아래에 있다.

Path Role
~/.ghost-alice/install-state/ platform install-state manifests
~/.ghost-alice/pending-merges/ user-modified installed files를 위한 protected queue
~/.ghost-alice/uninstall-reports/ uninstall reports
~/.ghost-alice/secrets.env standard credential helper storage
~/.agents/skills/ Codex user skill copy install target
~/.claude/skills/ Claude Code skill install target

Documentation Responsibility