jinhak-ai-standard 2.7.0 → 2.7.1

package/.claude/scripts/readme-guard.cjs

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/**
+ * README Guard Hook
+ *
+ * git commit 시점에 README.md 업데이트 누락을 감지합니다.
+ * PreToolUse (Bash - git commit) 에서 실행됩니다.
+ *
+ * 동작:
+ * 1. staged 파일 목록을 확인
+ * 2. "중요 파일"이 변경되었는데 README.md가 staged에 없으면 경고
+ * 3. additionalContext로 Claude에게 README 업데이트를 요청
+ */
+
+const { execSync } = require('child_process');
+
+// 커밋 명령이 아니면 무시
+const command = process.env.command || '';
+if (!command.includes('commit')) {
+  process.exit(0);
+}
+
+try {
+  // staged 파일 목록
+  const staged = execSync('git diff --cached --name-only', { encoding: 'utf-8' })
+    .trim()
+    .split('\n')
+    .filter(Boolean);
+
+  if (staged.length === 0) {
+    process.exit(0);
+  }
+
+  // README.md가 이미 staged에 포함되어 있으면 OK
+  const readmeIncluded = staged.some(f =>
+    f.toLowerCase() === 'readme.md'
+  );
+
+  if (readmeIncluded) {
+    process.exit(0);
+  }
+
+  // README 업데이트가 필요할 수 있는 "중요 변경" 패턴
+  const significantPatterns = [
+    // 구조/설정 변경
+    /^CLAUDE\.md$/,
+    /^CHANGELOG\.md$/,
+    /^RELEASE_NOTES\.md$/,
+    /^QUICK_START_PROMPT\.md$/,
+    /^package\.json$/,
+    /^bin\//,
+    // 새 기능/스킬 추가
+    /^\.claude\/skills\//,
+    /^\.claude\/settings\.json$/,
+    /^\.claude\/scripts\//,
+    // 문서 구조 변경
+    /^templates\//,
+    /^security\//,
+    /^prompts\//,
+    // 주요 가이드 문서
+    /^VIBE_CODING_GUIDE\.md$/,
+    /^CODING_CONVENTIONS\.md$/,
+    /^ARCHITECTURE\.md$/,
+    /^PROJECT_STRUCTURE\.md$/,
+    /^SECURITY_ISMS\.md$/,
+    /^PROMPT-LIBRARY\.md$/,
+    /^PROMPT_LIBRARY_USAGE\.md$/,
+    // 스크립트/자동화
+    /^scripts\//,
+  ];
+
+  const significantChanges = staged.filter(file =>
+    significantPatterns.some(pattern => pattern.test(file))
+  );
+
+  if (significantChanges.length === 0) {
+    // 중요 변경이 아니면 무시
+    process.exit(0);
+  }
+
+  // 경고 출력 (additionalContext로 Claude에게 전달)
+  const fileList = significantChanges.map(f => `  - ${f}`).join('\n');
+
+  console.log(`[README Guard] ⚠️ README.md 업데이트 필요 가능성 감지
+
+다음 중요 파일이 변경되었지만 README.md가 커밋에 포함되지 않았습니다:
+${fileList}
+
+README.md에 반영이 필요한 변경인지 확인하세요.
+- 새 기능/스킬 추가 → README에 설명 추가
+- 버전 변경 → README 버전 번호 갱신
+- 구조 변경 → README 구조 설명 업데이트
+- 적용 방법 변경 → README 설치/적용 가이드 업데이트
+
+커밋을 진행하기 전에 사용자에게 README.md 업데이트 여부를 확인하세요.`);
+
+} catch (e) {
+  // git 명령 실패 시 조용히 무시 (hook이 커밋을 막지 않도록)
+  process.exit(0);
+}

package/.claude/settings.json

@@ -71,6 +71,15 @@
             "command": "node scripts/security-check-hook.cjs"
           }
         ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/scripts/readme-guard.cjs"
+          }
+        ]
       }
     ],
     "PostToolUse": [

package/.claude/skills/apply-standard/SKILL.md

@@ -141,7 +141,7 @@ Auto Memory가 활성화되어 있습니다.
 
 > **중요**: `deny` 규칙은 프로젝트 전체에 **강제 적용**됩니다. `settings.local.json`이나 `~/.claude/settings.json`으로 우회할 수 없으므로, 위험 명령 차단에 가장 확실한 방법입니다. `deny`가 `allow`보다 우선합니다.
 
-> Hook은 Node.js 기반으로 작성되어 OS별 변환이 필요 없습니다. Windows/macOS/Linux 모두 동일한 설정을 사용합니다.
+> Hook은 bash 셸에서 실행됩니다. Unix 문법을 사용할 수 있으며, Windows 전용 문법(`> nul`, `powershell`)만 피하면 OS 무관하게 동작합니다.
 
 **Scripts 복사** - 표준 저장소의 세션 브리핑 스크립트를 복사:
 - `/tmp/jinhak-standards/.claude/scripts/session-briefing.cjs` → `.claude/scripts/session-briefing.cjs`

package/CHANGELOG.md

@@ -5,6 +5,23 @@ Claude Code의 `/session-start` 스킬이 이 파일을 참조하여 표준 업
 
 ---
 
+## [2.7.1] - 2026-03-12
+
+### README Guard Hook — 커밋 시 README.md 업데이트 누락 자동 감지
+
+커밋 시점에 중요 파일이 변경되었지만 README.md가 staged에 포함되지 않은 경우 Claude에게 경고를 전달하여 자동으로 README 업데이트를 유도합니다.
+
+### 추가
+- `.claude/scripts/readme-guard.cjs` — PreToolUse Hook 스크립트 (git commit 시 README.md 누락 감지)
+- `.claude/settings.json` — PreToolUse Hook에 readme-guard.cjs 등록
+
+### 동작 방식
+- `git commit` 실행 전 staged 파일 분석
+- CLAUDE.md, skills, templates, scripts, security 등 중요 파일 변경 감지
+- README.md 미포함 시 additionalContext로 경고 → Claude가 사용자에게 확인 요청
+
+---
+
 ## [2.7] - 2026-03-04
 
 ### CLI 기술 스택 자동 감지 + CLAUDE.md 완전 자동 생성

package/CLAUDE.md

@@ -62,8 +62,8 @@
 
 ```
 프로젝트루트/
-├── package.json           # npm 패키지 설정 — npx jinhak-ai-standard (v2.6)
-├── bin/cli.cjs            # CLI 진입점 (apply/info/link/help) (v2.6)
+├── package.json           # npm 패키지 설정 — npx jinhak-ai-standard (v2.7)
+├── bin/cli.cjs            # CLI 진입점 (apply/info/link/help + 기술 스택 자동 감지) (v2.7)
 ├── .github/workflows/     # GitHub Actions (release.yml → 태그 push 시 Release + npm publish) (v2.6)
 ├── CLAUDE.md              # Claude Code 메인 설정 파일 (필수)
 ├── CLAUDE.local.md        # 로컬 개발자 설정 (git 제외, 선택사항)
@@ -204,19 +204,18 @@ Claude는 다음 안티패턴을 감지하면 **즉시 경고하고 대안을
 > 상세 내용: [security/AI_SECURITY_GUARDRAILS.md](./security/AI_SECURITY_GUARDRAILS.md)
 > 상세 안티패턴 목록과 대화 예시는 [VIBE_CODING_GUIDE.md](./VIBE_CODING_GUIDE.md) 섹션 6.4~6.5를 참조하세요.
 
-### 2.5 Hook 크로스 플랫폼 원칙
+### 2.5 Hook 실행 환경 및 규칙
 
-**모든 Hook 명령은 Node.js 기반으로 작성**하여 OS(Windows/macOS/Linux)에 관계없이 동일하게 동작하도록 합니다. Claude Code는 Node.js를 필수 의존성으로 요구하므로, `node` 명령은 모든 환경에서 사용 가능합니다.
+**Claude Code의 Hook은 bash 셸에서 실행**됩니다. 따라서 Unix 문법(`2>/dev/null`, `||`, `&&` 등)을 사용할 수 있으며, `node`, `npx`, `git` 등 bash PATH에 있는 모든 명령을 사용할 수 있습니다.
 
 **필수 규칙:**
-- Hook command는 `node` 또는 `node -e` 로 시작할 것
-- `echo`, `cat`, `head`, `sed`, `powershell` 등 OS 종속 명령을 Hook에서 사용하지 말 것
-- 출력 리다이렉션(`> nul`, `2>/dev/null`) 대신 Node.js 내부에서 에러를 처리할 것
-- 파일 경로는 `path.join()`으로 생성하고 슬래시(`/`)로 통일할 것
+- Windows 전용 문법 사용 금지: `> nul`, `2>nul`, `powershell -Command` 등
+- 파일 경로는 슬래시(`/`)로 통일할 것 (백슬래시 `\` 금지)
+- 복잡한 로직은 `.cjs` 스크립트로 분리하여 `node script.cjs`로 실행 권장
 
 **Windows `nul` 파일 방지:**
-- `> nul`, `2>nul` 사용 금지 (예약 디바이스 이름 충돌로 `nul` 파일 생성)
-- `settings.local.json`의 PostToolUse Hook으로 도구 실행 후 `nul` 파일 자동 삭제
+- `> nul`, `2>nul` 사용 금지 (Windows 예약 디바이스 이름 충돌로 `nul` 파일 생성)
+- bash 환경에서는 `> /dev/null 2>&1` 사용
 
 ### 2.6 Windows 개발 환경 규칙
 
@@ -507,7 +506,7 @@ body: { action: 'delete', id: '123' }
 }
 ```
 
-> Hook은 Node.js 기반으로 OS에 무관하게 동작합니다. 세션 브리핑, 보안 경고 등 모든 Hook command가 `node`로 시작하도록 작성하세요.
+> Hook은 bash 셸에서 실행됩니다. `node`, `npx` 등 bash에서 사용 가능한 명령과 Unix 문법(`2>/dev/null`, `||` 등)을 모두 사용할 수 있습니다. Windows 전용 문법(`> nul`, `powershell`)은 사용하지 마세요.
 
 ### 6.1.1 글로벌 Hook (자동 표준 감지)
 
@@ -1165,4 +1164,4 @@ AI가 생성해서는 안 되는 12가지 위험 패턴:
 ---
 
 *마지막 업데이트: 2026-03-01*
-*버전: 2.6*
+*버전: 2.7*

package/QUICK_START_PROMPT.md

@@ -99,7 +99,7 @@ CLAUDE.local.md
 
 ```bash
 mkdir -p /tmp/jinhak-standards
-curl -sL https://github.com/JinhakStandard/ai-vibecoding/archive/refs/tags/v2.6.tar.gz \
+curl -sL https://github.com/JinhakStandard/ai-vibecoding/archive/refs/tags/v2.7.tar.gz \
   | tar -xz -C /tmp/jinhak-standards --strip-components=1
 ```
 

package/README.md

@@ -1,4 +1,4 @@
-# JINHAK AI 개발 표준 v2.6 (AI Vibe Coding Standards)
+# JINHAK AI 개발 표준 v2.7 (AI Vibe Coding Standards)
 
 JINHAK 전사에서 AI(Claude Code / Claude.ai)와 협업할 때 따라야 하는 개발 표준 문서입니다.
 
@@ -105,9 +105,9 @@ claude
 
 > 각 프로젝트의 CLAUDE.md에 다음 메타 정보가 기록되어 추적됩니다:
 > ```html
-> <!-- jinhak_standard_version: 2.6 -->
+> <!-- jinhak_standard_version: 2.7 -->
 > <!-- jinhak_standard_repo: https://github.com/JinhakStandard/ai-vibecoding -->
-> <!-- applied_date: 2026-03-02 -->
+> <!-- applied_date: 2026-03-04 -->
 > ```
 
 ---
@@ -166,7 +166,8 @@ JinhakStandard/
 ├── .claude/                      # Claude Code 설정 (표준 템플릿)
 │   ├── settings.json             #   권한, hooks 설정
 │   ├── scripts/
-│   │   └── session-briefing.cjs  #   세션 자동 브리핑 Hook 스크립트
+│   │   ├── session-briefing.cjs  #   세션 자동 브리핑 Hook 스크립트
+│   │   └── readme-guard.cjs      #   커밋 시 README.md 누락 감지 (v2.7.1)
 │   └── skills/                   #   슬래시 명령어 (14개)
 │       ├── apply-standard/       #   /apply-standard - 표준 적용/업데이트
 │       ├── commit/               #   /commit - 커밋 생성
@@ -303,7 +304,9 @@ claude
 
 | 버전 | 날짜 | 변경 내용 |
 |------|------|----------|
-| **2.6** | **2026-03-02** | **npm 패키지 + GitHub Releases 배포: `npx jinhak-ai-standard` CLI (CLAUDE.md 자동 생성/업데이트, prompts/ 복사 포함)** |
+| **2.7.1** | **2026-03-12** | **README Guard Hook: 커밋 시 중요 파일 변경 시 README.md 업데이트 누락 자동 감지** |
+| 2.7 | 2026-03-04 | CLI 기술 스택 자동 감지 + CLAUDE.md 완전 자동 생성: `npx jinhak-ai-standard` 실행 시 package.json 분석하여 기술 스택 자동 반영 |
+| 2.6 | 2026-03-02 | npm 패키지 + GitHub Releases 배포: `npx jinhak-ai-standard` CLI (CLAUDE.md 자동 생성/업데이트, prompts/ 복사 포함) |
 | 2.5 | 2026-03-01 | 프롬프트 라이브러리 Phase 2: JABIS API 연동, `/prompt-report` 스킬, 사용량 추적 |
 | 2.4 | 2026-02-28 | 프롬프트 라이브러리 Phase 1: 등록/검색/품질검증 시스템, 예시 프롬프트 3개, `/prompt-register` `/prompt-search` `/prompt-quality-check` 스킬 |
 | 2.3 | 2026-02-28 | 적응적 추천 + skills.sh 모범사례 + 멀티 에이전트 패턴: 가중치 비평, C6 Hard Gate, State Contract, 스킬 조합 가이드, 2단계 검증, `/debug` 스킬, AI 합리화 방지 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jinhak-ai-standard",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "description": "JINHAK 전사 AI 개발 표준 — Claude Code 프로젝트 자동 적용 도구",
   "bin": {
     "jinhak-ai-standard": "./bin/cli.cjs"

package/templates/project-claude.md

@@ -5,7 +5,7 @@
 ---
 
 <!-- JINHAK Standard Metadata - 이 메타 정보는 자동 버전 관리에 사용됩니다. 삭제하지 마세요. -->
-<!-- jinhak_standard_version: 2.0 -->
+<!-- jinhak_standard_version: 2.7 -->
 <!-- jinhak_standard_repo: [표준 저장소 URL - https://github.com/JinhakStandard/ai-vibecoding 로 교체] -->
 <!-- applied_date: [YYYY-MM-DD] -->