EliasOulkadi/shokunin

62개의 엔지니어링 기술 + 지속적인 AI 메모리. 단 하나의 명령. 서버 불필요.

v4.2.3에는 신선도 감쇠 (freshness decay, 시간 가중 메모리), 권한 검증 (claim verification, verify_file_path MCP 도구), 9개의 MCP 도구 (기존 8개), 그리고 30개 이상의 버그 수정이 추가되었습니다.

職人 (shokunin)은 일본어로 장인(artisan)을 의미합니다. 이 기술들은 그 기준을 목표로 합니다: 모든 세부 사항을 정교하게 다듬고, 모든 예외 상황(edge case)을 처리하며, 모든 워크플로우를 자동화하는 것입니다.

# 단일 명령 설치 (Windows)
irm https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install.ps1 | iex

# 단일 명령 설치 (Linux)
bash <(curl -sL https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install.sh)

# 기술 전용 설치 (Windows — ChromaDB 미포함, MCP 미포함)
irm https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install-skills.ps1 | iex

# 기술 전용 설치 (Linux)
bash <(curl -sL https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install-skills.sh)

OpenCode + VS Code + WezTerm
62개 기술 + 슈퍼파워 플러그인 (superpowers plugin) + 4개 서브 에이전트 (subagents)
MCP 서버: filesystem, fetch, memory + ChromaDB
...

10개 도메인에 걸친 62개의 기술. 각 기술은 에이전트에게 결정 테이블 (decision tables), 에러 패턴 (error patterns), 프로덕션 체크리스트 (production checklists), 안티 패턴 (anti-patterns), 그리고 인용된 출처 (cited sources)를 사용하여 특정 도메인을 다루는 방법을 가르칩니다. 일반적인 프롬프트가 아닙니다. 실제 엔지니어링 가이드입니다.

Docker 기술은 멀티 스테이지 Node.js 템플릿, BuildKit 캐시 최적화, distroless 베이스 이미지, 그리고 CVE 스캐닝을 포함하여 1,422단어로 구성되어 있습니다. 인증 (auth) 기술은 OWASP를 직접 참조합니다. 데이터베이스 기술은 실제 EXPLAIN ANALYZE 출력을 포함합니다. 프론트엔드 기술에는 Emil Kowalski 패턴 (Sonner, Vaul), Paul Bakaus 원칙 (Impeccable), 그리고 Leon Lin 변동성 엔진 (Taste)이 포함됩니다. 모든 기술은 푸시(push)할 때마다 CI를 통해 frontmatter, 워크플로우 (workflow), 에러 처리 (error handling), 출처 (sources)를 검증받습니다. 모두 필수 사항입니다.

도메인 (Domain)	스킬 (Skills)	버전 (Version)
Infrastructure	docker, kubernetes, terraform, ci-cd, db-admin	v4.0
Backend	auth-architect, api-forge, db-sculptor, error-handler	v4.0
Frontend	component-forge, responsive-engine, motion-craft, landing-craft, aesthetic-web, ui-ux-pro-max, emil-design-eng, impeccable, taste, taste-soft, taste-minimalist	v4.0
Mobile	flutter, react-native	v4.0
Quality	test-commander, performance-profiler, code-review, comprehensive-review, cross-review, zen-review, zen-comprehensive-review	v4.0
Content & Business	communication, content-marketing, business-proposals, seo-geo, translate-craft, documentation	v4.0
Documents	kami (PDF 생성기), portfolio-auto, kagen (AI 이미지)	v4.0
Productivity	git-workflow, windows-powershell, strategy, brand-design, runbook-gen, finance, legal-counsel, whendone-plus	v4.0
AI Agents	agent-browser, agent-tools, find-skills, skill-creator, research, humanize	v4.0
System	memory, chromadb, shokunin-update, init, efficient-coding, senior-engineer, plan, playwright, neon-postgres, web-security	v4.2

각 스킬은 트리거 최적화된 설명 (trigger-optimized descriptions), 절차적 워크플로우 (procedural workflows), 에러 처리 (error handling), 프로덕션 체크리스트 (production checklists), 안티 패턴 (anti-patterns), 인용 출처 (cited sources)를 포함합니다. 고급 스킬은 또한 실행 가능한 스크립트 (executable scripts), 참조 파일 (reference files), 재사용 가능한 템플릿 (reusable templates)을 포함합니다.

구성 요소 (Component)	목적 (Purpose)
62개의 SKILL.md 파일	자동 활성화되는 도메인 전문 지식 (Domain expertise)
OpenCode 설정 (config)	MCP 서버, 서브에이전트 (subagents), 슈퍼파워 플러그인 (superpowers plugin)
ChromaDB 메모리	세션 간 지속되는 컨텍스트 (v4.0, 3계층 캡처, 구조화된 데이터)
CLAUDE.md + AGENTS.md	필수 메모리 지침: 시작 시마다 컨텍스트 검색 수행
자동 저장 래퍼 (Auto-save wrapper)	종료 시 콘솔 버퍼를 캡처하여 ChromaDB 및 마크다운 (markdown)에 저장
메모리 테스트 스위트 (Memory test suite)	모든 메모리 구성 요소에 대한 단일 명령 검증
PowerShell 프로필 (profile)	20개 이상의 별칭 (aliases), oh-my-posh, 자동 완성
Windows 스케줄러 (Windows scheduler)	주간 정리 및 메모리 백업
북마크릿 (Bookmarklet)	웹 페이지를 OpenCode로 전송
대시보드 (Dashboard)	로컬 생태계 상태 뷰어
WezTerm 설정 (config)	Catppuccin 테마가 적용된 GPU 터미널
ChromaDB (SQLite 기반)	설치가 필요 없는 로컬 벡터 데이터베이스 (vector database)

의존성 (Dependency)	버전 (Version)	비고 (Notes)
OS	Windows 10/11 또는 Linux	Linux: bash 4 이상이 필요하며, sh는 지원하지 않음. bash --version으로 확인하십시오.
Node.js	≥ 18	npm을 포함합니다. node --version으로 확인하십시오.
Python	≥ 3.11	python3 --version으로 확인하십시오.
Git	≥ 2.x	git --version으로 확인하십시오.

의존성 (Dependency)	이유 (Why)	설치 (Install)
python3-pip	ChromaDB에 필요합니다. Ubuntu/Debian에는 기본적으로 포함되어 있지 않습니다.	sudo apt-get install -y python3-pip
build-essential + python3-dev	일부 시스템에서 ChromaDB 네이티브 휠 (native wheels)을 컴파일하는 데 필요합니다.	sudo apt-get install -y build-essential python3-dev
cron 데몬 (daemon)	자동화된 주간 유지 관리에 필요합니다 (선택 사항).	sudo systemctl enable --now cron

Ubuntu 24.04+: PEP 668은 기본적으로 전역 pip install을 차단합니다. 설치 프로그램은 --break-system-packages를 사용하여 이를 자동으로 처리합니다. 문제가 발생하면 아래의 문제 해결 (Troubleshooting) 섹션을 참조하십시오.

• PowerShell 5.1 이상이 필요합니다. $PSVersionTable.PSVersion을 실행하여 확인하십시오. - 실행 정책 (Execution policy)은 스크립트를 허용해야 합니다: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Windows:

# 1. 설치 (Install)
irm https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install.ps1 | iex
# 2. (선택 사항) 무료 NVIDIA API 키를 받거나, 건너뛰세요. OpenCode Go는 키 없이도 작동합니다.
...

Linux:

# 1. 설치 (Install)
bash <(curl -sL https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install.sh)
# 2. (선택 사항) 무료 NVIDIA API 키를 받거나, 건너뛰세요. OpenCode Go는 키 없이도 작동합니다.
...

다중 전략 회상 (Multi-strategy recall) (벡터 (vector) + BM25 + 시계열 (temporal) + 상호 순위 융합 (reciprocal rank fusion)). 명시적 계속하기 (explicit continue)를 통한 세션 관리 (어떤 세션을 재개할지 추측하지 않음).

신선도 감쇠 (Freshness decay): 지수적 최신성 혼합 (exponential recency blending) — 오래된 기억은 30일의 반감기를 거치며 흐려지므로, 오래된 주장 (stale claims)이 최근의 문맥 (context)을 압도하지 않도록 합니다.

주장 검증 (Claim verification): verify_file_path

MCP 도구는 에이전트가 동작하기 전에 오래된 기억으로부터의 파일 경로를 검증합니다 — 기억을 사실 (facts)이 아닌, 특정 시점의 고정된 주장 (claims)으로 취급합니다.

9개의 MCP 도구 (8개에서 증가): store_context, search_context, get_session_summary, multi_search_context (vector+BM25+RRF+temporal), consolidate_memories, list_sessions, continue_session, save_message, verify_file_path

# 최근 세션 목록 표시
python ~/.shokunin/scripts/chroma-helper.py session list 5
# 특정 세션 계속하기 (전체 문맥 로드)
...

모든 데이터는 ~/.shokunin/memory/에 저장됩니다.

클라우드 없음, 텔레메트리 (telemetry) 없음, 구독 없음.

# 메모리 시스템 테스트
.\test-memory.ps1
# 모든 메모리 구성 요소 검증
...

• 기술 개요 (Technical Overview) v4.2.3 - 전체 에코시스템 개요, 다중 전략 회상, 사후 비교 (Hindsight comparison)

문제 (Problem)	원인 (Cause)	해결책 (Solution)
설치 프로그램이 Continue? (y/n)에서 멈춤	비대화형 모드 (non-interactive mode)에서 read -p가 차단됨	bash install.sh -y를 사용하거나 터미널에서 직접 실행하세요
pip3: command not found	python3-pip가 설치되지 않음	sudo apt-get install python3-pip
externally-managed-environment	Ubuntu 24.04+ 버전의 PEP 668 적용	설치 프로그램이 자동으로 --break-system-packages를 적용합니다. 실패할 경우 수동으로 실행하세요: python3 -m pip install chromadb --break-system-packages
Cannot uninstall typing_extensions	Debian 패키지화된 패키지에 RECORD 파일이 누락됨	python3 -m pip install chromadb --break-system-packages --ignore-installed typing-extensions
MCP fetch/filesystem: Connection closed	OpenCode 런타임 (runtime) 설정 문제	node가 PATH에 있는지 확인하고 ~/.config/opencode/opencode.json을 점검하세요
npm install -g opencode 실패	npm이 없거나 권한이 부족함	npm을 먼저 설치하거나, sudo npm install -g opencode를 실행하세요
ChromaDB 설치 실패	빌드 의존성 (build dependencies) 누락	sudo apt-get install -y build-essential python3-dev

OpenCode 커스텀 명령 (custom commands): /save (세션을 ChromaDB에 저장), /load (이전 세션 로드), /status (상태 점검 (healthcheck)).

Windows:

.\run-opencode.ps1 # AI 세션 시작 (메모리 캡처 포함)
opencode # AI 세션 시작 (단순 모드)
.\memory-healthcheck.ps1 # 모든 메모리 구성 요소 검증
...

Linux:

opencode # AI 세션 시작 (메모리 캡처 포함)
./memory-healthcheck.sh # 모든 메모리 구성 요소 검증
gst, ga, gc "msg", gp, gl # Git 별칭 (aliases)
...

이 에코시스템은 여러 AI 코딩 런타임 (runtimes)에서 작동합니다. 핵심 요소(기술 (skills), 메모리 (memory), 스크립트 (scripts))는 런타임에 구애받지 않습니다 (runtime-agnostic). 오직 MCP 서버 설정과 지침 파일 (instruction files)만 다릅니다.

런타임 (Runtime)	기술 (Skills)	메모리 (Memory)	MCP	스크립트 (Scripts)	설정 템플릿 (Config template)
OpenCode	✅ 네이티브 (Native)	✅ 네이티브 (Native)	✅ .pack/opencode.json	✅ .ps1 + .sh	내장 (Built-in)
Claude Code	✅ SKILL.md 읽기	✅ MCP를 통해	✅ .pack/templates/claude-code.json	✅ .ps1 + .sh	템플릿 복사
Cline (VS Code)	✅ SKILL.md 읽기	✅ MCP를 통해	✅ .pack/templates/cline-settings.json	✅ .ps1 + .sh	settings.json에 추가
Cursor	✅ SKILL.md 읽기	✅ 규칙 (rules)을 통해	✅ .pack/templates/cursor-mcp.json	✅ .ps1 + .sh	.cursor/로 복사
Continue.dev	✅ SKILL.md 읽기	✅ 규칙 (rules)을 통해	✅ .pack/templates/continue-config.yaml	✅ .ps1 + .sh	.continue/로 복사
Windsurf	✅ SKILL.md 읽기	✅ 규칙 (rules)을 통해	✅ .pack/templates/windsurf-mcp.json	✅ .sh	템플릿 복사

Claude Code: .pack/templates/claude-code.json 파일을 프로젝트 루트에 claude.json으로 복사하거나, CLAUDE.md를 통해 설정하세요.

Cline: .pack/templates/cline-settings.json에 있는 mcpServers 블록을 VS Code의 settings.json에 추가하세요. .pack/rules/cline-memory.md를 .clinerules로 복사하세요.

Cursor: Cursor Settings > MCP에서 .pack/templates/cursor-mcp.json을 사용하여 MCP 서버를 설정하세요. .pack/rules/cursor-memory.mdc를 .cursor/rules/memory.mdc로 복사하세요.

Continue.dev: .pack/templates/continue-config.yaml을 .continue/config.yaml로 복사하세요. .pack/rules/continue-memory.md를 .continue/rules/에 추가하세요.

Windsurf: .pack/templates/windsurf-mcp.json을 MCP 설정으로 복사하세요. .pack/rules/windsurf-memory.md를 .windsurf/rules/memory.md로 복사하세요.

GitHub github.com/EliasOulkadi/shokunin
Website eliasoulkadi.github.io/shokunin

• Shokunin 기술 개요 (Technical Overview)

MIT 라이선스: 자유를 의미하는 무료(free as in freedom), 비용이 없는 무료(free as in zero cost).