Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
본 문서는 전문 개발 워크플로우를 위해 큐레이션된 Minoan Claude Code 설정을 소개합니다. 이 설정은 스킬, 후크(hooks), CLI 도구, 슬래시 명령어 등을 포함하며, 사용자가 체계적인 방식으로 코딩 작업을 수행할 수 있도록 돕습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기전문 개발 워크플로우를 위한 큐레이션된 ~/.claude/ 설정 — 스킬, 후크(hooks), CLI 도구, 슬래시 명령어, 그리고 MCP 서버.
claude-code-minoan/
├── skills/ # 5개 카테고리에 걸친 97개의 사용자 정의 스킬(custom skills)
│ ├── core-development/ # 아키텍처, 작업 추적, 코드 검색
...
각 폴더는 설정 지침, 예제 및 크레딧이 포함된 자체 README를 가지고 있습니다.
# 1. Clone
git clone https://github.com/tdimino/claude-code-minoan.git
cd claude-code-minoan
...
~/.claude/settings.json에서 후크를 구성하세요 — 전체 설정 블록은 hooks/README.md를 참조하세요.
Windows 사용자인가요? Windows 설정 가이드를 참고하세요 — PowerShell 설치 프로그램, 호환성 매트릭스 및 Codex CLI 설정이 포함되어 있습니다.
도메인별로 구성된 사용자 정의 Claude Code 기능입니다. 각 스킬은 SKILL.md 진입점, 선택적 스크립트 및 참고 문서를 가지고 있습니다.
주요 내용:
⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
| Category | Count | Notable Skills |
|---|---|---|
| Core Development | 15 | fable, skill-optimizer, claude-agent-sdk, claude-md-manager, dag-typesafe, glossary, autoresearch, claude-usage, architecture-md-builder, stop-slop, test-harness-auditor, user-model-builder |
| ... | ||
Toggle skills on/off: python3 ~/.claude/skills/skill-toggle/scripts/skill_toggle.py list |
병렬 안전한 Codex 페르소나: codex-orchestrator는 각 역할을 개별 호출마다 developer_instructions를 통해 전달하며, Codex의 전역적, 리포지토리적, 중첩된 AGENTS.md 체인은 건드리지 않습니다. 독립적인 읽기 전용 에이전트는 즉시 확산(fan out)될 수 있으며, 겹치는 파일을 작성하는 에이전트는 여전히 순차적으로 또는 별도의 작업 트리에서 실행되어야 합니다.
Codex argv 위생 (2026-09-19): codex exec -i/--image는 가변 인자(variadic)이므로, 이제 런처들은 resume 및 종료 옵션 뒤에 --를 붙여 이를 출력합니다. 캡처된 출력 프로필은 실행 결과가 없을 때 Codex 자체 진단 정보를 출력합니다. Codex CLI 0.155.x에서는 PTY 또는 프롬프트 처리가 변경되지 않았습니다.
Claude 4.6 프롬프팅 정렬 (2026년 2월): 모든 에이전트 스킬(
minoan-swarm,super-ralph-wiggum,firecrawl,claude-agent-sdk,skill-optimizer)은 Anthropic의 Claude 4.6 프롬프팅 모범 사례를 따르도록 업데이트되었습니다. 이는 더 부드러운 도구 사용 언어, 동기 부여적 틀(motivational framing)보다 사실적 품질 기준, 노력 매개변수 안내, 구조화된 상태 관리를 포함합니다.
메모리 계층 구조: claude-md-manager 스킬은 관리 정책(managed policy), 프로젝트 메모리, 프로젝트 규칙(.claude/rules/), 사용자 메모리, 프로젝트 로컬, 자동 메모리의 전체 6단계 메모리 시스템을 문서화합니다. 또한 이것이 Claudicle 영혼 아키텍처와 어떻게 보완되는지 알아보려면 docs/global-setup/README.md를 참조하십시오.
10개의 라이프사이클 이벤트를 아우르는 30개의 Python 및 20개의 Bash 스크립트가 포함되어 있습니다. 주요 기능은 다음과 같습니다:
PreToolUse ────────→ git-track.sh (git 명령을 JSONL로 기록)
→ image-optimize.py (이미지 자동 크기 조정, PNG→JPEG)
PostToolUse ───────→ lint-on-write.py (ESLint/Clippy/Ruff + 사용자 정의 규칙)
...
전체 이벤트 맵, 후크 의존성 및 settings.json 구성에 대해서는 hooks/README.md를 참조하세요.
터미널 제목: 리포지토리 유형 이모지 아이콘을 사용한 2단계 형식 — 🔴 🐍 claudicle: 테스트 스위트 구축. 아이콘은 CLAUDE.md 키워드와 프로젝트 파일에서 자동 감지됩니다. 메인 제목은 이벤트 전반에 걸쳐 유지되며, 부제목은 트랜스크립트를 통해 업데이트됩니다.
세션 핸드오프 시스템: 세 가지 후크가 압축(compaction), 정상 종료(graceful exits), 충돌 상황에서도 컨텍스트를 보존합니다. 목적, 결정 사항, 장애물(blockers), 다음 단계 등을 포함하는 구조화된 YAML을 ~/.claude/handoffs/에 기록합니다. 또한 INDEX.md를 자동으로 유지 관리합니다.
Git 추적: 세 개의 후크가 모든 디렉토리에서 git 명령을 가로채어 리포지토리, 브랜치, 작업 내용 및 커밋 해시를 캡처합니다. 양방향 세션↔리포지토리 인덱스를 구축합니다. getSessionsForRepo() / getReposForSession()으로 조회하거나 /session-report로 대시보드를 생성할 수 있습니다.
플랜 자동 명명: 임의로 이름 붙여진 플랜 파일(예: tingly-humming-simon.md)을 H1 헤더를 추출하여 날짜가 포함된 슬러그(예: 2026-02-17-auto-rename-plan-files-hook.md)로 이름을 변경합니다. 세션 중간 연속성을 위해 포워딩 심볼릭 링크를 생성하며, SessionEnd 시 정리됩니다.
세션 자동 제목 지정: 플랜 파일이 생성될 때, plan-session-rename.py가 즉시 H1 헤더를 추출하여 해당 세션의 JSONL 트랜스크립트에 custom-title 이벤트를 주입합니다—LLM 호출 없이 순수 로컬 방식으로 약 10ms 만에 처리됩니다. Claude Code의 재개 선택기(resume picker)는 여기서 읽어오며, 다음 Stop 시 session-sync-db.py가 이를 tracker.db로 미러링합니다.
Lint 기반 에이전트 루프 (Lint-Directed Agent Loop): lint-on-write.py는 Write/Edit 작업 후 표준 린터(ESLint, Clippy, Ruff)와 사용자 정의 grep 기반 컨벤션 규칙을 실행하고, 위반 사항을 additionalContext로 반환하여 에이전트가 기계적으로 강제된 규칙에 따라 자체 수정하도록 합니다. 모든 저장소는 어떤 린터를 사용할지, 그리고 어떤 CLAUDE.md 컨벤션을 grep 규칙으로 적용할지 선언하는 .claude/lint-rules.json 설정 파일을 추가함으로써 옵트인 할 수 있습니다. Factory.ai 패턴을 구현합니다. 파일당 5초의 쿨다운, 최대 위반 횟수 10회 제한이 적용됩니다.
/command-name으로 호출되는 마크다운 템플릿입니다. 주요 워크플로우:
| 명령어 | 목적 |
|---|---|
/requirements-start | 탐색 질문을 통한 구조화된 프로젝트 계획 |
| ... |
`subagent_type:
| Tool | 목적 |
|---|---|
claude-tracker | Claude Code의 PID 파일에서 LIVE/INACTIVE 상태를 가진 최근 세션 목록을 보여줍니다 |
| ... | |
모든 CLI는 skills/planning-productivity/claude-tracker-suite/scripts/ 위에 얇은 래퍼(thin wrappers)로 구현되었으며, lib/tracker-utils.js (세션 파싱, live 감지)와 lib/tracker-db.js (Node의 내장 기능인 node:sqlite, npm 의존성 없음)를 공유합니다. Ghostty가 유일한 터미널 대상이며, cmux, tmux, Terminal.app 및 VS Code 재개 경로는 사용되지 않습니다(retired). Ghostty ≥ 1.3에서는 오프너가 네이티브 AppleScript 사전(keystrokes나 clipboard 필요 없음)을 구동하며, 이전 빌드에서는 Cmd-T를 누른 후 붙여넣기 한 번으로 대체됩니다. |
강화된 파이프라인(lib/tracker-utils.js의 parseSessionEnriched)은 전체 JSONL 트랜스크립트를 스캔하여 모든 API 호출로부터 토큰 사용량을 집계하고, Anthropic에서 공개한 모델별 가격을 사용하여 USD 비용을 계산합니다.
sqlite3 ~/.claude/tracker.db "SELECT short_id, num_turns, printf('\$%.2f', total_cost_usd), model_short FROM sessions ORDER BY total_cost_usd DESC LIMIT 10;"
cpluginsClaude Code에는 문서화되지 않은 약 37~40개의 에이전트 제한(agent limit)이 있습니다. 총 에이전트 수(내장 + 플러그인 + 사용자 정의)가 이 한도를 초과하면 경고 없이 에이전트가 조용히 누락됩니다. 이 도구는 플러그인 프로필을 관리하여 총 에이전트 수를 제한 내로 유지합니다.
cplugins status # 현재 프로필, 에이전트 수, 한도 초과/미달 여부 표시
cplugins soul # 모든 사용자 정의 서브 데몬(subdaimones), 복합 엔지니어링 제외 (34개 에이전트)
cplugins compound # 복합 엔지니어링 워크플로우 (45개 에이전트)
...
설정:
cp scripts/claude-plugins.py ~/.claude/scripts/
cp scripts/plugin-profiles.json ~/.claude/scripts/
chmod +x ~/.claude/scripts/claude-plugins.py
...
프로필은 plugin-profiles.json에 정의되어 있습니다. 플러그인이 변경될 때 스크립트 내의 AGENT_COUNTS를 수정하십시오. 변경 사항은 다음 세션 시작 시 적용됩니다.
~/.claude/ 구조 참조~/.claude/ 디렉터리에 대한 전체 참고 자료: CLAUDE.md 패턴, 사용자 페르소나 모델, agent_docs/를 이용한 점진적 공개(progressive disclosure), settings.json 훅/MCP/플러그인, 세션 핸드오프 시스템, 계획 및 설계 원칙.
feature-dev — Claude Code 팀의 무기창고Claude Code 팀에서 제공하는 공식 플러그인:
/plugin marketplace add anthropics/claude-code
/plugin install feature-dev
세 가지 전문 에이전트: code-architect (구현 청사진), code-explorer (실행 경로 추적), code-reviewer (신뢰도 기반 검토).
compound-engineering — 다중 에이전트 검토 워크플로우Every AI Labs 제공. 12개 이상의 전문 검토 에이전트(security-sentinel, performance-oracle, architecture-strategist 등)와 워크플로우 오케스트레이션 명령어 제공.
대부분의 워크플로우에서 MCP보다 스킬(skills)로 전환했습니다. Claude Code의 MCP Tool Search는 도구를 온디맨드로 로드하여 컨텍스트 오염을 약 85% 감소시킵니다.
.mcp.json에 구성됨: supabase, playwright, context7, shadcn, figma, arxiv, perplexity, telnyx, twilio 등. 전체 구성을 보려면 파일을 참조하세요.
최적화된 Ghostty 설정: Catppuccin Mocha/Latte 테마, Linear A/B, Phaistos Disc, Minoan Glyphs(PUA)를 위한 코도포인트 맵이 적용된 JetBrainsMono Nerd Font, 100K 스크롤백, 병렬 세션을 위한 분할 창(split panes), 프롬프트 점프, 세션 지속성.
키 바인딩: Cmd+D로 오른쪽 분할(split right), Cmd+Alt+Enter로 줌 분할(zoom split), Cmd+Up/Down으로 프롬프트 이동(jump prompts). 전체 키 바인딩 참조는 ghostty/README.md를 참고하세요.
ccstatusline (npm install -g ccstatusline) 및 lazygit (brew install lazygit)과 함께 사이드 분할(side split)로 사용해 보세요.
여기서 시작하세요: 저장소 구조의 개요를 보려면 ARCHITECTURE.md를 읽고, 그 다음 아래 단계를 따르세요.
CLAUDE.template.md — 모든 도구 사용 규칙(tooling conventions)과 개인 정보가 없는, 팀원 준비 완료 상태의 전역 설정 파일입니다.
cp CLAUDE.template.md ~/.claude/CLAUDE.md
cp -r docs/global-setup/agent_docs/*.md ~/.claude/agent_docs/
그 다음 사용자 정의하세요:
~/.claude/userModels/{yourname}/{yourname}Model.md 파일을 생성하고, @reference 주석을 주석 해제하세요. 사용자 모델 가이드를 참고하세요.@agent_docs/ 참조를 주석 해제하세요. 점진적 공개(progressive disclosure)를 참고하세요.docs/global-setup/agent_docs/의 시작 템플릿에는 활성 프로젝트, 기술 목록(skills inventory), 도구 참조(tools reference), 그리고 MCP 서버 문서를 사용자 정의할 수 있도록 제공됩니다.사용자 모델 예시를 포함하여 전체 ~/.claude/ 구조 참조는 docs/global-setup/README.md를 참고하세요.