하니스 어댑터
Apothem 하니스 어댑터 — 하나의 공유 프로필, 열일곱 개의 지원 대상.
Apothem은 열일곱 개의 내장 하니스 어댑터를 제공합니다. 각 어댑터는 동일한 공유 코호트를, 플랫폼이 지원하는 경우 플랫폼 네이티브 파일로, 지원하지 않는 경우 Apothem 소유의 지원 하위 트리로 변환합니다.
지원되는 하니스
지원 레지스트리에는 정확히 열일곱 개의 어댑터가 포함되어 있습니다. --harness와 함께 다음의 정확한 설치 이름을 사용하거나, 결정론적 레지스트리 집합을 위해 all을 사용하세요.
antigravity
claude-code
codebuddy
codex
cursor
gemini-cli
github-copilot
glm
hermes
kimi-code
kiro
open-claw
opencode
qwen-code
trae
windsurf
zed상세한 레지스트리 매트릭스, 대상 경로, 기능 상태, MCP 지원, 규칙-고정 증거는 기술 레지스트리 참조에 있습니다.
여러 하니스 설치
하나의 하니스를 설치하거나, 결정론적 순서로 레지스트리를 선택하려면 all을 사용하세요. 프로젝트 범위 하니스에는 --project PATH가 필요합니다. 레지스트리에는 사용자 범위와 프로젝트 범위 대상이 모두 포함되어 있으므로 all도 여기에 해당합니다.
apothem install --harness claude-code
apothem install --harness cursor --project /path/to/project
apothem install --harness gemini-cli --project /path/to/project
apothem install --harness all --project /path/to/project설치 검증
각 하니스 어댑터를 개별적으로 검증하거나, 등록된 모든 어댑터에 걸친 어댑터별 설치 상태 요약을 보려면 apothem doctor를 호출하세요.
apothem verify --harness claude-code
apothem verify --harness all --project /path/to/project
apothem doctor어댑터 작동 방식
각 어댑터는 setuptools 진입점을 통해 등록된 HarnessAdapter 프로토콜을 구현합니다. 설치 시 CLI는 공유 YAML 프로필을 로드하고 검증하며, 레지스트리를 통해 어댑터를 해석하고, 머티리얼라이즈 계획을 검증한 다음, 플랫폼 네이티브 구성을 하니스의 네이티브 사용자 또는 프로젝트 위치에 작성합니다. 업데이트 시에는 현재 프로필 상태에서 다시 도출합니다.
profile.yaml + packaged cohorts
identity / preferences / rules
commands / skills / delegated definitions / hooks / templates
|
+-- antigravity --> ~/.gemini/GEMINI.md + ~/.gemini/antigravity-cli/plugins/apothem/
+-- claude-code --> ~/.claude/ native folders + ~/.claude/.apothem/support/
+-- codex --> ~/.codex/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
+-- cursor --> <project>/.cursor/rules/*.mdc + <project>/.cursor/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
+-- gemini-cli --> <project>/GEMINI.md + <project>/.gemini/
+-- github-copilot --> <project>/.github/copilot-instructions.md + <project>/.github/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
+-- windsurf --> <project>/.devin/rules/ + <project>/.devin/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
+-- ...사용자 홈의 스킬
일곱 개의 프로젝트 범위 어댑터는 프로젝트에 규칙 파일 하나를 작성하며(그중 여섯은 Apothem의 도우미도 서브에이전트 파일로 그곳에 작성합니다. 각 하니스 페이지가 그 폴더를 명시합니다), Apothem의 스킬과 그 스킬이 인용하는 규칙 및 템플릿도 사용자 홈의 폴더에 작성합니다.
cursor, github-copilot, windsurf, zed -> ~/.agents/skills/ (codex writes it too)
codebuddy -> ~/.codebuddy/skills/
kiro -> ~/.kiro/skills/
trae -> ~/.trae/skills/
all seven -> ~/.config/apothem/rules/ and templates/ (codex uses them too)- 폴더를 지정하는 모든 설치는 같은 파일을 작성하므로, 설치 순서는 중요하지 않으며 하나의 사본이 모든 프로젝트에 쓰입니다.
- 설치는 홈 폴더를 먼저 작성합니다. 이 작업이 실패하면 프로젝트를 변경하기 전에 중단하며, 저장소에 스킬 파일이나 규칙 파일을 추가하지 않습니다.
- 제거는 다른 Apothem 설치가 더 이상 사용하지 않을 때만 공유 폴더를 제거하며, 어느 설치가 그 폴더를 유지하는지 알려 줍니다.
- Apothem 스킬의 이름을 가졌지만 Apothem이 작성하지 않은 스킬 폴더는 경고와 함께 그대로 둡니다.
각 하니스 페이지는 자신의 폴더를 나열합니다. 하니스 레지스트리는 어떤 도구가 어떤 폴더를 공유하는지 보여 줍니다.
프로토콜 명세는 하니스 어댑터 추상화를 참조하세요.