비교
Apothem 대 수동 Zed 구성
Zed의 평면 .rules 지시 파일을 손으로 유지하는 것과 Apothem의 공유 프로필에서 렌더링하는 것의 비교.
Zed는 프로젝트 루트에 있는 단일 평면 .rules 파일에서 에이전트 지시를
읽습니다(AGENTS.md / CLAUDE.md 계열 옆에). Apothem의 zed 어댑터는 그 파일을
공유 프로필에서 렌더링합니다. 이 페이지는 그 구성을 손으로 유지하는 것과
Apothem으로 관리하는 것을 대비합니다.
노력 비교
| 작업 | 수동 구성 | Apothem 관리 |
|---|---|---|
| 지침 작성 | .rules 파일을 직접 작성 | 공유 코퍼스에서 렌더링 |
기존 .rules 보존 | 직접 따로 복사해 두어야 함을 기억해 둠 | 어댑터가 교체 전에 기존 파일을 백업 |
| 다른 하니스와 규칙을 일치 상태로 유지 | 수동, 도구별 | apothem update 시 자동 |
| 재사용 가능한 스킬과 커맨드 공유 | 각 스킬 폴더를 ~/.agents/skills/에 직접 복사하고 사본을 최신 상태로 유지 | 어댑터가 ~/.agents/skills/에 모든 프로젝트용 사본 하나로 작성하고, apothem update 시 갱신 |
| 구성이 올바른지 검증 | 수동 검사 | apothem verify --harness zed --project <path> |
Apothem이 관리하는 것
zed 어댑터는 공유 규칙을 프로젝트 루트의 평면 .rules 파일로 렌더링합니다. Zed에는
PreToolUse 훅이 없으므로 가드레일 의도는 도구 호출 가로채기 지점이 아니라 규칙 본문
안에 존재합니다. 전역 ~/.config/zed/AGENTS.md 지시 파일과 .zed/settings.json의
MCP 컨텍스트 서버 블록은 운영자 소유이며 손대지 않습니다. 공유 규칙에 대한 모든
변경은 다음 apothem update 시 파일을 다시 렌더링합니다.
마이그레이션 경로
- 아직 공유 프로필을 만들지 않았다면
apothem profile init을 실행합니다. - 기존
.rules의 지침(그리고 공유하려는 프로젝트별AGENTS.md내용이 있다면)을 공유 코퍼스로 옮깁니다. apothem install --harness zed --project <path>를 실행해.rules파일을 렌더링합니다. 기존.rules는 먼저 백업됩니다.apothem verify --harness zed --project <path>를 실행해 구성이 반영되었는지 확인합니다.- 이후의 모든 변경에는
apothem update --harness zed --project <path>를 사용합니다.