doc HAN-299 검토 완료 (2026-05-22 사용자 피드백 반영) 2026-05-22

운영 요소 인벤토리

목적: 판테온/업무 체계의 각 운영 요소에 소비자와 소비 시점을 명시하고, 소비자가 없거나 불명확한 항목을 폐지/축소 후보로 분류한다.

기준일: 2026-05-22
범위: 슬래시 커맨드·에이전트·기록/저장소·Slack·자율 파이프라인·검증 루틴

판단 기호 - 🟢 유지: 명확한 소비자 + 정기 사용 - 🟡 축소: 소비자 있으나 범위 과잉 또는 빈도 낮음 - 🔴 폐지 후보: 소비자 없거나 다른 요소로 대체 가능 - ⚪ 보관: 일회성 사용 완료, 참조용 보존 - ❓ 검토 필요: 정보 불충분 — 사용자 확인 후 결정

A. 슬래시 커맨드 / 스킬

요소 소비자 소비 시점 없을 때 손실 판단
/spec {ISSUE} 사용자 신규 기능 구현 직전 AC 없는 구현 직행 → 테스트 기준 불명확 🟢 유지
/implement {ISSUE} 사용자 스펙 완료 후 구현 단계 수동 TDD → 테스트 누락 위험 🟢 유지
/wrap-up 사용자 (다음 세션의 Claude) 세션 종료 시 세션 간 학습 단절, 메모리 stale 누적 🟢 유지
/code-review:code-review 사용자 PR 생성 후 코드 품질 검증 없이 머지 🟢 유지
/auto-ship 사용자 PR 생성 직후 (CLAUDE.md 규칙으로 자동) 수동 리뷰→수정→머지 반복 🟢 유지
/fix-review <PR> 사용자 코드 리뷰 코멘트 수신 후 리뷰 수정 수동 처리 🟢 유지
/update-config 사용자 설정·권한 변경 필요 시 settings.json 직접 편집 🟢 유지
/loop 사용자 반복 폴링·모니터링 필요 시 수동 반복 실행 🟢 유지 (저빈도)
/schedule 사용자 CCR 루틴 생성·관리 시 원격 루틴 생성 불가 🟢 유지 (저빈도)
Notion:* (10개) 사용자, 에이전트 Notion 작업 시 MCP 직접 호출 강요 🟢 유지
/simplify 없음 — /code-review:code-review로 대체 가능, 사용 기록 없음 ⚪ 비권장 (빌트인, 폐지 불가)
/security-review 불명확 보안 민감 변경 시 보안 점검 누락 ❓ 검토 필요
/claude-api 불명확 Claude API 개발 시 API 개발 컨텍스트 부재 ❓ 검토 필요
/init 사용자 새 프로젝트 CLAUDE.md 생성 시 (1회) 수동 작성 ⚪ 보관
/fewer-permission-prompts 사용자 권한 프롬프트 반복 시 (1회) 반복 승인 클릭 ⚪ 보관
/keybindings-help 사용자 키바인딩 변경 시 (1회) 수동 JSON 편집 ⚪ 보관

주의: /simplify·/init·/security-review 등은 빌트인 스킬이라 실제 “폐지” 불가. “사용 안 함” 정책 명시가 대안.

B. 사용자 정의 에이전트

에이전트 소비자 소비 시점 없을 때 손실 판단
spec-drafter spec-reviewer (간접 위임) /spec 파이프라인 내 자동 호출 스펙 초안 자동 작성 불가 🟢 유지
spec-reviewer 사용자 /spec {ISSUE} 호출 시 spec-drafter 위임 경로 없음 🟢 유지
code-implementer 사용자 /implement {ISSUE} 호출 시 TDD 자동화 없음 🟢 유지
fix-review 사용자 /fix-review <PR> 호출 시 PR 리뷰 수정 수동 처리 🟢 유지
notion-curator 사용자, 메인 세션 Notion 저장 위치 결정 시 저장 위치를 감에 의존 🟢 유지
schedule-manager 사용자 일정 조회·추가 요청 시 Notion DB + GCal 수동 조회 🟢 유지
asurada 사용자, Jarvis 코드 작업 실시간 가이드 필요 시 가이드 없이 사용자 직접 진행 🟢 유지
pixel 불명확 IronCoach [Designer] 라벨 티켓 시 IronCoach 디자인 스펙 생성 불가 🔴 폐지 후보 (IronCoach 활성 여부 확인 필요)

C. 기록/저장소 계층

저장소 소비자 소비 시점 없을 때 손실 판단
Local memory (~/.claude/.../memory/) 매 세션 Claude 세션 시작 시 자동 로드 세션 간 컨텍스트 단절 🟢 유지
CLAUDE.md (글로벌) 매 세션 Claude 세션 시작 시 자동 로드 행동 지침·ADR 요약 없음 🟢 유지
~/.claude/notes/ Claude (온디맨드) 특정 ADR·기술 메모 참조 시 ADR 풀텍스트 분실 🟢 유지
agents/*.learnings.md 각 에이전트 에이전트 호출 시 로드 에이전트 도메인 노하우 누적 없음 🟢 유지
notes/temp_learnings.md /wrap-up 4-step wrap-up 시 처리 빌트인 에이전트 노하우 분실 🟢 유지 (wrap-up 실행 조건)
.agent/docs/{ISSUE}.md code-implementer /implement 호출 시 TDD 기준 없음 🟢 유지
.agent/drafts/{ISSUE}.md spec-reviewer 스펙 리뷰 중 임시 초안 검토 불가 🟡 축소 (리뷰 완료 즉시 삭제 규칙 강화)
hangman-docs/reports/ 사용자, Linear 링크 작업 결과·PR writeup 조회 시 모바일 결과 확인 불가 🟢 유지
hangman-docs/advisories/ 사용자 아키텍처 결정 참조 시 설계 근거 분실 🟢 유지
hangman-docs/research/ 사용자, 에이전트 코드 구조 파악 시 반복 탐색 비용 발생 🟢 유지
hangman-docs/learning/ 사용자 학습 자료 조회 시 학습 기록 분산 🟢 유지
hangman-docs/tools/ 불명확 ? (triage-board.html 위치) 용도 불명확 ❓ 검토 필요
hangman-docs/synthesis/ 불명확 ? 내용·용도 불명확 ❓ 검토 필요
.claude/reports/ (Tier 3) /wrap-up 로컬 작업 보고 시 레포트 미추적 🔴 폐지 후보 (hangman-docs/reports/ 중복 확인 필요)
Notion (4-hub) 사용자 DB 조회 시 (일정·학습·백로그) 구조화 데이터 분실 🟢 유지

D. Slack 알림/채널

요소 소비자 소비 시점 없을 때 손실 판단
#agent-approvals spec_gate 브리핑 사용자, Jarvis Urgent/High Backlog 티켓 생성 ~10분 후 자율 파이프라인 인입점 없음 🟢 유지
#pantheon-alerts 사용자 시스템 오류·경고 발생 시 이상 상황 감지 불가 🟢 유지
봇 DM (Jarvis/Asurada) 사용자 작업 위임·완료 알림 시 워크플로우 신호 단절 🟢 유지
#sessions wrap-up 알림 없음 (HAN-177로 폐지 결정됨) — 🔴 폐지 확정 (잔재 확인 필요)
#execution-agent PR 생성 알림 불명확 PR 생성 후 Linear In Review 상태로 대체 가능 🔴 폐지 후보 (최근 사용 여부 확인 후 실행)
Nano DM/멘션 없음 (HAN-176으로 폐지 결정됨) — 🔴 폐지 확정 (코드 잔재 점검 필요)

E. 자율 파이프라인 (판테온 봇)

요소 소비자 소비 시점 없을 때 손실 판단
spec_gate 스캔 루프 (600s) Jarvis, 사용자 Urgent/High Backlog 티켓 생성 후 자동 자동 발견 없음 → 수동 트리거 🟢 유지
execution_scan_loop (300s) 판테온 봇 approved 라벨 감지 후 자동 자동 구현 없음 → 수동 /spec+/implement 🟢 유지
CCR 루틴 (일회성/반복) 사용자 설정한 시간·주기 리마인드·원격 자동화 누락 🟢 유지 (현재 1개 활성)
판테온 launchd 데몬 판테온 봇 시스템 재시작 시 자동 재시작마다 봇 수동 기동 🟢 유지

F. 주기/검증 루틴

루틴 소비자 소비 시점 없을 때 손실 판단
self-review (SDD 3단계) 사용자 /implement 완료 후 직접 검토 코드·테스트 직접 검증 없음 🟢 유지
PR review (/code-review:code-review) 사용자 PR 생성 후 /auto-ship 내 코드 품질 자동 검증 없음 🟢 유지
pre-commit lint 사용자, Claude 커밋 직전 훅 자동 실행 린트 오류 포함 커밋 🟢 유지
/wrap-up 4-step 사용자 세션 종료 시 학습 누락, ADR 트리거 점검 누락 🟢 유지
ADR 정기 점검 (2026-08-04) 사용자 3개월마다 stale 규칙 누적, ADR 재고 트리거 무시 🟢 유지

폐지/축소 후보 목록

폐지 확정 (기결정 — 잔재 점검만 남음)

# 항목 근거 조치
1 Nano DM/멘션 HAN-176으로 폐지 결정됨 판테온 코드에서 Nano 멘션 잔재 점검 후 제거
2 #sessions wrap-up 알림 HAN-177로 폐지 결정됨 wrap-up 스킬 코드에서 #sessions 발송 잔재 점검 후 제거

확인 후 폐지

# 항목 확인 사항 조치
3 #execution-agent 채널 알림 최근 채널 사용자/소비 여부 확인 Linear In Review 대체 검증 후 코드 제거 + 채널 아카이브
4 pixel 에이전트 IronCoach 마지막 작업 일자 확인 3개월 이상 비활성 → pixel.md 보관 처리
5 .claude/reports/ (Tier 3) hangman-docs/reports/와 중복 여부 동일 파일 존재 시 Tier 3 레지스트리 폐지, hangman-docs 단일화

비권장 정책 명시 필요 (폐지 불가 — 빌트인 스킬)

# 항목 근거 조치
6 /simplify /code-review:code-review로 대체 가능, 사용 기록 없음 CLAUDE.md에 “사용 안 함” 한 줄 명시

추가 검토 필요

# 항목 불확실 사유 확인 방법
7 hangman-docs/tools/, synthesis/ 콘텐츠 빈약 (tools: 2개 파일, synthesis: 미사용 의심) 용도 재정의 또는 다른 디렉토리 통합
8 /security-review, /claude-api 사용 빈도 미확인 최근 3개월 사용 여부 사용자 확인

후속 티켓 후보

후속 작업이 필요한 항목만 정리.

티켓 내용 우선순위
HAN-299-F1 폐지 확정 잔재 제거: Nano 멘션 + #sessions wrap-up 알림 코드 점검·제거 Medium
HAN-299-F2 #execution-agent 채널 최근 사용 확인 → 폐지 실행 Medium
HAN-299-F3 pixel 에이전트 활성 여부 확인 → 폐지/보관 처리 Low
HAN-299-F4 .claude/reports/ Tier 3 vs hangman-docs 중복 정리 Low
HAN-299-F5 hangman-docs/tools/, synthesis/ 용도 명확화 또는 통합 Low

요약

핵심 발견: 체계 자체는 대부분 소비자가 명확하고 정상 작동 중. 폐지 대상은 소수이며, 최대 손실은 소비자 없는 Slack 채널 알림 (신호 없이 채널만 쌓임)과 미사용 에이전트·스킬 (컨텍스트 혼란 유발). 추가 비대화보다 현 체계 유지·점진적 정리가 우선.