비교
Apothem 대 수동 Gemini CLI 구성
Gemini CLI의 GEMINI.md 규칙 파일을 수작업으로 유지 관리하는 것과 Apothem의 공유 프로필에서 렌더링하는 것의 비교.
Gemini CLI는 단일 GEMINI.md 규칙 파일을 읽습니다. Apothem의 gemini-cli 어댑터는
그것을 공유 프로필에서 렌더링합니다. 이 페이지는 그 구성을 수작업으로 유지 관리하는
것과 Apothem으로 관리하는 것을 대비합니다.
노력 비교
| 태스크 | 수동 구성 | Apothem 관리 |
|---|---|---|
| 규칙 작성 | 하나의 GEMINI.md를 수작업으로 편집 | 렌더링됨: 공유 규칙을 GEMINI.md에 임베드 |
| 다른 환경과 규칙을 정렬 상태로 유지 | 수작업, 도구별 | apothem update 시 자동 |
| 구성 설치 / 제거 | GEMINI.md를 수작업으로 작성·삭제 | apothem install / apothem uninstall |
| 구성이 올바른지 검증 | 수작업 점검 | apothem verify --harness gemini-cli |
Apothem이 관리하는 것
gemini-cli 어댑터는 공유 규칙을 단일 GEMINI.md에 임베드합니다. Gemini CLI에는
PreToolUse 훅이 없으므로, 가드레일 의도는 도구 호출 가로채기 지점이 아니라 규칙의
문장으로 표현됩니다. 공유 규칙에 대한 모든 변경은 다음 apothem update 시
GEMINI.md를 다시 렌더링합니다.
마이그레이션 경로
- 아직 공유 프로필을 만들지 않았다면
apothem profile init을 실행해 생성하세요. - 기존
GEMINI.md의 규칙을 공유 코퍼스로 옮기세요. apothem install --harness gemini-cli를 실행해GEMINI.md를 렌더링하고 작성하세요.apothem verify --harness gemini-cli를 실행해 구성이 안착했는지 확인하세요.- 이후의 모든 변경에는
apothem update --harness gemini-cli를 사용하세요.