Skip to content
Apothem
하니스 어댑터

Antigravity

Antigravity(미리 보기)용 Apothem 하니스 어댑터.

벤더: Antigravity 설치 이름: antigravity 상태: 미리 보기 네이티브 구성: ~/.gemini/GEMINI.md 및 ~/.gemini/antigravity-cli/plugins/apothem/

설치

apothem install --harness antigravity

어댑터는 공유 프로필을 ~/.gemini/GEMINI.md로 렌더링하고 Apothem 지원 코호트를 Antigravity CLI 플러그인으로 설치합니다.

작성되는 파일: ~/.gemini/GEMINI.md, ~/.gemini/antigravity-cli/plugins/apothem/plugin.json, ~/.gemini/antigravity-cli/plugins/apothem/skills/, ~/.gemini/antigravity-cli/plugins/apothem/rules/, 플러그인 내부의 변환된 로컬 도우미 정의, ~/.gemini/antigravity-cli/plugins/apothem/.apothem/support/templates/, ~/.gemini/antigravity-cli/plugins/apothem/.apothem/support/hooks/.

~/.gemini/GEMINI.md의 Apothem 블록은 Apothem 지원 파일 섹션으로 끝나며, 이 섹션은 저장소 스타일의 각 인용이 해석되는 기준 절대 디렉터리를 명시합니다. rules/<name>.md는 플러그인의 rules/ 아래, templates/...와 hooks/...는 플러그인의 .apothem/support/ 아래입니다.

플러그인 규칙. Antigravity는 플러그인의 rules/ 디렉터리에 있는 파일 중 유효한 trigger로 시작하지 않는 파일을 모두 버리므로 (Antigravity 규칙 문서), 각 Apothem 규칙은 설치 시 변환됩니다. 항상 적용되는 규칙은 trigger: always_on을 받고, 경로로 범위가 지정된 규칙은 globs에 같은 패턴을 담은 trigger: glob을 받으며, 그 밖의 규칙은 trigger: model_decision을 받습니다. 모든 규칙은 자신의 description을 유지합니다. 다섯 개의 규칙이 항상 적용됩니다: agnostic-posture, authority-inquiry, session-closure, context-management, 그리고 다른 모든 규칙과 그 규칙을 언제 읽어야 하는지를 명시하는 규칙 색인 apothem-rule-index. 나머지 규칙은 trigger: glob을 담습니다. Antigravity는 상시 적용 규칙 전체에 걸쳐 20,000토큰 예산 하나를 공유하며, 이 예산을 넘으면 가장 큰 규칙을 필요할 때 불러오는 포인터로 바꿉니다. 다섯 개의 규칙은 약 11,000토큰이므로 어느 것도 포인터로 바뀌지 않습니다.

플러그인 매니페스트. plugin.json은 Antigravity의 플러그인 스키마가 허용하는 두 키인 name과 description만 담습니다.

플러그인 도우미. 플러그인의 agents/ 디렉터리에 있는 도우미 정의는 name과 description을 담습니다. Antigravity의 tools 목록은 자체 도구 이름을 사용하며, 문서는 알 수 없는 이름이 서브에이전트를 멈추게 할 수 있다고 경고합니다. 그래서 도구 목록은 내보내지 않으며, 도우미는 부모의 도구를 상속합니다. Antigravity에는 읽기 전용 제한을 강제하는 장치가 없으므로, 해당 도우미의 설명에서는 "읽기 전용" 레이블이 빠집니다.

공유 사용자 앵커. ~/.gemini/GEMINI.md는 Gemini 계열 도구의 사용자 범위 앵커이기도 합니다. Antigravity 어댑터는 추가 Apothem 자료를 ~/.gemini/antigravity-cli/plugins/ 아래의 apothem 플러그인 안에 두므로 일반 Gemini CLI 프로젝트 디렉터리를 점유하지 않습니다. 둘 이상의 도구가 ~/.gemini/GEMINI.md를 로드하므로, 그곳의 Apothem 블록은 어느 한 도구도 독자로 지칭하지 않는 전역 지침으로 작성됩니다.

프로필-네이티브 구성 매핑

어댑터는 apothem install 또는 apothem update를 실행할 때마다 Apothem의 공유 프로필을 읽고 지침 앵커와 지원 코호트를 렌더링합니다.

호환성 참고 사항

미리 보기 어댑터입니다. GEMINI.md 앵커는 활성 지침 콘텐츠입니다. Antigravity 플러그인은 변환된 커맨드 스킬, 재사용 가능한 스킬, 로컬 도우미 정의, 규칙, 템플릿, 훅 지원 자료를 명확한 Apothem 소유 네임스페이스에 보존합니다. 어댑터가 Antigravity hooks.json에 대한 스키마 변환 계층을 갖추기 전까지 훅 파일은 활성 Antigravity 훅 이벤트로 등록되지 않습니다.

검증

apothem verify --harness antigravity

verify 명령은 다음을 확인합니다.

  1. 네이티브 컨텍스트 파일이 예상 경로에 존재합니다.
  2. 플러그인 매니페스트 plugin.json이 존재하고, 비어 있지 않으며, JSON으로 파싱됩니다. 검증은 플러그인 이름을 확인하지 않으므로, 이름을 바꾼 뒤에는 그 필드를 직접 확인하세요.

업데이트

apothem update --harness antigravity

현재 공유 프로필 상태에서 네이티브 구성을 다시 도출합니다. ~/.config/apothem/profile.yaml을 편집하거나 설치된 Apothem 패키지를 업그레이드한 후에 실행하세요.

제거

apothem uninstall --harness antigravity

~/.gemini/GEMINI.md에서 Apothem 블록을 제거하고, 그 안의 나머지 텍스트는 그대로 둡니다. 파일은 그 안에 다른 내용이 하나도 남지 않은 경우에만 삭제됩니다. 또한 플러그인 폴더 ~/.gemini/antigravity-cli/plugins/apothem/의 plugin.json에서 Apothem의 키를 제거하고 사용자가 추가한 키는 그대로 두며, 그 폴더의 하위 폴더인 skills/, rules/, agents/, .apothem/support/에 있는 Apothem 파일을 제거합니다. 그곳의 다른 파일은 그대로 남습니다. 각 파일은 변경 또는 제거되기 전에 ~/.apothem/backups/ 아래에 백업됩니다. 공유 프로필 YAML과 Apothem 엔진은 영향을 받지 않습니다.

적합성 게이트

python -m apothem.conformity.gate --all .

문제 해결

증상해결 방법
구성 파일을 찾을 수 없음apothem install --harness antigravity를 다시 실행
검증 실패apothem update --harness antigravity를 실행한 후 다시 검증
예기치 않은 구성 내용~/.config/apothem/profile.yaml 또는 --profile PATH를 확인한 후 apothem update --harness antigravity를 다시 실행

구성 노브

플래그기본값설명
--dry-runfalse파일을 작성하지 않고 설치를 미리 봅니다.

함께 보기

On this page