GAIA Code
버전: 3.4 저장소: alexey-max-fedorov/gaia-ai
GAIA Code는 Claude Code에서 영감을 받은 Perplexity Spaces용 프롬프트 시스템입니다. 이 시스템은 지속적인 메모리, 플랜 엔진, 컨텍스트 예산이 책정된 턴(turn), GitHub MCP 통합, 그리고 슬래시 명령어 스킬 엔진을 Perplexity 대화에 구현합니다.
설정 방법 (Setup)
- 새로운 Perplexity Space를 생성합니다.
prompts/SYSTEM_INSTRUCTIONS.md의 전체 내용을 Space Instructions 필드에 붙여넣습니다. 이것은 전체 프롬프트가 아닌 짧은 게이트/라우터 역할을 합니다.
- 다음 세 파일을 Space Files로 업로드합니다:
prompts/SYSTEM_PROMPT.md — 동작(behavior)
prompts/MEMORY_ENGINE.md — 메모리 + 플래닝
prompts/TURN_ENGINE.md — 턴 + 컨텍스트 예산
- Space 모델을 설정합니다 (GLM-5.2 또는 Claude Sonnet 5.0 Thinking 권장).
- (선택 사항) Perplexity Connectors를 통해 GitHub에 연결하여 GAIA가 사용자의 저장소를 읽고 쓸 수 있도록 합니다.
- 완료 — GAIA Code를 사용할 준비가 되었습니다.
GAIA는 시작 시 업로드된 세 파일을 모두 읽습니다. 그중 어느 하나라도 건너뛰면 해당 엔진이 비활성화됩니다. 웹사이트의 Get Started 페이지에서는 각 파일에 대한 복사/다운로드 버튼과 함께 이 단계를 반영하고 있습니다.
포함된 내용 (What's Included)
GAIA Code는 네 개의 프롬프트 파일로 구성되어 있으며, 네 가지 엔진을 구동합니다.
prompts/SYSTEM_INSTRUCTIONS.md — 게이트(the gate)
Space Instructions 필드에 붙여넣습니다. GAIA를 활성화(USE_GAIA_AGENT=1)하고, 다른 세 파일을 지정하며, 스킬 엔진을 호스팅합니다.
prompts/SYSTEM_PROMPT.md — 동작(behavior)
정체성, 도구 철학, 의존성 및 버전 규칙 (버전은 레지스트리의 JSON API에서 고정되며, 오래된 조각이 아닙니다), 보안, 그리고 Claude Code 엔지니어링 철학을 포함합니다.
prompts/MEMORY_ENGINE.md — 메모리 + 플래닝
- 영구 메모리(Persistent memory) (
MEMORY.md) — 자동 압축에도 살아남는 기억 저장소: 프로젝트 구조, 사용자의 기록, 그리고 GAIA가 스스로 기록하는 관찰 내용까지 포함하며, 수정했던 실수들까지 반복되지 않도록 기록합니다. 리포지토리에 처음 접촉할 때 CLAUDE.md / AGENTS.md를 읽고 프로젝트의 구조와 규칙을 메모리에 심습니다.
- 계획 엔진(Plan engine) (
PLAN.md + TASKS.md) — 탐색 → 계획 → 승인 → 실행 과정을 거치며, 작업이 완료될 때마다 체크박스가 변경됩니다.
prompts/TURN_ENGINE.md — 턴 수 및 예산
컨텍스트-예산 추정 기능을 통해 턴(turn)이 창(window)을 초과하는 일이 없도록 하며, 15회의 호출 도구 예산(tool budget), 그리고 크기에 맞는 커밋 배치(commit batching)를 지원합니다.
주요 기능 요약 (Capabilities at a glance)
-
계획 모드(Plan Mode) — 코드를 작성하기 전에 명시적인 승인 게이트가 있는 구조화된 계획 수립 기능을 제공합니다.
-
GitHub MCP — 리포지토리를 읽고, 브랜치를 생성하며, 커밋을 푸시하고, PR(Pull Request)을 열고, 이슈를 관리할 수 있습니다.
-
영구 메모리(Persistent memory) — 자동 압축 및 컨텍스트 오버플로우 충돌에도 일관성을 유지하며, 대화 간에 기억을 전달하기 위해 export memory / import memory 기능을 제공합니다.
-
스킬 엔진(Skill engine) — Space 파일에서 로드되는 슬래시 명령어 스킬(예: /humanizer, 또는 최신 GAIA Code 버전을 확인하는 /update)을 지원하며, GitHub 리포지토리에서 바로 설치할 수 있습니다 (
-
prompts/update.md (/update) — 더 최신 GAIA Code 버전이 사용 가능한지 확인합니다. 이 레포의 website/package.json에서 가장 최근에 출시된 버전을 읽어와, 현재 사용 중인 Space의 버전과 비교하고, 만약 뒤처져 있다면 Get Started로 이동하여 재배포하도록 안내합니다.
-
prompts/doctor.md (/doctor) — 배포 상태를 검증합니다: 엔진 파일 존재 여부, 버전 일치성, 메모리 초기화 여부, GitHub MCP 연결 여부 등을 확인합니다. 읽기 전용입니다.
-
prompts/pr-review.md (/pr-review) — 풀 리퀘스트(pull request)를 처음부터 끝까지 검토합니다 (전체 diff, 모든 커밋). 그 결과를 GitHub MCP를 통해 PR 리뷰로 게시합니다.
website/
gaiacode.pro에 있는 Next.js 마케팅 사이트입니다.
버전 관리 (Versioning)
| Version | Date | Notes |
|---|
| 1.0 | March 2026 | 초기 출시 (Initial release) |
| ... | | |
GAIA 이름은 Horizon Zero Dawn / Horizon Forbidden West에서 영감을 받았습니다.