아티팩트 레지스트리

아티팩트 코호트의 정규 레지스트리. 이 문서는 명령어, 규칙, 위임 워커, 훅, 스킬, 출력 스타일, 아티팩트 진화 규율, 빈 아티팩트 클래스 선언의 완전한 열거를 담고 있습니다. 실질적인 테이블은 여기에 존재합니다. 프로젝트 소스 레이아웃이 압축된 상시 로드 뷰를 제공합니다.

1. 명령어

src/apothem/commands/*.md(비재귀적)에서 30개의 명령어가 등록됩니다. 모든 명령어는 일급의 등록된 파일입니다. /plan 오케스트레이터는 이미 일급인 플랜 스테이지를 연결할 뿐 자체 스테이지 로직을 지니지 않으므로, 여전히 모놀리식 디스패처도 서브명령어 그룹화도 없습니다. 비-플랜, 비-워크플로 명령어:

플랜 파이프라인 명령어

플랜 파이프라인은 여덟 개의 일급 명령어로 출하됩니다 — 스테이지당 하나씩으로, 각각 src/apothem/commands/plan-<stage>.md의 자체 등록된 파일에서 /plan-<stage>로 직접 호출할 수 있습니다.

오퍼레이터 워크플로 & 오케스트레이터 명령어

세 개의 명령어는 자체 스테이지 로직을 지니는 대신 깊은 프로시저로 진입합니다: 두 개의 오퍼레이터 워크플로 진입점(각각 같은 이름의 형제 스킬에 의해 뒷받침됨)에 더해 얇은 플랜 파이프라인 오케스트레이터.

2. 규칙

동작 규칙은 src/apothem/rules/ 아래에 존재합니다 — 작은 상시 로드 코어에 더해 더 큰 경로 필터링 세트(일치하는 아티팩트를 건드릴 때 온디맨드로 로드됨). 규칙별 완전한 열거 — Scope(상시 로드/경로 필터링)와 Implements 열 포함 — 는 레퍼런스 인벤토리 생성기가 src/apothem/rules/*.md에서 갱신하는 소스 생성 reference/rules.mdx입니다. 권위 있는 현행 목록은 이를 참조하십시오.

CM-21 패싯 구분(세 규칙이 서로 겹치지 않는 패싯으로 CM-21을 공동 구현): 창의적 필터 & 인지적 정체성 → cognitive-identity.md; 생성 방법론(작성 & 재작성 프로토콜) → clean-room-generation.md; 계획/리뷰 기법 → planning-techniques.md. 각 규칙은 자신의 패싯을 소유하고, 다른 규칙은 외부를 참조합니다.

Interactive-questions 스키마 포인터. 구조화 질의의 정규 호출 스키마 — 필수 필드, 필드 요약 테이블, 두 개의 실행 가능한 작업 예시(§2.1의 단일 선택과 §2.2의 다중 선택) — 는 src/apothem/rules/interactive-questions.md §2 "Structured-Inquiry Shape"에 존재합니다. 하류 아티팩트는 §2.1 또는 §2.2를 호출 템플릿으로 복사할 수 있습니다. 각 옵션의 description 본문이 담는 3-세그먼트 옵션 주석 스키마는 동일 파일의 §3에 명시되어 있습니다.

3. 헬퍼

열두 개의 영속적 헬퍼 정의가 생태계와 함께 출하됩니다. 오케스트레이션 규칙의 팀 패턴이 이들에게 디스패치합니다. 각 정의는 아래에 나열된 파일 경로에 존재합니다.

Worker              File                                       Pattern         Model Policy
------------------- ------------------------------------------ --------------- -------------
Codebase Explorer   src/apothem/agents/codebase-explorer.md   Research        host-selected
Convention Auditor  src/apothem/agents/convention-auditor.md  Audit           host-selected
Dependency Auditor  src/apothem/agents/dependency-auditor.md  Audit           host-selected
Fact Checker        src/apothem/agents/fact-checker.md        Audit           host-selected
MCP Builder         src/apothem/agents/mcp-builder.md         Generation      host-selected
Memory Auditor      src/apothem/agents/memory-auditor.md      Audit           host-selected
Prompt Evaluator    src/apothem/agents/prompt-evaluator.md    Quality         host-selected
Quality Gate        src/apothem/agents/quality-gate.md        Quality         host-selected
Refactor Surgeon    src/apothem/agents/refactor-surgeon.md    Implementation  host-selected
Research Scout      src/apothem/agents/research-scout.md      Research        host-selected
Security Scanner    src/apothem/agents/security-scanner.md    Audit           host-selected
Test Runner         src/apothem/agents/test-runner.md         Quality         host-selected

4. 훅

등록된 모든 훅 명령어는 Claude Code의 exec 형식 명령어 형태 (command: "python"에 args 배열 추가)를 사용하며, -m apothem.hooks.dispatch 또는 -m apothem.conformity.gate 중 하나를 호출합니다. 디스패처는 생태계 루트 해석을 위해 src/apothem/hooks/lib/resolve_root.py를 임포트하고, 그것과 나란히 src/apothem/hooks/ 자체 아래에 있는 두 헬퍼에 위임합니다: src/apothem/hooks/emit_hook_context.py는 어시스턴트를 위해 이벤트 페이로드를 포맷하고, src/apothem/hooks/session_start_bootstrap.py는 디스패처가 해당 이벤트를 라우팅할 때 넘기는 SessionStart 준비 작업을 담당합니다. 지원되는 이벤트가 발화될 때 어시스턴트에게 표시되는 훅 메시지는 src/apothem/hooks/messages/ 아래에 Markdown 컨텍스트 파일로 존재합니다 — 이벤트 변형마다 하나씩: postcompact.md, precompact.md, pretooluse-bash.md, pretooluse-bash-plan-guard.md, pretooluse-conformity.md, pretooluse-dependency-guard.md, pretooluse-edit.md, pretooluse-edit-header-guard.md, pretooluse-eval-guard.md, pretooluse-notebookedit.md, pretooluse-write.md, pretooluse-write-header-guard.md, pretooluse-write-plan-guard.md, sessionstart.md, stop.md. 각 라우팅된 컨텍스트 파일은 해당 이벤트가 발화되고 그 컨텍스트 인자가 settings.json에 등록되어 있을 때 디스패처에 의해 로드됩니다. 세 컨텍스트 파일 (pretooluse-conformity.md, pretooluse-dependency-guard.md, pretooluse-eval-guard.md)은 현재 settings.json 라우팅 엔트리 없이 가용한 변형으로 출하됩니다.

Event             Automates                Timeout  Purpose
----------------- ------------------------ -------- --------------------------------------------------
SessionStart      CM-14                    30s      Read memory, check plan state, report readiness
PreCompact        CM-24 §2.3               30s      Verify state externalized before compaction
PostCompact       CM-24 §6.2               30s      Restore working state after compaction
Stop              CM-14/CM-22/CM-24/CM-26  60s      Session-end externalization
PreToolUse        CM-7/CM-22               10s      Write/Edit/NotebookEdit validation — codebase-isolation, frontmatter, license-header, and plans-locality checks plus the conformity gate. Bash validation — git artifact isolation and plans-locality
PostToolUse       —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
UserPromptSubmit  —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
Notification      —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event

규약. Automates가 —인 행은 dispatch.py에 의해 수락되지만 settings.json에 배선되지 않습니다. Timeout 열은 이벤트가 나중에 배선될 경우 적용되는 디스패치 수준의 기본값을 보여줍니다.

Timeout 값 정규 블록. 이 테이블의 Timeout 열은 생태계 전반에 걸친 훅 Timeout 값의 단일 진실 공급원입니다. settings.json의 훅별 timeout 필드, site/content/docs/reference/settings-reference.mdx § Hook Events와 site/content/docs/reference/artifact-schema.mdx § Hooks Pipeline의 미러 테이블, 그리고 src/apothem/rules/persistent-conventions-vigilance.md § Convention Awareness의 규칙 가이던스는 모두 이 열에서 도출됩니다. 향후 Timeout 개정은 여기에 착지하고, 소비자는 다음 참조 시 재도출합니다.

설정 템플릿 리뷰 주기

settings.json은 유일한 Claude Code 템플릿입니다. 각 훅 명령어는 셸 특화 래퍼 대신 exec 형식을 사용하므로, 크로스 OS 동작은 짝지어진 템플릿을 diff하는 대신 하나의 파일 내에서 리뷰됩니다. 새로운 퍼미션 엔트리, 훅 이벤트, Timeout, 상태 메시지는 그 파일에 원자적으로 착지합니다.

5. 스킬

재사용 가능한 스킬은 src/apothem/skills/ 아래에 스킬당 한 폴더로 존재합니다.

규약. 각 행의 경로는 폴더입니다. 진입점은 그 안의 SKILL.md 파일 — 예: src/apothem/skills/plan-suite/SKILL.md — 으로, 프로젝트 소스 레이아웃에 선언된 폴더-with-SKILL.md 스킬 규약을 따릅니다.

6. 출력 스타일

네 개의 출력 스타일이 src/apothem/output-styles/ 아래에 존재합니다.

7. 아티팩트 진화

필수. 재사용 가능한 패턴, 시정, 또는 기법이 재발할 때(한 세션에서 2회 이상, 또는 메모리에 재발로 기록됨), 생태계는 진화해야 합니다. 사이클에는 네 단계가 있습니다: 어떤 상호작용 중에든 패턴을 Detect; 기존 스킬, 규칙, 명령어, 훅, 메모리를 중첩에 대해 Search; 일치하는 아티팩트를 제자리에서 진화시키거나(절차, 안티패턴, 스코프 갱신) 관심사가 진정으로 직교할 때 새로 생성함으로써 Act; 상호 참조가 여전히 해석되고 의존 아티팩트가 일관되게 유지되는지 Validate. 생성보다 정련을 우선하십시오 — 새 아티팩트는 유지보수 표면을 복리로 늘립니다. 모든 아티팩트 클래스에 걸친 갭 감지 트리거의 닫힌 카탈로그를 포함한 전체 프로토콜은 src/apothem/rules/persistent-conventions-vigilance.md §2+§4를 참조하십시오.

8. 빈 아티팩트 클래스

생태계 레지스트리에 선언되었으나 활성화 트리거가 발화될 때까지 의도적으로 비어 있는 서피스. 각 행은 예약된 서피스, 그 클래스를 발판으로 세우는 파일 또는 디렉터리, 그리고 그 행을 빈-증명에서 채워짐으로 승격시키는 트리거를 기록합니다.

빈-증명은 갭이 아니라 긍정적 선언입니다. 클래스의 발판(존재할 경우)은 활성화 순간을 추적하는 정규 no-op 아티팩트입니다. 빈-증명에서 채워짐으로의 승격은 발판의 최초 비-빈 값과 함께 관련 레지스트리 섹션에 원자적으로 착지합니다.