용어집
Apothem 용어집 — 핵심 용어와 개념.
Apothem의 문서, 코드, 거버넌스 전반에서 사용되는 핵심 용어를 알파벳순으로 정리했습니다.
어댑터
공유 프로필을 하니스별 구성 형식으로 변환하는 HarnessAdapter 프로토콜을 구현하는 클래스입니다. 어댑터는 src/apothem/harnesses/<name>/ 아래에 하나의 서브패키지당 하나씩 존재합니다. 하니스 어댑터 추상화를 참조하세요.
감사 검토 시퀀스
코드, 코드 리뷰, 보안, 성능, 아키텍처, UX, 접근성, 문서, 종속성, 공급망, 위협 모델을 다루는 11개 명령 감사 스위프입니다. /fortress 강화 파이프라인이 구동합니다. 감사 검토 시퀀스를 참조하세요.
동작 diff 골든
tests/fixtures/behavior-diff/에 커밋된 스냅샷으로, 결정적 설치 및 CLI 오라클을 바이트 단위로 비교하는 대상입니다. 그리하여 설치 계획, 렌더링된 코호트, 또는 CLI 출력에 대한 의도치 않은 변경이 조용히 배포되지 않고 드리프트로 잡힙니다. 이 비교는 플랫폼마다 다른 바이트를 정규화하여 코퍼스가 운영 체제 전반에서 이식 가능한 상태로 유지되도록 합니다.
코호트
하나의 종류로 묶인 동기화 아티팩트 집합 — 규칙, 커맨드, 스킬, 에이전트, 훅, 출력 스타일, 스키마, 또는 템플릿 — 으로, 엔진이 하나의 공유 프로필에서 각 하니스로 머티리얼라이즈합니다. 하나의 프로필이 모든 코호트를 지니며, 각 어댑터가 이를 자신의 하니스 네이티브 표면으로 투영합니다.
적합성 게이트
15개 막대 사전 방출 게이트의 기계적 부분 — src/apothem/conformity/gate.py에 있는 기계 검사 가능한 검증기들입니다. 모든 아티팩트 방출 전에 실행됩니다. 추론 기반 막대는 검토 단계에서 평가됩니다.
진입점
pyproject.toml에 선언된 apothem.harnesses setuptools 진입점 그룹입니다. 하니스 레지스트리를 정확히 반영합니다. 테스트가 선언된 진입점이 등록된 어댑터와 동일함을 단언하므로, 규약상 올바르지만 등록되지 않은 어댑터는 커버리지 회귀로 드러납니다.
하니스
Apothem이 전용 어댑터를 통해 지원하는 어시스턴트 플랫폼입니다. 지원 플랫폼:
Antigravity
Claude Code
CodeBuddy
Codex
Cursor
Gemini CLI
GitHub Copilot
GLM (Z.ai)
Hermes
Kimi Code
Kiro
Open-Claw
OpenCode
Qwen Code
Trae
Windsurf
Zed하니스를 참조하세요.
하니스 레지스트리
src/apothem/lib/harness_registry.py(데이터는 harness_registry_data.py에 있음)에 있는 카탈로그로, 모든 어댑터를 나열하며 런타임에 권위를 가집니다 — 엔진이 여기서 모든 어댑터를 해석하므로 평범한 체크아웃에서 로드됩니다. src/apothem/harnesses/ 아래의 파일 시스템 규약 디스커버리는 런타임 해석기가 아니라 규약 패리티 점검입니다.
훅
하니스 라이프사이클 이벤트(PreToolUse, PostToolUse, SessionStart, Stop)에 등록된 명령입니다. 네이티브 등록 표면은 하니스마다 다릅니다 — 설정 파일, 전용 훅 매니페스트, 또는 하니스가 네이티브 훅 표면을 노출하지 않는 경우 지침 앵커에서 참조되는 Apothem 지원 자료입니다. 훅 스크립트와 그 메시지 컨텍스트는 src/apothem/hooks/ 아래에 있습니다.
머티리얼라이저
어댑터의 선택적 materialize_native_config(profile) -> str으로, 구성이 하나의 구조화된 표면(예: JSON 또는 YAML 설정 파일)인 하니스를 위해 공유 프로필로부터 단일 파일 네이티브 구성을 렌더링합니다. 템플릿 전파 어댑터는 머티리얼라이저를 생략하고 대신 전파 매니페스트에 따라 코호트를 복사하거나 변환합니다.
출력 스타일
output-styles/ 아래의 Markdown 정의로, 어시스턴트의 응답 형식과 어조를 형성합니다(예: 간결한 엔지니어 또는 포렌식 감사자 스타일). 어댑터가 설치하는 동기화 코호트 중 하나입니다.
플랜 스위트
/plan-generate로 생성되고 /plan-execute로 실행되는, 계획 아티팩트(PREAMBLE.md, MASTER-PLAN.md, PROGRESS.md, PLAN-NOTES.md, 단계별 PHASE.md 파일)의 구조화된 모음으로, 프로젝트 로컬 .apothem/plans/ 디렉터리 아래에 있습니다(레거시 .plans/ 트리는 apothem migrate-workspace를 통해 업그레이드됩니다).
사전 방출 게이트
아티팩트가 방출되거나 단계 출력이 완료된 것으로 간주되기 전에 기록되는 15개 막대 서명 블록입니다. 기계적 막대는 적합성 게이트로 실행되며, 추론 기반 막대는 검토 단계에서 평가됩니다. 사전 방출 게이트를 참조하세요.
전파 매니페스트
src/apothem/lib/propagation-manifest.yaml — 템플릿 전파 어댑터별로 어떤 코호트를 설치하는지, 그리고 하니스 네이티브 형식 변환(예: 커맨드를 하니스의 TOML 형식으로 변환)을 선언합니다.
릴리스 준비 게이트
세 가지 수렴 게이트: 로컬 적합성, 지속적 통합, 감사 검토 시퀀스입니다. 릴리스는 관련 게이트가 통과한 후에만 진행됩니다.
자체 완결형 런타임
Apothem은 런타임 Python 종속성(예: pyyaml과 jsonschema)을 src/apothem/_vendor/ 아래에 벤더링하므로, 엔진이 평범한 체크아웃에서 실행됩니다. 오직 click과 rich만 설치 시점에 해석됩니다. 자체 완결형 런타임을 참조하세요.
심각도 등급
어떤 품질 관리가 적용되는지를 결정하는 네 가지 거버넌스 수준(EXPLORING, PERSONAL_USE, SHARED, PUBLIC_LAUNCH) 중 하나입니다. 심각도 등급을 참조하세요.
공유 프로필
~/.config/apothem/profile.yaml 또는 --profile PATH에 있는 스키마 검증된 YAML 파일입니다. 하니스 어댑터는 이를 패키지된 Apothem 코호트와 결합하여 지원되는 각 하니스에 대한 네이티브 구성을 도출합니다.
STANDARD-CONVENTION-PIN
어댑터별 STANDARD-CONVENTION-PIN.md로, 어댑터의 규약이 고정되는 벤더 문서 URL, 커밋 SHA, 스냅샷 날짜, 그리고 정식 파일명과 스키마를 기록합니다. 어댑터가 대상으로 하는 벤더 표면에서 조용히 드리프트하지 않도록 일정 주기로 재검증됩니다.
지원 하위 트리
하니스가 네이티브 프리미티브를 갖추지 못한 코호트(규칙, 훅, 스킬, 또는 에이전트)를 위해 하니스 설치가 사용하는 Apothem 소유 디렉터리입니다. 벤더 예약 디렉터리에 억지로 넣지 않고 하니스의 네이티브 지침 앵커에서 참조됩니다.