CodeBuddy

공급업체: Tencent 설치 이름: codebuddy 상태: GA 네이티브 구성: <project>/.codebuddy/rules/apothem-rules.md

설치

apothem install --harness codebuddy --project /path/to/project

어댑터는 공유 Apothem 규칙 및 거버넌스 표면에서 프로젝트 범위 규칙 파일 하나를 작성합니다.

작성되는 파일: <project>/.codebuddy/rules/apothem-rules.md

어댑터는 Apothem의 공유 프로필을 읽고 매 apothem install 또는 apothem update 실행마다 프로젝트 규칙 파일을 렌더링합니다. CodeBuddy는 .codebuddy/rules/ 아래의 모든 *.md 파일을 선택적 YAML 프런트매터(alwaysApply, paths, enabled)가 있는 Markdown으로 읽습니다 — CodeBuddy Rules 문서 참조. Apothem의 파일은 alwaysApply: true를 담고 있으므로 거버넌스 표면이 모든 상호작용에서 적용됩니다. 공유 프로필이 진실의 원천입니다. 생성된 파일에 대한 프로젝트 로컬 편집은 다음 동기화가 Apothem 관리 콘텐츠를 교체하기 전에 백업됩니다.

호환성 참고 사항

CodeBuddy의 규칙 표면은 .codebuddy/rules/ 아래에서 프로젝트 범위로 지정됩니다. 어댑터는 운영자가 같은 디렉터리에 작성한 모든 규칙 파일과 공존하는 전용 apothem-rules.md 파일을 작성합니다. CODEBUDDY.md 프로젝트 메모리 파일과 .codebuddy/settings.json(권한, MCP)은 운영자가 소유합니다. Apothem은 이를 작성하지 않습니다. 스킬, 명령, 에이전트, 훅은 규칙 파일 내에서 규율로 참조됩니다 — CodeBuddy는 이들을 위한 어댑터 소유 파일 표면을 노출하지 않습니다. 어댑터가 의존하는 공급업체 표면 규약은 src/apothem/harnesses/codebuddy/STANDARD-CONVENTION-PIN.md에 고정되어 있으며, 라이브 CodeBuddy 문서에 대해 스냅샷됩니다.

검증

apothem verify --harness codebuddy --project /path/to/project

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

네이티브 구성이 예상 경로에 존재합니다.
관리 규칙 파일이 존재하고 비어 있지 않습니다.
어댑터별 검증 루틴이 성공을 보고합니다.

업데이트

apothem update --harness codebuddy --project /path/to/project

현재 공유 프로필 상태에서 프로젝트 규칙 파일을 다시 도출합니다. install과 update는 멱등적입니다 — 다시 실행하면 관리 파일이 최신 렌더링된 콘텐츠로 덮어쓰입니다.

제거

apothem uninstall --harness codebuddy --project /path/to/project

어댑터가 작성한 네이티브 구성 파일을 제거하고, 관리 규칙 파일을 타임스탬프가 붙은 백업으로 이름을 변경합니다. 공유 프로필 YAML과 Apothem 엔진은 영향을 받지 않습니다.

적합성 게이트

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

문제 해결

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

구성 노브

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