메뉴
Use when user says "init harness", "하네스 초기화", "하네스 설정", "init rules", "프로젝트 룰 설정", "rules 초기화", "프로젝트 룰", "프로젝트 설정". Do NOT use for skill creation (use skill-guide) or Serena (use init-serena).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | init-harness |
| description | Use when user says "init harness", "하네스 초기화", "하네스 설정", "init rules", "프로젝트 룰 설정", "rules 초기화", "프로젝트 룰", "프로젝트 설정". Do NOT use for skill creation (use skill-guide) or Serena (use init-serena). |
프로젝트를 스캔하여 AI 에이전트가 자율적으로 작업할 수 있는 하네스(.claude/ 구성)를 생성한다.
| 산출물 | 역할 |
|---|---|
.claude/CLAUDE.md | 목차. 프로젝트 개요, 아키텍처 다이어그램, 파일 구조 맵, Quick commands. docs/와 rules/로의 포인터 |
.claude/docs/ARCHITECTURE.md | 시스템 지도 — 계층 구조, 데이터 흐름, 주요 컴포넌트 관계 |
| 산출물 | 역할 |
|---|---|
.claude/rules/{lang}/coding-style.md | 네이밍, 포매터/린터, 타입 시스템, 파일 조직 |
.claude/rules/{lang}/testing.md | 테스트 프레임워크, TDD, 커버리지 목표, 실행 명령어 |
.claude/rules/{lang}/security.md | 시크릿 관리, input validation, injection 방지 |
| 산출물 | 역할 |
|---|---|
.claude/docs/QUALITY_CHECKLIST.md | PR/작업 완료 전 확인 사항 (빌드, 테스트, 린트, 보안 스캔 명령어) |
.claude/ 유무 감지| 언어 | 감지 파일 | rules paths |
|---|---|---|
| Python | pyproject.toml, setup.py, requirements.txt | **/*.py |
| Java | pom.xml, build.gradle(.kts) + *.java | **/*.java |
| Kotlin | *.kt + kotlin plugin | **/*.kt, **/*.kts |
| TypeScript | tsconfig.json | **/*.ts, **/*.tsx |
| JavaScript | package.json (tsconfig 없을 때) | **/*.js, **/*.jsx |
| Go | go.mod | **/*.go |
| Rust | Cargo.toml | **/*.rs |
의존성 파일(pyproject.toml, package.json, pom.xml 등)을 읽어 프레임워크를 감지한다: FastAPI, Django, Flask, Spring Boot, Quarkus, Next.js, React, Vue, Express, NestJS, Gin, Echo, Axum 등.
paths frontmatter 포함| 언어 | 연결 가능 스킬 |
|---|---|
| Python | python-patterns, python-code-style, python-testing |
| Java | jpa-patterns, java-modern-patterns, springboot-patterns, springboot-security, springboot-tdd |
| Kotlin | kotlin-patterns, jpa-patterns |
| TypeScript/JS | react-best-practices |
| Go | golang-patterns |
CRITICAL: ~/.claude/skills/를 확인하여 실제 존재하는 스킬만 Reference에 추가한다.
| 함정 | 대응 |
|---|---|
| CLAUDE.md에 모든 것을 때려넣음 → 컨텍스트 희석 | CLAUDE.md는 목차, 상세는 docs/와 rules/에 분리 |
| 글로벌 스킬 내용을 rules에 복제 | rules는 "이것만은 꼭" 수준, 상세는 스킬 참조 |
| 코드를 안 읽고 추측으로 아키텍처 작성 | 실제 코드를 분석한 뒤 작성 |
| 기존 .claude/ 설정을 덮어씀 | 기존 파일 보호, 병합 제안 |
| monorepo에서 단일 언어만 감지 | 복수 언어 동시 스캔 및 생성 |
Use when GenOS 작업에서 얻은 재사용 가능한 지식(플랫폼 패턴·함정·고객사 결정)을 개인 Obsidian vault(Projects/GenonAI)에 기록할 가치가 생겼거나, GenOS 작업 맥락에서 사용자가 "지식 캡처", "vault에 정리/기록", "MOC", "읽는 순서", "field note", "/genos-knowledge-capture"를 요청할 때 사용. Do NOT use for: GenOS와 무관한 노트, 웹 리서치 기반 일반 개념 노트, 단순 진행상황·세션 상태.
Use when user says "wiki compile", "위키 컴파일", "raw 정리", "지식 컴파일", "소스 컴파일", or wants to compile raw sources into a structured wiki. Do NOT use for individual note creation (use obsidian-note) or vault maintenance (use vault-linter).
Use when user says "vault lint", "노트 점검", "vault 정리", "orphan notes", "링크 점검", or wants to check Obsidian vault health. Do NOT use for individual note creation (use obsidian-note) or tag management (use til-tagger).
Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts. Use when user says "다이어그램", "diagram", "excalidraw", "시각화", "아키텍처 그려". Do NOT use for Mermaid diagrams or draw.io.
Use when user mentions "Obsidian", "옵시디언", "write as note", "save to notes", "노트로 저장", or /obsidian-note command. Do NOT use for TIL (use til), YouTube notes (use youtube-summarizer), GenOS 작업 지식 캡처 (use genos-knowledge-capture), or deep/team/multi-angle note research (use agentic-notes).
Use when the user asks to create an Obsidian note with an agent team, deep research, strict verification, multiple angles, or phrases like "팀으로 조사해서 노트", "깊게 조사해서 옵시디언 노트", "/agentic-notes", "--team", "--verify strict", or "--deep". Do NOT use for a simple one-shot Obsidian note; use obsidian-note instead.