비개발자가 AI 코딩 도구를
"하네스"로 길들이는 법

• 응답 언어 — 한국어 기본, 코드·식별자·기술용어는 원문 유지
• 작업공간 포인터 — 홈(~)은 리포가 아니라 개인 작업공간. 진입 시 각 디렉토리의 자체 CLAUDE.md를 우선. LifeVault / InvestVault / ProjectsVault / AIVault / .cokacdir / .hermes / gas-projects / 뉴스레터 각각의 역할을 표로 명시
• 서버 표 — server1(arm-free-01, ssh server1, hermes gateway) · server2(arm-free-02, 배포·백엔드). "서버"라고만 하면 기본 server1
• 작업 원칙 — 파괴적 작업은 사용자 확인 후 / 자동 메모리의 개인정보·날짜·이메일은 거기서 읽기(중복 기재 금지) / 린터·포맷터·타입체커처럼 도구가 강제 가능한 건 산문 규칙 말고 훅으로 처리

// 토큰 절약 — 적응형 사고·1M 컨텍스트 의도적으로 끔
"env": {
  "CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING": "1",
  "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
},
"permissions": { "defaultMode": "auto", "allow": [ sqlcipher, kakao_query.py ] },
"effortLevel": "high",
"theme": "light",
"skipDangerousModePermissionPrompt": true,
"skipAutoPermissionPrompt": true,
"enabledPlugins": {
  "insane-search@gptaku-plugins": true,
  "claude-hud@jarrodwatts-claude-hud": true,   // 상태줄(statusLine)
  "superpowers@superpowers-marketplace": false   // 전역 휴면 ← 핵심
}

※ settings.local.json에는 머신 로컬 권한만 분리: WebSearch, WebFetch(domain:github.com)

• rm -rf 가 루트·홈·시스템 경로(/, ~, $HOME, /Users/x, /System 등)를 향할 때
• 포크밤 :(){ :|:& };:
• mkfs, dd if=/of=/dev/disk|sd|nvme — 디스크 포맷·블록장치 쓰기
• git push --force / -f (특히 main·master) · git reset --hard · git clean -fdx
• 루트·홈 대상 재귀 chmod/chown -R
• curl|wget … | sh/bash/sudo — 파이프-투-셸
• sudo rm/dd/mkfs

차단 시 "의도한 거면 터미널에서 직접 실행하라"는 메시지를 모델에 반환.

• .env 계열 · credentials(.json) · .npmrc/.pypirc/.netrc/.pgpass · .git-credentials
• SSH 개인키(id_rsa/id_ed25519 등) · .pem/.key/.p12/.pfx/.jks/.keystore
• 클라우드 인증: .aws/credentials, GCP ADC, Azure, .claude/.credentials.json, gh hosts.yml
• 예외 허용: *.example/.sample/.template/.dist (템플릿은 통과)

~/.claude/projects/-Users-hc/memory/MEMORY.md 본문을 읽어, "필요한 항목이 있으면 해당 파일을 Read하라(본문은 토큰 절약을 위해 주입 안 함)"는 안내와 함께 hookSpecificOutput.additionalContext로 세션 시작 시 주입한다.

• 파일 1개 = 사실 1개. frontmatter(name·description·type)와 본문으로 구성
• 타입 4종 — user(사용자) · feedback(작업방식 피드백) · project(진행 중 작업) · reference(외부 자료 포인터)
• MEMORY.md = 색인. 한 줄에 하나씩(제목 + 한 줄 훅). 세션마다 이 색인만 주입됨
• 현재 24개 항목 — 볼트 4종, OCI ARM 서버, 봇 서버, 장하세 대시보드, 온톨로지 랩, 포트폴리오, ThreadFolio, 작업방식 피드백 등
• 자가발전 = 인-세션 auto-memory + 주간 통합(패턴은 feedback_lessons.md로 수렴)

1. 사전 확인 — 현재 디렉토리가 정식 코딩 프로젝트인지(소스·패키지 매니페스트 존재) 검사. 볼트·단순 자동화면 "여긴 하네스가 과합니다. 정말 켤까요?" 확인. superpowers 플러그인 설치 여부도 점검
2. 그 프로젝트 settings.json에만 superpowers = true — 기존 키 보존하며 병합. 전역은 계속 false라 다른 곳엔 무영향. 이 폴더 세션에서만 SessionStart 개발 방법론이 켜짐
3. 프로젝트 .claude/CLAUDE.md 생성 — 스택·테스트·배포 자리표시 + 두 가지 핵심 규칙:
   · 학습모드: "사용자는 비개발자다. 등장하는 개념마다 쉬운 비유로 왜 그렇게 하는지 설명. '그냥 해'라면 줄임"
   · 작업규율(superpowers): "성급히 코딩 금지 — 조사 → 계획(승인) → TDD 실행 → 코드리뷰 → 마무리"
4. (선택) 에이전트팀 스캐폴딩 — 도메인이 여러 전문 역할을 요구하면(예: ERP=재고/회계/주문/리포트) revfactory/harness로 .claude/agents/ 팀 뼈대 생성을 제안(강제 아님)
5. 마무리 보고 — 무엇을 켰는지 쉬운 한국어로 요약, 다음 세션부터 자동 계획→실행→검수가 적용됨을 안내