The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
docs: address Korean translation review feedback
Affaan Mustafafb7b73a96292
diff --git a/README.md b/README.mdindex 8c03737d3..47a0139ac 100644--- a/README.md+++ b/README.md@@ -1,4 +1,4 @@-**Language:** English | [繁體中文](docs/zh-TW/README.md) | [한국어](docs/ko-KR/README.md)+**Language:** English | [简体中文](README.zh-CN.md) | [繁體中文](docs/zh-TW/README.md) | [日本語](docs/ja-JP/README.md) | [한국어](docs/ko-KR/README.md)# Everything Claude Codediff --git a/docs/ko-KR/CONTRIBUTING.md b/docs/ko-KR/CONTRIBUTING.mdindex 8f2f56147..7597d7e43 100644--- a/docs/ko-KR/CONTRIBUTING.md+++ b/docs/ko-KR/CONTRIBUTING.md@@ -195,6 +195,15 @@ model: sonnet| `tools` | 필요한 것만 포함 | `Read, Write, Edit, Bash, Grep, Glob, WebFetch, Task` || `model` | 복잡도 수준 | `haiku` (단순), `sonnet` (코딩), `opus` (복잡) |+### 예시 에이전트++| 에이전트 | 용도 |+|----------|------|+| `tdd-guide.md` | 테스트 주도 개발 |+| `code-reviewer.md` | 코드 리뷰 |+| `security-reviewer.md` | 보안 점검 |+| `build-error-resolver.md` | 빌드 오류 수정 |+---## 훅 기여하기@@ -216,6 +225,68 @@ hooks/hooks.json| `SessionStart` | 세션 시작 시 | 컨텍스트 로딩 || `Stop` | 세션 종료 시 | 정리, 감사 |+### 훅 형식++```json+{+ "hooks": {+ "PreToolUse": [+ {+ "matcher": "tool == \"Bash\" && tool_input.command matches \"rm -rf /\"",+ "hooks": [+ {+ "type": "command",+ "command": "echo '[Hook] BLOCKED: Dangerous command' && exit 1"+ }+ ],+ "description": "위험한 rm 명령 차단"+ }+ ]+ }+}+```++### Matcher 문법++```javascript+// 특정 도구 매칭+tool == "Bash"+tool == "Edit"+tool == "Write"++// 입력 패턴 매칭+tool_input.command matches "npm install"+tool_input.file_path matches "\\.tsx?$"++// 조건 결합+tool == "Bash" && tool_input.command matches "git push"+```++### 훅 예시++```json+// tmux 밖 dev 서버 차단+{+ "matcher": "tool == \"Bash\" && tool_input.command matches \"npm run dev\"",+ "hooks": [{"type": "command", "command": "echo '개발 서버는 tmux에서 실행하세요' && exit 1"}],+ "description": "dev 서버를 tmux에서 실행하도록 강제"+}++// TypeScript 편집 후 자동 포맷+{+ "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.tsx?$\"",+ "hooks": [{"type": "command", "command": "npx prettier --write \"$file_path\""}],+ "description": "TypeScript 파일 편집 후 포맷"+}++// git push 전 경고+{+ "matcher": "tool == \"Bash\" && tool_input.command matches \"git push\"",+ "hooks": [{"type": "command", "command": "echo '[Hook] push 전에 변경사항을 다시 검토하세요'"}],+ "description": "push 전 검토 리마인더"+}+```+### 훅 체크리스트- [ ] Matcher가 구체적 (너무 광범위하지 않게)@@ -236,6 +307,36 @@ hooks/hooks.jsoncommands/your-command.md```+### 커맨드 템플릿++```markdown+---+description: /help에 표시되는 간단한 설명+---++# 커맨드 이름++## 목적++이 커맨드가 수행하는 작업.++## 사용법++\`\`\`+/your-command [args]+\`\`\`++## 워크플로우++1. 첫 번째 단계+2. 두 번째 단계+3. 마지막 단계++## 출력++사용자가 받는 결과.+```+### 커맨드 예시| 커맨드 | 용도 |@@ -247,6 +348,34 @@ commands/your-command.md---+## 크로스-하네스 및 번역++### 스킬 서브셋 (Codex 및 Cursor)++ECC는 다른 하네스를 위한 스킬 서브셋도 제공합니다:++- **Codex:** `.agents/skills/` — `agents/openai.yaml`에 나열된 스킬이 Codex에서 로드됩니다.+- **Cursor:** `.cursor/skills/` — Cursor용 스킬 서브셋이 별도로 포함됩니다.++Codex 또는 Cursor에서도 제공해야 하는 **새 스킬**을 추가한다면:++1. 먼저 `skills/your-skill-name/` 아래에 일반적인 ECC 스킬로 추가합니다.+2. **Codex**에서도 제공해야 하면 `.agents/skills/`에 반영하고, 필요하면 `agents/openai.yaml`에도 참조를 추가합니다.+3. **Cursor**에서도 제공해야 하면 Cursor 레이아웃에 맞게 `.cursor/skills/` 아래에 추가합니다.++기존 디렉터리의 구조를 확인한 뒤 같은 패턴을 따르세요. 이 서브셋 동기화는 수동이므로 PR 설명에 반영 여부를 적어 두는 것이 좋습니다.++### 번역++번역 문서는 `docs/` 아래에 있습니다. 예: `docs/zh-CN`, `docs/zh-TW`, `docs/ja-JP`.++번역된 에이전트, 커맨드, 스킬을 변경한다면:++- 대응하는 번역 파일도 함께 업데이트하거나+- 유지보수자/번역자가 후속 작업을 할 수 있도록 이슈를 열어 주세요.++---+## Pull Request 프로세스### 1. PR 제목 형식diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.mdindex 70a1098ac..6dc2d25da 100644--- a/docs/ko-KR/README.md+++ b/docs/ko-KR/README.md@@ -167,7 +167,7 @@ cd everything-claude-code3. **package.json**: `packageManager` 필드4. **락 파일**: package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb에서 감지5. **글로벌 설정**: `~/.claude/package-manager.json`-6. **폴백**: 사용 가능한 첫 번째 패키지 매니저+6. **폴백**: `npm`패키지 매니저 설정 방법:@@ -416,7 +416,7 @@ cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/ # 사용하cp everything-claude-code/commands/*.md ~/.claude/commands/# 스킬 복사-cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/+cp -r everything-claude-code/skills/* ~/.claude/skills/cp -r everything-claude-code/skills/search-first ~/.claude/skills/```@@ -498,7 +498,9 @@ rules/| 보안 취약점 찾기 | `/security-scan` | security-reviewer || 사용하지 않는 코드 제거 | `/refactor-clean` | refactor-cleaner || 문서 업데이트 | `/update-docs` | doc-updater |+| Go 빌드 실패 수정 | `/go-build` | go-build-resolver || Go 코드 리뷰 | `/go-review` | go-reviewer |+| 데이터베이스 스키마/쿼리 리뷰 | `/code-review` + database-reviewer 에이전트 | database-reviewer || Python 코드 리뷰 | `/python-review` | python-reviewer |### 일반적인 워크플로우diff --git a/docs/ko-KR/TERMINOLOGY.md b/docs/ko-KR/TERMINOLOGY.mdindex 477519411..e7bb9cb3a 100644--- a/docs/ko-KR/TERMINOLOGY.md+++ b/docs/ko-KR/TERMINOLOGY.md@@ -38,20 +38,20 @@| Merge | merge | 확정 | 영문 유지 || Repository | 저장소 | 확정 | || Fork | Fork | 확정 | 영문 유지 |-| Supabase | Supabase | - | 제품명 유지 |-| Redis | Redis | - | 제품명 유지 |-| Playwright | Playwright | - | 제품명 유지 |-| TypeScript | TypeScript | - | 언어명 유지 |-| JavaScript | JavaScript | - | 언어명 유지 |-| Go/Golang | Go | - | 언어명 유지 |-| React | React | - | 프레임워크명 유지 |-| Next.js | Next.js | - | 프레임워크명 유지 |-| PostgreSQL | PostgreSQL | - | 제품명 유지 |+| Supabase | Supabase | 확정 | 제품명 유지 |+| Redis | Redis | 확정 | 제품명 유지 |+| Playwright | Playwright | 확정 | 제품명 유지 |+| TypeScript | TypeScript | 확정 | 언어명 유지 |+| JavaScript | JavaScript | 확정 | 언어명 유지 |+| Go/Golang | Go | 확정 | 언어명 유지 |+| React | React | 확정 | 프레임워크명 유지 |+| Next.js | Next.js | 확정 | 프레임워크명 유지 |+| PostgreSQL | PostgreSQL | 확정 | 제품명 유지 || RLS (Row Level Security) | RLS(행 수준 보안) | 확정 | 최초 사용 시 전개 |-| OWASP | OWASP | - | 영문 유지 |-| XSS | XSS | - | 영문 유지 |+| OWASP | OWASP | 확정 | 영문 유지 |+| XSS | XSS | 확정 | 영문 유지 || SQL Injection | SQL 인젝션 | 확정 | |-| CSRF | CSRF | - | 영문 유지 |+| CSRF | CSRF | 확정 | 영문 유지 || Refactor | 리팩토링 | 확정 | || Dead Code | 데드 코드 | 확정 | || Lint/Linter | Lint | 확정 | 영문 유지 |@@ -70,11 +70,11 @@| Migration | 마이그레이션 | 확정 | || Transaction | 트랜잭션 | 확정 | || Concurrency | 동시성 | 확정 | |-| Goroutine | Goroutine | - | Go 용어 유지 |+| Goroutine | Goroutine | 확정 | Go 용어 유지 || Channel | Channel | 확정 | Go 컨텍스트에서 유지 |-| Mutex | Mutex | - | 영문 유지 |+| Mutex | Mutex | 확정 | 영문 유지 || Interface | 인터페이스 | 확정 | |-| Struct | Struct | - | Go 용어 유지 |+| Struct | Struct | 확정 | Go 용어 유지 || Mock | Mock | 확정 | 테스트 용어 유지 || Stub | Stub | 확정 | 테스트 용어 유지 || Fixture | Fixture | 확정 | 테스트 용어 유지 |@@ -82,7 +82,7 @@| Snapshot | 스냅샷 | 확정 | || Trace | 트레이스 | 확정 | || Artifact | 아티팩트 | 확정 | |-| CI/CD | CI/CD | - | 영문 유지 |+| CI/CD | CI/CD | 확정 | 영문 유지 || Pipeline | 파이프라인 | 확정 | |---diff --git a/docs/ko-KR/agents/doc-updater.md b/docs/ko-KR/agents/doc-updater.mdindex 7da9bcace..ac889fd94 100644--- a/docs/ko-KR/agents/doc-updater.md+++ b/docs/ko-KR/agents/doc-updater.md@@ -87,6 +87,15 @@ docs/CODEMAPS/4. **실행 가능** — 실제로 작동하는 설정 커맨드 포함5. **상호 참조** — 관련 문서 링크+## 품질 체크리스트++- [ ] 실제 코드에서 코드맵 생성+- [ ] 모든 파일 경로 존재 확인+- [ ] 코드 예제가 컴파일 또는 실행됨+- [ ] 링크 검증 완료+- [ ] 최신 타임스탬프 업데이트+- [ ] 오래된 참조 없음+## 업데이트 시점**항상:** 새 주요 기능, API 라우트 변경, 의존성 추가/제거, 아키텍처 변경, 설정 프로세스 수정.diff --git a/docs/ko-KR/agents/e2e-runner.md b/docs/ko-KR/agents/e2e-runner.mdindex bc199ccb1..5d82518f7 100644--- a/docs/ko-KR/agents/e2e-runner.md+++ b/docs/ko-KR/agents/e2e-runner.md@@ -71,7 +71,7 @@ npx playwright show-report # HTML 보고서 보기- **시맨틱 로케이터 사용**: `[data-testid="..."]` > CSS 셀렉터 > XPath- **시간이 아닌 조건 대기**: `waitForResponse()` > `waitForTimeout()`-- **자동 대기 내장**: `page.locator().click()`은 자동 대기; `page.click()`은 아님+- **자동 대기 내장**: `locator.click()`과 `page.click()` 모두 자동 대기를 제공하지만, 더 안정적인 `locator` 기반 API를 선호- **테스트 격리**: 각 테스트는 독립적; 공유 상태 없음- **빠른 실패**: 모든 핵심 단계에서 `expect()` 어설션 사용- **재시도 시 트레이스**: 실패 디버깅을 위해 `trace: 'on-first-retry'` 설정diff --git a/docs/ko-KR/agents/tdd-guide.md b/docs/ko-KR/agents/tdd-guide.mdindex 2ea68c4b1..060241ff1 100644--- a/docs/ko-KR/agents/tdd-guide.md+++ b/docs/ko-KR/agents/tdd-guide.md@@ -21,10 +21,16 @@ model: sonnet기대 동작을 설명하는 실패하는 테스트 작성.### 2. 테스트 실행 -- 실패 확인+Node.js (npm):```bashnpm test```+언어 중립:+- 프로젝트의 기본 테스트 명령을 실행하세요.+- Python: `pytest`+- Go: `go test ./...`+### 3. 최소한의 구현 작성 (GREEN)테스트를 통과하기에 충분한 코드만.@@ -34,11 +40,17 @@ npm test중복 제거, 이름 개선, 최적화 -- 테스트는 그린 유지.### 6. 커버리지 확인+Node.js (npm):```bashnpm run test:coverage# 필수: branches, functions, lines, statements 80% 이상```+언어 중립:+- 프로젝트의 기본 커버리지 명령을 실행하세요.+- Python: `pytest --cov`+- Go: `go test ./... -cover`+## 필수 테스트 유형| 유형 | 테스트 대상 | 시점 |diff --git a/docs/ko-KR/commands/build-fix.md b/docs/ko-KR/commands/build-fix.mdindex c113cc800..4edb038d9 100644--- a/docs/ko-KR/commands/build-fix.md+++ b/docs/ko-KR/commands/build-fix.md@@ -1,3 +1,8 @@+---+name: build-fix+description: 최소한의 안전한 변경으로 build 및 타입 오류를 점진적으로 수정합니다.+---+# Build 오류 수정최소한의 안전한 변경으로 build 및 타입 오류를 점진적으로 수정합니다.@@ -14,7 +19,7 @@| `pom.xml` | `mvn compile` || `build.gradle` | `./gradlew compileJava` || `go.mod` | `go build ./...` |-| `pyproject.toml` | `python -m py_compile` 또는 `mypy .` |+| `pyproject.toml` | `python -m compileall .` 또는 `mypy .` |## 2단계: 오류 파싱 및 그룹화diff --git a/docs/ko-KR/commands/checkpoint.md b/docs/ko-KR/commands/checkpoint.mdindex e8d5e578e..74a65c166 100644--- a/docs/ko-KR/commands/checkpoint.md+++ b/docs/ko-KR/commands/checkpoint.md@@ -1,10 +1,15 @@+---+name: checkpoint+description: 워크플로우에서 checkpoint를 생성, 검증, 조회 또는 정리합니다.+---+# Checkpoint 명령어워크플로우에서 checkpoint를 생성하거나 검증합니다.## 사용법-`/checkpoint [create|verify|list] [name]`+`/checkpoint [create|verify|list|clear] [name]`## Checkpoint 생성diff --git a/docs/ko-KR/commands/code-review.md b/docs/ko-KR/commands/code-review.mdindex 3f4c115e1..18a865177 100644--- a/docs/ko-KR/commands/code-review.md+++ b/docs/ko-KR/commands/code-review.md@@ -19,9 +19,9 @@- 800줄 초과 파일- 4단계 초과 중첩 깊이- 누락된 에러 처리-- console.log 문+- 디버그 로깅 문구(예: 개발용 로그/print 등)- TODO/FIXME 주석-- 공개 API에 대한 JSDoc 누락+- 활성 언어에 대한 공개 API 문서 누락(예: JSDoc/Go doc/Docstring 등)**모범 사례 (MEDIUM):**- 변이(Mutation) 패턴 (불변 패턴을 사용하세요)diff --git a/docs/ko-KR/commands/e2e.md b/docs/ko-KR/commands/e2e.mdindex f82c70d09..442fcfd7a 100644--- a/docs/ko-KR/commands/e2e.md+++ b/docs/ko-KR/commands/e2e.md@@ -36,7 +36,7 @@ e2e-runner 에이전트가 수행하는 작업:## 사용 예시-```+````User: /e2e 마켓 검색 및 조회 흐름 테스트Agent (e2e-runner):@@ -200,7 +200,7 @@ Running 3 tests using 3 workers```✅ CI/CD 통합 준비가 완료된 E2E 테스트 모음!-```+````## 테스트 아티팩트diff --git a/docs/ko-KR/commands/eval.md b/docs/ko-KR/commands/eval.mdindex e07ea2561..ddf3869dc 100644--- a/docs/ko-KR/commands/eval.md+++ b/docs/ko-KR/commands/eval.md@@ -4,7 +4,7 @@## 사용법-`/eval [define|check|report|list] [feature-name]`+`/eval [define|check|report|list|clean] [feature-name]`## 평가 정의diff --git a/docs/ko-KR/commands/go-build.md b/docs/ko-KR/commands/go-build.mdindex 3933af100..64ea0e06f 100644--- a/docs/ko-KR/commands/go-build.md+++ b/docs/ko-KR/commands/go-build.md@@ -43,7 +43,7 @@ go mod tidy -v## 예시 세션-```text+````textUser: /go-buildAgent:@@ -141,7 +141,7 @@ ok project/internal/handler 0.023s| 남은 이슈 | 0 |Build 상태: ✅ 성공-```+````## 자주 발생하는 에러diff --git a/docs/ko-KR/commands/go-review.md b/docs/ko-KR/commands/go-review.mdindex 61b272e7a..f12a3989e 100644--- a/docs/ko-KR/commands/go-review.md+++ b/docs/ko-KR/commands/go-review.md@@ -68,7 +68,7 @@ govulncheck ./...## 사용 예시-```text+````textUser: /go-reviewAgent:@@ -125,7 +125,7 @@ return fmt.Errorf("get user %s: %w", userID, err)- MEDIUM: 0권장: ❌ CRITICAL 이슈가 수정될 때까지 merge 차단-```+````## 승인 기준diff --git a/docs/ko-KR/commands/setup-pm.md b/docs/ko-KR/commands/setup-pm.mdindex 43b01acee..3115e7d4d 100644--- a/docs/ko-KR/commands/setup-pm.md+++ b/docs/ko-KR/commands/setup-pm.md@@ -32,7 +32,7 @@ node scripts/setup-package-manager.js --list3. **package.json**: `packageManager` 필드4. **락 파일**: package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb의 존재 여부5. **전역 설정**: `~/.claude/package-manager.json`-6. **폴백**: 사용 가능한 첫 번째 패키지 매니저 (pnpm > bun > yarn > npm)+6. **폴백**: `npm`## 설정 파일diff --git a/docs/ko-KR/commands/tdd.md b/docs/ko-KR/commands/tdd.mdindex eba7a7540..cf21ee233 100644--- a/docs/ko-KR/commands/tdd.md+++ b/docs/ko-KR/commands/tdd.md@@ -48,7 +48,7 @@ REPEAT: 다음 기능/시나리오## 사용 예시-```+````User: /tdd 마켓 유동성 점수를 계산하는 함수가 필요합니다Agent (tdd-guide):@@ -251,7 +251,7 @@ Coverage: 100% ✅ (목표: 80%)```✅ TDD 세션 완료!-```+````## TDD 모범 사례diff --git a/docs/ko-KR/commands/test-coverage.md b/docs/ko-KR/commands/test-coverage.mdindex ecde8a184..7eb8b8b3e 100644--- a/docs/ko-KR/commands/test-coverage.md+++ b/docs/ko-KR/commands/test-coverage.md@@ -1,3 +1,8 @@+---+name: test-coverage+description: 테스트 커버리지를 분석하고, 80% 이상을 목표로 누락된 테스트를 식별하고 생성합니다.+---+# 테스트 커버리지테스트 커버리지를 분석하고, 갭을 식별하며, 80% 이상 커버리지 달성을 위해 누락된 테스트를 생성합니다.diff --git a/docs/ko-KR/commands/update-codemaps.md b/docs/ko-KR/commands/update-codemaps.mdindex a2bf31384..091d2d2e8 100644--- a/docs/ko-KR/commands/update-codemaps.md+++ b/docs/ko-KR/commands/update-codemaps.md@@ -10,15 +10,16 @@## 2단계: 코드맵 생성-`docs/CODEMAPS/` (또는 `.reports/codemaps/`)에 코드맵 생성 또는 업데이트:+`docs/CODEMAPS/`에 코드맵 생성 또는 업데이트:| 파일 | 내용 ||------|------|-| `architecture.md` | 상위 시스템 다이어그램, 서비스 경계, 데이터 흐름 |+| `INDEX.md` | 전체 코드베이스 개요와 영역별 링크 || `backend.md` | API 라우트, 미들웨어 체인, 서비스 → 리포지토리 매핑 || `frontend.md` | 페이지 트리, 컴포넌트 계층, 상태 관리 흐름 |-| `data.md` | 데이터베이스 테이블, 관계, 마이그레이션 히스토리 |-| `dependencies.md` | 외부 서비스, 서드파티 통합, 공유 라이브러리 |+| `database.md` | 데이터베이스 스키마, 마이그레이션, 저장소 계층 |+| `integrations.md` | 외부 서비스, 서드파티 통합, 어댑터 |+| `workers.md` | 백그라운드 작업, 큐, 스케줄러 |### 코드맵 형식@@ -41,27 +42,33 @@ src/repos/user.ts (데이터베이스 접근, 80줄)- Stripe (결제 처리)```-## 3단계: 변경 감지+## 3단계: 영역 분류-1. 이전 코드맵이 있는 경우 변경 비율 계산-2. 변경이 30%를 초과하면 diff를 표시하고 덮어쓰기 전에 사용자 승인 요청-3. 변경이 30% 이하이면 기존 파일에 바로 업데이트+생성기는 파일 경로 패턴을 기반으로 영역을 자동 분류합니다:++1. 프론트엔드: `app/`, `pages/`, `components/`, `hooks/`, `.tsx`, `.jsx`+2. 백엔드: `api/`, `routes/`, `controllers/`, `services/`, `.route.ts`+3. 데이터베이스: `db/`, `migrations/`, `prisma/`, `repositories/`+4. 통합: `integrations/`, `adapters/`, `connectors/`, `plugins/`+5. 워커: `workers/`, `jobs/`, `queues/`, `tasks/`, `cron/`## 4단계: 메타데이터 추가각 코드맵에 최신 정보 헤더를 추가합니다:```markdown-<!-- Generated: 2026-02-11 | Files scanned: 142 | Token estimate: ~800 -->+**Last Updated:** 2026-03-12+**Total Files:** 42+**Total Lines:** 1875```-## 5단계: 분석 보고서 저장+## 5단계: 인덱스와 영역 문서 동기화-`.reports/codemap-diff.txt`에 요약을 작성합니다:-- 마지막 스캔 이후 추가/제거/수정된 파일-- 새로 감지된 의존성-- 아키텍처 변경 사항 (새 라우트, 새 서비스 등)-- 90일 이상 업데이트되지 않은 문서에 대한 오래된 항목 경고+`INDEX.md`는 생성된 영역 문서를 링크하고 요약해야 합니다:+- 각 영역의 파일 수와 총 라인 수+- 감지된 엔트리 포인트+- 저장소 트리의 간단한 ASCII 개요+- 영역별 세부 문서 링크## 팁@@ -69,4 +76,4 @@ src/repos/user.ts (데이터베이스 접근, 80줄)- 전체 코드 블록 대신 **파일 경로와 함수 시그니처** 사용- 효율적인 컨텍스트 로딩을 위해 각 코드맵을 **1000 토큰 미만**으로 유지- 장황한 설명 대신 데이터 흐름에 ASCII 다이어그램 사용-- 주요 기능 추가 또는 리팩토링 세션 후 실행+- 주요 기능 추가 또는 리팩토링 세션 후 `npx tsx scripts/codemaps/generate.ts` 실행diff --git a/docs/ko-KR/commands/update-docs.md b/docs/ko-KR/commands/update-docs.mdindex 3d353ce2e..c4500c9ea 100644--- a/docs/ko-KR/commands/update-docs.md+++ b/docs/ko-KR/commands/update-docs.md@@ -1,3 +1,8 @@+---+name: update-docs+description: 코드베이스를 기준으로 문서를 동기화하고 생성된 섹션을 갱신합니다.+---+# 문서 업데이트문서를 코드베이스와 동기화하고, 원본 소스 파일에서 생성합니다.diff --git a/docs/ko-KR/commands/verify.md b/docs/ko-KR/commands/verify.mdindex 41ca5cbe8..3c973a3e7 100644--- a/docs/ko-KR/commands/verify.md+++ b/docs/ko-KR/commands/verify.md@@ -23,11 +23,15 @@- 통과/실패 수 보고- 커버리지 비율 보고-5. **Console.log 감사**+5. **시크릿 스캔**+ - 소스 파일에서 API 키, 토큰, 비밀값 패턴 검색+ - 발견 위치 보고++6. **Console.log 감사**- 소스 파일에서 console.log 검색- 위치 보고-6. **Git 상태**+7. **Git 상태**- 커밋되지 않은 변경사항 표시- 마지막 커밋 이후 수정된 파일 표시diff --git a/docs/ko-KR/examples/django-api-CLAUDE.md b/docs/ko-KR/examples/django-api-CLAUDE.mdindex 18cd261cb..6b56ccf6d 100644--- a/docs/ko-KR/examples/django-api-CLAUDE.md+++ b/docs/ko-KR/examples/django-api-CLAUDE.md@@ -142,12 +142,12 @@ from django.db import transactiondef create_order(*, customer, product_id: uuid.UUID, quantity: int) -> Order:"""재고 검증과 결제 보류를 포함한 주문 생성."""- product = Product.objects.select_for_update().get(id=product_id)+ with transaction.atomic():+ product = Product.objects.select_for_update().get(id=product_id)- if product.stock < quantity:- raise InsufficientStockError()+ if product.stock < quantity:+ raise InsufficientStockError()- with transaction.atomic():order = Order.objects.create(customer=customer,product=product,diff --git a/docs/ko-KR/examples/rust-api-CLAUDE.md b/docs/ko-KR/examples/rust-api-CLAUDE.mdindex 0f05c8b26..1e0ef375c 100644--- a/docs/ko-KR/examples/rust-api-CLAUDE.md+++ b/docs/ko-KR/examples/rust-api-CLAUDE.md@@ -55,7 +55,9 @@ pub enum AppError {#[error("Unauthorized")]Unauthorized,#[error(transparent)]- Internal(#[from] anyhow::Error),+ Database(#[from] sqlx::Error),+ #[error(transparent)]+ Io(#[from] std::io::Error),}impl IntoResponse for AppError {@@ -64,7 +66,11 @@ impl IntoResponse for AppError {Self::NotFound => (StatusCode::NOT_FOUND, self.to_string()),Self::Validation(msg) => (StatusCode::BAD_REQUEST, msg.clone()),Self::Unauthorized => (StatusCode::UNAUTHORIZED, self.to_string()),- Self::Internal(err) => {+ Self::Database(err) => {+ tracing::error!(?err, "database error");+ (StatusCode::INTERNAL_SERVER_ERROR, "Internal error".into())+ }+ Self::Io(err) => {tracing::error!(?err, "internal error");(StatusCode::INTERNAL_SERVER_ERROR, "Internal error".into())}diff --git a/docs/ko-KR/examples/statusline.json b/docs/ko-KR/examples/statusline.jsonindex 4fa84e818..8c020fff4 100644--- a/docs/ko-KR/examples/statusline.json+++ b/docs/ko-KR/examples/statusline.json@@ -1,7 +1,7 @@{"statusLine": {"type": "command",- "command": "input=$(cat); user=$(whoami); cwd=$(echo \"$input\" | jq -r '.workspace.current_dir' | sed \"s|$HOME|~|g\"); model=$(echo \"$input\" | jq -r '.model.display_name'); time=$(date +%H:%M); remaining=$(echo \"$input\" | jq -r '.context_window.remaining_percentage // empty'); transcript=$(echo \"$input\" | jq -r '.transcript_path'); todo_count=$([ -f \"$transcript\" ] && grep -c '\"type\":\"todo\"' \"$transcript\" 2>/dev/null || echo 0); cd \"$(echo \"$input\" | jq -r '.workspace.current_dir')\" 2>/dev/null; branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo ''); status=''; [ -n \"$branch\" ] && { [ -n \"$(git status --porcelain 2>/dev/null)\" ] && status='*'; }; B='\\033[38;2;30;102;245m'; G='\\033[38;2;64;160;43m'; Y='\\033[38;2;223;142;29m'; M='\\033[38;2;136;57;239m'; C='\\033[38;2;23;146;153m'; R='\\033[0m'; T='\\033[38;2;76;79;105m'; printf \"${C}${user}${R}:${B}${cwd}${R}\"; [ -n \"$branch\" ] && printf \" ${G}${branch}${Y}${status}${R}\"; [ -n \"$remaining\" ] && printf \" ${M}ctx:${remaining}%%${R}\"; printf \" ${T}${model}${R} ${Y}${time}${R}\"; [ \"$todo_count\" -gt 0 ] && printf \" ${C}todos:${todo_count}${R}\"; echo",+ "command": "input=$(cat); user=$(whoami); cwd=$(echo \"$input\" | jq -r '.workspace.current_dir' | sed \"s|$HOME|~|g\"); model=$(echo \"$input\" | jq -r '.model.display_name'); time=$(date +%H:%M); remaining=$(echo \"$input\" | jq -r '.context_window.remaining_percentage // empty'); transcript=$(echo \"$input\" | jq -r '.transcript_path'); todo_count=$([ -f \"$transcript\" ] && { grep -c '\"type\":\"todo\"' \"$transcript\" 2>/dev/null || true; } || echo 0); cd \"$(echo \"$input\" | jq -r '.workspace.current_dir')\" 2>/dev/null; branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo ''); status=''; [ -n \"$branch\" ] && { [ -n \"$(git status --porcelain 2>/dev/null)\" ] && status='*'; }; B='\\033[38;2;30;102;245m'; G='\\033[38;2;64;160;43m'; Y='\\033[38;2;223;142;29m'; M='\\033[38;2;136;57;239m'; C='\\033[38;2;23;146;153m'; R='\\033[0m'; T='\\033[38;2;76;79;105m'; printf \"${C}${user}${R}:${B}${cwd}${R}\"; [ -n \"$branch\" ] && printf \" ${G}${branch}${Y}${status}${R}\"; [ -n \"$remaining\" ] && printf \" ${M}ctx:${remaining}%%${R}\"; printf \" ${T}${model}${R} ${Y}${time}${R}\"; [ \"$todo_count\" -gt 0 ] && printf \" ${C}todos:${todo_count}${R}\"; echo","description": "Custom status line showing: user:path branch* ctx:% model time todos:N"},"_comments": {diff --git a/docs/ko-KR/rules/agents.md b/docs/ko-KR/rules/agents.mdindex c26b8c535..0f2b8fd13 100644--- a/docs/ko-KR/rules/agents.md+++ b/docs/ko-KR/rules/agents.md@@ -13,6 +13,9 @@| security-reviewer | 보안 분석 | 커밋 전 || build-error-resolver | 빌드 에러 수정 | 빌드 실패 시 || e2e-runner | E2E 테스팅 | 핵심 사용자 흐름 |+| database-reviewer | 데이터베이스 스키마/쿼리 리뷰 | 스키마 설계, 쿼리 최적화 |+| go-reviewer | Go 코드 리뷰 | Go 코드 작성 또는 수정 후 |+| go-build-resolver | Go 빌드 에러 수정 | `go build` 또는 `go vet` 실패 시 || refactor-cleaner | 사용하지 않는 코드 정리 | 코드 유지보수 || doc-updater | 문서 관리 | 문서 업데이트 |diff --git a/docs/ko-KR/rules/git-workflow.md b/docs/ko-KR/rules/git-workflow.mdindex f3efb92bf..56cd58654 100644--- a/docs/ko-KR/rules/git-workflow.md+++ b/docs/ko-KR/rules/git-workflow.md@@ -9,7 +9,7 @@타입: feat, fix, refactor, docs, test, chore, perf, ci-참고: 어트리뷰션은 ~/.claude/settings.json에서 전역적으로 비활성화되어 있습니다.+참고: 어트리뷰션 비활성화 여부는 각자의 `~/.claude/settings.json` 로컬 설정에 따라 달라질 수 있습니다.## Pull Request 워크플로우diff --git a/docs/ko-KR/skills/backend-patterns/SKILL.md b/docs/ko-KR/skills/backend-patterns/SKILL.mdindex 5118b328a..b0f45a10f 100644--- a/docs/ko-KR/skills/backend-patterns/SKILL.md+++ b/docs/ko-KR/skills/backend-patterns/SKILL.md@@ -42,6 +42,7 @@ GET /api/markets?status=active&sort=volume&limit=20&offset=0interface MarketRepository {findAll(filters?: MarketFilters): Promise<Market[]>findById(id: string): Promise<Market | null>+ findByIds(ids: string[]): Promise<Market[]>create(data: CreateMarketDto): Promise<Market>update(id: string, data: UpdateMarketDto): Promise<Market>delete(id: string): Promise<void>@@ -85,7 +86,7 @@ class MarketService {const markets = await this.marketRepo.findByIds(results.map(r => r.id))// Sort by similarity- return markets.sort((a, b) => {+ return [...markets].sort((a, b) => {const scoreA = results.find(r => r.id === a.id)?.score || 0const scoreB = results.find(r => r.id === b.id)?.score || 0return scoreA - scoreB@@ -320,7 +321,7 @@ async function fetchWithRetry<T>(fn: () => Promise<T>,maxRetries = 3): Promise<T> {- let lastError: Error+ let lastError: Error = new Error('Retry attempts exhausted')for (let i = 0; i < maxRetries; i++) {try {diff --git a/docs/ko-KR/skills/clickhouse-io/SKILL.md b/docs/ko-KR/skills/clickhouse-io/SKILL.mdindex 736667b85..024272477 100644--- a/docs/ko-KR/skills/clickhouse-io/SKILL.md+++ b/docs/ko-KR/skills/clickhouse-io/SKILL.md@@ -51,7 +51,7 @@ SETTINGS index_granularity = 8192;### ReplacingMergeTree (중복 제거)```sql--- For data that may have duplicates (e.g., from multiple sources)+-- 중복이 있을 수 있는 데이터용 (예: 여러 소스에서 수집된 경우)CREATE TABLE user_events (event_id String,user_id String,@@ -67,7 +67,7 @@ PRIMARY KEY (user_id, event_id);### AggregatingMergeTree (사전 집계)```sql--- For maintaining aggregated metrics+-- 집계 메트릭을 유지하기 위한 용도CREATE TABLE market_stats_hourly (hour DateTime,market_id String,@@ -78,7 +78,7 @@ CREATE TABLE market_stats_hourly (PARTITION BY toYYYYMM(hour)ORDER BY (hour, market_id);--- Query aggregated data+-- 집계된 데이터 조회SELECThour,market_id,@@ -96,7 +96,7 @@ ORDER BY hour DESC;### 효율적인 필터링```sql--- ✅ GOOD: Use indexed columns first+-- ✅ 좋음: 인덱스된 컬럼을 먼저 사용SELECT *FROM markets_analyticsWHERE date >= '2025-01-01'@@ -105,7 +105,7 @@ WHERE date >= '2025-01-01'ORDER BY date DESCLIMIT 100;--- ❌ BAD: Filter on non-indexed columns first+-- ❌ 나쁨: 비인덱스 컬럼을 먼저 필터링SELECT *FROM markets_analyticsWHERE volume > 1000@@ -116,7 +116,7 @@ WHERE volume > 1000### 집계```sql--- ✅ GOOD: Use ClickHouse-specific aggregation functions+-- ✅ 좋음: ClickHouse 전용 집계 함수를 사용SELECTtoStartOfDay(created_at) AS day,market_id,@@ -129,7 +129,7 @@ WHERE created_at >= today() - INTERVAL 7 DAYGROUP BY day, market_idORDER BY day DESC, total_volume DESC;--- ✅ Use quantile for percentiles (more efficient than percentile)+-- ✅ 백분위수에는 quantile 사용 (percentile보다 효율적)SELECTquantile(0.50)(trade_size) AS median,quantile(0.95)(trade_size) AS p95,@@ -141,7 +141,7 @@ WHERE created_at >= now() - INTERVAL 1 HOUR;### 윈도우 함수```sql--- Calculate running totals+-- 누적 합계 계산SELECTdate,market_id,@@ -172,25 +172,22 @@ const clickhouse = new ClickHouse({}})-// ✅ Batch insert (efficient)+// ✅ 배치 삽입 (효율적)async function bulkInsertTrades(trades: Trade[]) {- const values = trades.map(trade => `(- '${trade.id}',- '${trade.market_id}',- '${trade.user_id}',- ${trade.amount},- '${trade.timestamp.toISOString()}'- )`).join(',')+ const rows = trades.map(trade => ({+ id: trade.id,+ market_id: trade.market_id,+ user_id: trade.user_id,+ amount: trade.amount,+ timestamp: trade.timestamp.toISOString()+ }))- await clickhouse.query(`- INSERT INTO trades (id, market_id, user_id, amount, timestamp)- VALUES ${values}- `).toPromise()+ await clickhouse.insert('trades', rows)}-// ❌ Individual inserts (slow)+// ❌ 개별 삽입 (느림)async function insertTrade(trade: Trade) {- // Don't do this in a loop!+ // 루프 안에서 이렇게 하지 마세요!await clickhouse.query(`INSERT INTO trades VALUES ('${trade.id}', ...)`).toPromise()@@ -200,7 +197,7 @@ async function insertTrade(trade: Trade) {### 스트리밍 삽입```typescript-// For continuous data ingestion+// 연속적인 데이터 수집용import { createWriteStream } from 'fs'import { pipeline } from 'stream/promises'@@ -220,7 +217,7 @@ async function streamInserts() {### 실시간 집계```sql--- Create materialized view for hourly stats+-- 시간별 통계를 위한 materialized view 생성CREATE MATERIALIZED VIEW market_stats_hourly_mvTO market_stats_hourlyAS SELECT@@ -232,7 +229,7 @@ AS SELECTFROM tradesGROUP BY hour, market_id;--- Query the materialized view+-- materialized view 조회SELECThour,market_id,@@ -249,7 +246,7 @@ GROUP BY hour, market_id;### 쿼리 성능```sql--- Check slow queries+-- 느린 쿼리 확인SELECTquery_id,user,@@ -269,7 +266,7 @@ LIMIT 10;### 테이블 통계```sql--- Check table sizes+-- 테이블 크기 확인SELECTdatabase,table,@@ -287,7 +284,7 @@ ORDER BY sum(bytes) DESC;### 시계열 분석```sql--- Daily active users+-- 일간 활성 사용자SELECTtoDate(timestamp) AS date,uniq(user_id) AS daily_active_users@@ -296,7 +293,7 @@ WHERE timestamp >= today() - INTERVAL 30 DAYGROUP BY dateORDER BY date;--- Retention analysis+-- 리텐션 분석SELECTsignup_date,countIf(days_since_signup = 0) AS day_0,@@ -319,7 +316,7 @@ ORDER BY signup_date DESC;### 퍼널 분석```sql--- Conversion funnel+-- 전환 퍼널SELECTcountIf(step = 'viewed_market') AS viewed,countIf(step = 'clicked_trade') AS clicked,@@ -340,7 +337,7 @@ GROUP BY session_id;### 코호트 분석```sql--- User cohorts by signup month+-- 가입 월별 사용자 코호트SELECTtoStartOfMonth(signup_date) AS cohort,toStartOfMonth(activity_date) AS month,@@ -362,12 +359,12 @@ ORDER BY cohort, months_since_signup;### ETL 패턴```typescript-// Extract, Transform, Load+// 추출, 변환, 적재(ETL)async function etlPipeline() {- // 1. Extract from source+ // 1. 소스에서 추출const rawData = await extractFromPostgres()- // 2. Transform+ // 2. 변환const transformed = rawData.map(row => ({date: new Date(row.created_at).toISOString().split('T')[0],market_id: row.market_slug,@@ -375,18 +372,29 @@ async function etlPipeline() {trades: parseInt(row.trade_count)}))- // 3. Load to ClickHouse+ // 3. ClickHouse에 적재await bulkInsertToClickHouse(transformed)}-// Run periodically-setInterval(etlPipeline, 60 * 60 * 1000) // Every hour+// 주기적으로 실행+let etlRunning = false++setInterval(async () => {+ if (etlRunning) return++ etlRunning = true+ try {+ await etlPipeline()+ } finally {+ etlRunning = false+ }+}, 60 * 60 * 1000) // Every hour```### 변경 데이터 캡처 (CDC)```typescript-// Listen to PostgreSQL changes and sync to ClickHouse+// PostgreSQL 변경을 수신하고 ClickHouse와 동기화import { Client } from 'pg'const pgClient = new Client({ connectionString: process.env.DATABASE_URL })diff --git a/docs/ko-KR/skills/coding-standards/SKILL.md b/docs/ko-KR/skills/coding-standards/SKILL.mdindex e3e708f8d..1fbabe7da 100644--- a/docs/ko-KR/skills/coding-standards/SKILL.md+++ b/docs/ko-KR/skills/coding-standards/SKILL.md@@ -397,7 +397,7 @@ import { useMemo, useCallback } from 'react'// ✅ GOOD: Memoize expensive computationsconst sortedMarkets = useMemo(() => {- return markets.sort((a, b) => b.volume - a.volume)+ return [...markets].sort((a, b) => b.volume - a.volume)}, [markets])// ✅ GOOD: Memoize callbacksdiff --git a/docs/ko-KR/skills/continuous-learning/SKILL.md b/docs/ko-KR/skills/continuous-learning/SKILL.mdindex d279ec32e..e5de6c3de 100644--- a/docs/ko-KR/skills/continuous-learning/SKILL.md+++ b/docs/ko-KR/skills/continuous-learning/SKILL.md@@ -77,6 +77,35 @@ Claude Code 세션 종료 시 자동으로 평가하여 학습된 스킬로 저}```+## 예시++### 자동 패턴 추출 설정 예시++```json+{+ "min_session_length": 10,+ "extraction_threshold": "medium",+ "auto_approve": false,+ "learned_skills_path": "~/.claude/skills/learned/"+}+```++### Stop Hook 연결 예시++```json+{+ "hooks": {+ "Stop": [{+ "matcher": "*",+ "hooks": [{+ "type": "command",+ "command": "~/.claude/skills/continuous-learning/evaluate-session.sh"+ }]+ }]+ }+}+```+## Stop Hook을 사용하는 이유- **경량**: 세션 종료 시 한 번만 실행@@ -116,4 +145,4 @@ Homunculus v2는 더 정교한 접근법을 취합니다:4. **도메인 태깅** - code-style, testing, git, debugging 등5. **진화 경로** - 관련 본능을 스킬/명령어로 클러스터링-자세한 사양은 `docs/continuous-learning-v2-spec.md`를 참조하세요.+자세한 사양은 [`continuous-learning-v2-spec.md`](../../../continuous-learning-v2-spec.md)를 참조하세요.diff --git a/docs/ko-KR/skills/frontend-patterns/SKILL.md b/docs/ko-KR/skills/frontend-patterns/SKILL.mdindex cf3cdd45a..f384bc807 100644--- a/docs/ko-KR/skills/frontend-patterns/SKILL.md+++ b/docs/ko-KR/skills/frontend-patterns/SKILL.md@@ -154,6 +154,8 @@ const [isOpen, toggleOpen] = useToggle()### 비동기 데이터 페칭 Hook```typescript+import { useCallback, useEffect, useRef, useState } from 'react'+interface UseQueryOptions<T> {onSuccess?: (data: T) => voidonError?: (error: Error) => void@@ -168,6 +170,14 @@ export function useQuery<T>(const [data, setData] = useState<T | null>(null)const [error, setError] = useState<Error | null>(null)const [loading, setLoading] = useState(false)+ const successRef = useRef(options?.onSuccess)+ const errorRef = useRef(options?.onError)+ const enabled = options?.enabled !== false++ useEffect(() => {+ successRef.current = options?.onSuccess+ errorRef.current = options?.onError+ }, [options?.onSuccess, options?.onError])const refetch = useCallback(async () => {setLoading(true)@@ -176,21 +186,21 @@ export function useQuery<T>(try {const result = await fetcher()setData(result)- options?.onSuccess?.(result)+ successRef.current?.(result)} catch (err) {const error = err as ErrorsetError(error)- options?.onError?.(error)+ errorRef.current?.(error)} finally {setLoading(false)}- }, [fetcher, options])+ }, [fetcher])useEffect(() => {- if (options?.enabled !== false) {+ if (enabled) {refetch()}- }, [key, refetch, options?.enabled])+ }, [key, enabled, refetch])return { data, error, loading, refetch }}@@ -296,7 +306,7 @@ export function useMarkets() {```typescript// ✅ useMemo for expensive computationsconst sortedMarkets = useMemo(() => {- return markets.sort((a, b) => b.volume - a.volume)+ return [...markets].sort((a, b) => b.volume - a.volume)}, [markets])// ✅ useCallback for functions passed to childrendiff --git a/docs/ko-KR/skills/golang-patterns/SKILL.md b/docs/ko-KR/skills/golang-patterns/SKILL.mdindex 63548e872..ab830154d 100644--- a/docs/ko-KR/skills/golang-patterns/SKILL.md+++ b/docs/ko-KR/skills/golang-patterns/SKILL.md@@ -533,7 +533,8 @@ func ProcessRequest(data []byte) []byte {buf.Write(data)// Process...- return buf.Bytes()+ out := append([]byte(nil), buf.Bytes()...)+ return out}```diff --git a/docs/ko-KR/skills/security-review/SKILL.md b/docs/ko-KR/skills/security-review/SKILL.mdindex 6b6878cd3..8dba9dbf6 100644--- a/docs/ko-KR/skills/security-review/SKILL.md+++ b/docs/ko-KR/skills/security-review/SKILL.md@@ -215,8 +215,8 @@ const securityHeaders = [key: 'Content-Security-Policy',value: `default-src 'self';- script-src 'self' 'unsafe-eval' 'unsafe-inline';- style-src 'self' 'unsafe-inline';+ script-src 'self' 'nonce-{nonce}';+ style-src 'self' 'nonce-{nonce}';img-src 'self' data: https:;font-src 'self';connect-src 'self' https://api.example.com;@@ -225,6 +225,8 @@ const securityHeaders = []```+`{nonce}`는 요청마다 새로 생성하고, 헤더와 인라인 `<script>`/`<style>` 태그에 동일하게 주입해야 합니다.+#### 확인 단계- [ ] 사용자 제공 HTML이 새니타이징됨- [ ] CSP 헤더가 구성됨@@ -339,7 +341,9 @@ catch (error) {#### 지갑 검증```typescript-import { verify } from '@solana/web3.js'+import nacl from 'tweetnacl'+import bs58 from 'bs58'+import { PublicKey } from '@solana/web3.js'async function verifyWalletOwnership(publicKey: string,@@ -347,18 +351,23 @@ async function verifyWalletOwnership(message: string) {try {- const isValid = verify(- Buffer.from(message),- Buffer.from(signature, 'base64'),- Buffer.from(publicKey, 'base64')+ const publicKeyBytes = new PublicKey(publicKey).toBytes()+ const signatureBytes = bs58.decode(signature)+ const messageBytes = new TextEncoder().encode(message)++ return nacl.sign.detached.verify(+ messageBytes,+ signatureBytes,+ publicKeyBytes)- return isValid} catch (error) {return false}}```+참고: Solana 공개 키와 서명은 일반적으로 base64가 아니라 base58로 인코딩됩니다.+#### 트랜잭션 검증```typescriptasync function verifyTransaction(transaction: Transaction) {diff --git a/docs/ko-KR/skills/security-review/cloud-infrastructure-security.md b/docs/ko-KR/skills/security-review/cloud-infrastructure-security.mdindex b60514180..183aa82d3 100644--- a/docs/ko-KR/skills/security-review/cloud-infrastructure-security.md+++ b/docs/ko-KR/skills/security-review/cloud-infrastructure-security.md@@ -195,7 +195,7 @@ jobs:# Scan for secrets- name: Secret scanning- uses: trufflesecurity/trufflehog@main+ uses: trufflesecurity/trufflehog@6c05c4a00b91aa542267d8e32a8254774799d68d# Dependency audit- name: Audit dependencies@@ -215,7 +215,7 @@ jobs:// package.json - Use lock files and integrity checks{"scripts": {- "install": "npm ci", // Use ci for reproducible builds+ "deps:install": "npm ci", // Use ci for reproducible builds"audit": "npm audit --audit-level=moderate","check": "npm outdated"}diff --git a/docs/ko-KR/skills/strategic-compact/SKILL.md b/docs/ko-KR/skills/strategic-compact/SKILL.mdindex e58f4a66e..a45adfc67 100644--- a/docs/ko-KR/skills/strategic-compact/SKILL.md+++ b/docs/ko-KR/skills/strategic-compact/SKILL.md@@ -45,12 +45,14 @@ origin: ECC"hooks": {"PreToolUse": [{- "matcher": "Edit",- "hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]- },- {- "matcher": "Write",- "hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]+ "matcher": "Edit|Write",+ "hooks": [+ {+ "type": "command",+ "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" \"pre:edit-write:suggest-compact\" \"scripts/hooks/suggest-compact.js\" \"standard,strict\""+ }+ ],+ "description": "Suggest manual compaction at logical intervals"}]}diff --git a/docs/ko-KR/skills/tdd-workflow/SKILL.md b/docs/ko-KR/skills/tdd-workflow/SKILL.mdindex 74a29398e..ee16f68ae 100644--- a/docs/ko-KR/skills/tdd-workflow/SKILL.md+++ b/docs/ko-KR/skills/tdd-workflow/SKILL.md@@ -191,11 +191,9 @@ test('user can search and filter markets', async ({ page }) => {// Search for marketsawait page.fill('input[placeholder="Search markets"]', 'election')- // Wait for debounce and results- await page.waitForTimeout(600)-- // Verify search results displayed+ // Wait for stable search results instead of sleepingconst results = page.locator('[data-testid="market-card"]')+ await expect(results.first()).toBeVisible({ timeout: 5000 })await expect(results).toHaveCount(5, { timeout: 5000 })// Verify results contain search term@@ -300,7 +298,7 @@ npm run test:coverage```json{"jest": {- "coverageThresholds": {+ "coverageThreshold": {"global": {"branches": 80,"functions": 80,diff --git a/docs/ko-KR/skills/verification-loop/SKILL.md b/docs/ko-KR/skills/verification-loop/SKILL.mdindex 0571b6a06..ca9a5a0a7 100644--- a/docs/ko-KR/skills/verification-loop/SKILL.md+++ b/docs/ko-KR/skills/verification-loop/SKILL.md@@ -77,7 +77,8 @@ grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | hea```bash# Show what changedgit diff --stat-git diff HEAD~1 --name-only+git diff --name-only+git diff --cached --name-only```각 변경된 파일에서 다음을 검토합니다: