@taejung3852/project-scaffold 0.1.0

package/.hooks/convention-check.sh

@@ -0,0 +1,79 @@
+#!/bin/bash
+# wiki/conventions/ 규칙 기반 pre-commit 검사
+# Node CLI 설치 시 .git/hooks/pre-commit 으로 복사됨
+
+WIKI_CONVENTIONS="wiki/conventions"
+FAILED=0
+
+if [ ! -d "$WIKI_CONVENTIONS" ]; then
+  echo "⚠️  wiki/conventions/ 없음. /wiki를 실행해 초기 설정을 진행하세요."
+  exit 0
+fi
+
+STAGED_FILES=()
+while IFS= read -r -d '' file; do
+  [ -f "$file" ] && STAGED_FILES+=("$file")
+done < <(git diff --cached --name-only --diff-filter=ACM -z)
+
+if [ ${#STAGED_FILES[@]} -eq 0 ]; then
+  exit 0
+fi
+
+echo "🔍 convention-check 실행 중..."
+
+# staged blob을 검사한다. working tree가 staged 내용과 달라도 커밋 대상만 판정한다.
+SECRET_PATTERN="(password|secret|api[_-]?key|token)[[:space:]]*[:=][[:space:]]*['\"][^'\"]{4,}"
+for file in "${STAGED_FILES[@]}"; do
+  if ! git show ":$file" 2>/dev/null | grep -Iq .; then
+    continue
+  fi
+  matches=$(git show ":$file" 2>/dev/null | grep -nEI "$SECRET_PATTERN" || true)
+  if [ -n "$matches" ]; then
+    echo ""
+    printf '🔴 [security] 하드코딩된 시크릿 의심: %s\n' "$file"
+    printf '%s\n' "$matches" | sed 's/^/   /'
+    FAILED=1
+  fi
+done
+
+PY_FILES=()
+JS_FILES=()
+for file in "${STAGED_FILES[@]}"; do
+  case "$file" in
+    *.py) PY_FILES+=("$file") ;;
+    *.js|*.jsx|*.ts|*.tsx) JS_FILES+=("$file") ;;
+  esac
+done
+
+if [ ${#PY_FILES[@]} -gt 0 ] && command -v pylint >/dev/null 2>&1; then
+  if ! pylint --errors-only --score=no -- "${PY_FILES[@]}"; then
+    echo "🔴 [pylint] 에러 발견"
+    FAILED=1
+  fi
+fi
+
+ESLINT=""
+if [ -x "node_modules/.bin/eslint" ]; then
+  ESLINT="node_modules/.bin/eslint"
+elif command -v eslint >/dev/null 2>&1; then
+  ESLINT=$(command -v eslint)
+fi
+
+if [ ${#JS_FILES[@]} -gt 0 ] && [ -n "$ESLINT" ]; then
+  if compgen -G ".eslintrc*" >/dev/null 2>&1 || compgen -G "eslint.config.*" >/dev/null 2>&1; then
+    if ! "$ESLINT" --quiet -- "${JS_FILES[@]}"; then
+      echo "🔴 [eslint] 에러 발견"
+      FAILED=1
+    fi
+  fi
+fi
+
+echo ""
+if [ "$FAILED" -eq 1 ]; then
+  echo "❌ convention-check 실패. 위반 사항을 수정 후 다시 커밋하세요."
+  echo "   상세 검사: /review"
+  exit 1
+fi
+
+echo "✅ convention-check 통과"
+exit 0

package/.hooks/devlog-auto.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# 커밋 후 raw/dev-logs/ 에 자동으로 dev-log 항목 생성
+# Node CLI 설치 시 .git/hooks/post-commit 으로 복사됨
+
+DATE=$(date +%Y-%m-%d)
+TIME=$(date +%H:%M)
+COMMIT_MSG=$(git log -1 --pretty=%B)
+COMMIT_HASH=$(git log -1 --pretty=%h)
+
+CHANGED_FILES=()
+while IFS= read -r -d '' file; do
+  CHANGED_FILES+=("$file")
+  [ ${#CHANGED_FILES[@]} -ge 20 ] && break
+done < <(git diff-tree --root --no-commit-id -r --name-only -z HEAD 2>/dev/null)
+
+DEV_LOG_DIR="raw/dev-logs"
+DEV_LOG_FILE="$DEV_LOG_DIR/${DATE}_dev-log_auto.md"
+mkdir -p "$DEV_LOG_DIR"
+
+if [ ! -f "$DEV_LOG_FILE" ]; then
+  cat > "$DEV_LOG_FILE" << FRONTMATTER
+---
+title: "${DATE} 개발 일지 (자동 생성)"
+raw_type: "dev-log"
+date: ${DATE}
+created: ${DATE}
+description: "${DATE} 커밋 기록 자동 수집"
+ingest_status: "⏳ pending"
+tags:
+  - "raw/dev-log"
+  - "auto-generated"
+---
+
+# ${DATE} 개발 일지
+FRONTMATTER
+  printf '📝 dev-log 생성: %s\n' "$DEV_LOG_FILE"
+else
+  printf '📝 dev-log 갱신: %s\n' "$DEV_LOG_FILE"
+fi
+
+{
+  printf '\n### 커밋 `%s` — %s\n\n' "$COMMIT_HASH" "$TIME"
+  printf '**메시지:**\n\n'
+  printf '%s\n' "$COMMIT_MSG" | sed 's/^/    /'
+  printf '\n**변경 파일:**\n\n'
+  if [ ${#CHANGED_FILES[@]} -eq 0 ]; then
+    printf '%s\n' '- (없음)'
+  else
+    for file in "${CHANGED_FILES[@]}"; do
+      safe_file=${file//$'\n'/\\n}
+      safe_file=${safe_file//$'\r'/\\r}
+      printf -- '- %s\n' "$safe_file"
+    done
+  fi
+} >> "$DEV_LOG_FILE"

package/.obsidian-template/appearance.json

@@ -0,0 +1,6 @@
+{
+  "cssTheme": "",
+  "enabledCssSnippets": [
+    "folder-colors"
+  ]
+}

package/.obsidian-template/core-plugins.json

@@ -0,0 +1,20 @@
+{
+  "file-explorer": true,
+  "global-search": true,
+  "graph": true,
+  "backlink": true,
+  "outgoing-link": true,
+  "page-preview": true,
+  "properties": true,
+  "switcher": true,
+  "command-palette": true,
+  "tag-pane": false,
+  "templates": false,
+  "daily-notes": false,
+  "word-count": false,
+  "outline": false,
+  "note-composer": false,
+  "slides": false,
+  "audio-recorder": false,
+  "file-recovery": true
+}

package/.obsidian-template/graph.json

@@ -0,0 +1,22 @@
+{
+  "collapse-filter": true,
+  "search": "",
+  "showTags": false,
+  "showAttachments": true,
+  "hideUnresolved": false,
+  "showOrphans": true,
+  "collapse-color-groups": true,
+  "colorGroups": [],
+  "collapse-display": true,
+  "showArrow": false,
+  "textFadeMultiplier": 0,
+  "nodeSizeMultiplier": 2,
+  "lineSizeMultiplier": 1,
+  "collapse-forces": true,
+  "centerStrength": 0.518713248970312,
+  "repelStrength": 10,
+  "linkStrength": 1,
+  "linkDistance": 100,
+  "scale": 1,
+  "close": false
+}

package/.obsidian-template/snippets/folder-colors.css

@@ -0,0 +1,55 @@
+/* project-scaffold — wiki/ 폴더 색상 그룹 */
+
+/* conventions/ — 파랑 (원칙·규범) */
+.nav-folder-title[data-path="conventions"] .nav-folder-title-content {
+  color: #4fc3f7;
+  font-weight: 600;
+}
+.nav-folder-title[data-path="conventions"] + .nav-folder-children .nav-file-title-content {
+  color: #b3e5fc;
+}
+
+/* decisions/ — 주황 (중요 판단) */
+.nav-folder-title[data-path="decisions"] .nav-folder-title-content {
+  color: #ffb74d;
+  font-weight: 600;
+}
+.nav-folder-title[data-path="decisions"] + .nav-folder-children .nav-file-title-content {
+  color: #ffe0b2;
+}
+
+/* devlog/ — 초록 (진행·성장) */
+.nav-folder-title[data-path="devlog"] .nav-folder-title-content {
+  color: #81c784;
+  font-weight: 600;
+}
+.nav-folder-title[data-path="devlog"] + .nav-folder-children .nav-file-title-content {
+  color: #c8e6c9;
+}
+
+/* meetings/ — 보라 (사람·소통) */
+.nav-folder-title[data-path="meetings"] .nav-folder-title-content {
+  color: #ce93d8;
+  font-weight: 600;
+}
+.nav-folder-title[data-path="meetings"] + .nav-folder-children .nav-file-title-content {
+  color: #e1bee7;
+}
+
+/* sources/ — 회색 (원본 자료) */
+.nav-folder-title[data-path="sources"] .nav-folder-title-content {
+  color: #90a4ae;
+  font-weight: 600;
+}
+.nav-folder-title[data-path="sources"] + .nav-folder-children .nav-file-title-content {
+  color: #cfd8dc;
+}
+
+/* synthesis/ — 핑크 (통찰·결론) */
+.nav-folder-title[data-path="synthesis"] .nav-folder-title-content {
+  color: #f48fb1;
+  font-weight: 600;
+}
+.nav-folder-title[data-path="synthesis"] + .nav-folder-children .nav-file-title-content {
+  color: #fce4ec;
+}

package/AGENT.md

@@ -0,0 +1,55 @@
+# AGENT.md
+
+> ⚠️ 설정 전 상태입니다. `/wiki`를 실행하면 현재 상태를 보고 초기 설정을 추천합니다.
+> 완료 후 이 파일은 프로젝트 맞춤 내용으로 갱신됩니다.
+
+## Intent Router
+
+사용자가 스킬명이나 하위 모드를 기억할 필요는 없다. 자연어 요청 의도에 맞는 스킬을 선택한다. `/wiki` 또는 `/brief`만 단독 호출되면 현재 맥락을 확인하고 가장 적절한 행동을 첫 번째 선택지로 추천한다.
+
+| 상황 | 사용할 스킬 |
+|---|---|
+| 프로젝트 최초 설정·컨벤션 재정의 | `/wiki` 내부 setup 라우트 |
+| 과거 결정·프로젝트 성격·컨벤션 질문 | `/wiki` 내부 query 라우트 |
+| 회의·결정 원문 보존 | `/wiki` 내부 capture 라우트 |
+| 현재 작업을 개발 기록으로 남김 | `/wiki` 내부 devlog 라우트 |
+| pending raw 소스를 wiki에 반영 | `/wiki` 내부 ingest 라우트 |
+| wiki 링크·모순·stale 상태 점검 | `/wiki` 내부 lint 라우트 |
+| 현재 상태·최근 변화·다음 우선순위 설명 | `/brief` |
+| dashboard·report·세션 인계 | `/brief`가 맥락에 따라 내부 라우팅 |
+| PR·push 전 변경사항과 컨벤션 검토 | `/review` |
+
+## 스킬 위치
+
+- `/wiki` → `skills/wiki/SKILL.md`
+- `/brief` → `skills/brief/SKILL.md`
+- `/review` → `skills/review/SKILL.md`
+
+관련 요청을 처리하기 전에 해당 `SKILL.md`를 읽고 필요한 참조 파일만 추가로 읽는다.
+
+## 항상 적용할 규칙
+
+- 프로젝트 질문에는 관련 wiki와 코드 근거를 먼저 확인한다.
+- `raw/` 원문은 상태 필드 외에는 수정하지 않는다.
+- 완료된 구현과 미래 계획을 구분하고, 미구현 항목에 임의 진행률을 부여하지 않는다.
+- 중요한 결정과 모순에는 출처를 남긴다.
+- PR 또는 push 의도가 보이면 `/review`를 제안하되 같은 작업에서 반복 제안하지 않는다.
+
+---
+
+## 비서 페르소나
+
+@SOUL.md
+
+---
+
+## 에이전트 무관 설계
+
+이 하네스는 특정 AI 에이전트에 종속되지 않는다.
+AGENT.md 하나가 모든 에이전트의 단일 진실 소스(source of truth)다.
+다른 에이전트로 전환 시: 해당 에이전트의 컨텍스트 파일에서 `@AGENT.md` 를 임포트하면 된다.
+
+예시:
+- Claude Code: `CLAUDE.md` → `@AGENT.md`
+- Cursor: `.cursorrules` → `@AGENT.md`
+- Continue: `.continuerc.json` → `@AGENT.md`

package/README.kr.md

@@ -0,0 +1,247 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/taejung3852/project-scaffold/master/assets/logo.png" width="200" alt="project-scaffold logo" />
+</p>
+
+# project-scaffold
+
+> AI에게 프로젝트 기억을 제공하고, 사람에게 프로젝트 통제권을 돌려주는 LLM Wiki 기반 개발 컨텍스트 레이어
+
+[![Node.js](https://img.shields.io/badge/CLI-Node.js_20+-339933?logo=nodedotjs&logoColor=white)](https://nodejs.org/)
+[![Markdown](https://img.shields.io/badge/Knowledge-LLM_Wiki-000000?logo=markdown)](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
+[![Skills](https://img.shields.io/badge/Core_Skills-3-1D3461)](./skills)
+
+<p align="center"><a href="README.md">English</a> | 한국어</p>
+
+---
+
+## 무엇을 해결하나
+
+AI 코딩 에이전트는 빠르지만 세션이 바뀌면 프로젝트 성격, 과거 결정, 사용자 성향과 작업 흐름을 잊기 쉽다. 반대로 모든 정보를 긴 프롬프트로 다시 설명하면 사람도 따라가기 어렵고 토큰도 낭비된다.
+
+project-scaffold는 두 레이어로 이 문제를 해결한다.
+
+- **Agent Memory Layer** — `raw/`와 `wiki/`에 프로젝트 컨텍스트를 축적한다.
+- **Human Control Plane** — 현재 목표, 최근 변화, 결정할 항목과 다음 행동을 짧게 브리핑한다.
+
+사용자는 12개 명령을 외우지 않는다. 에이전트는 요청 의도를 보고 `/wiki`, `/brief`, `/review` 중 하나를 선택한다.
+
+## 빠른 시작
+
+Node.js 20 이상과 Git 저장소가 필요하다.
+
+### 새 프로젝트
+
+```bash
+mkdir my-project && cd my-project
+git init
+npx @taejung3852/project-scaffold@latest init --agent claude-code,codex
+```
+
+AI 에이전트에서 다음을 입력한다.
+
+```text
+/wiki
+```
+
+컨벤션이 없는 상태를 감지해 “프로젝트 초기 설정”을 첫 번째로 추천한다.
+
+### 기존 프로젝트
+
+```bash
+cd /path/to/existing-project
+npx @taejung3852/project-scaffold@latest add --agent claude-code,cursor
+```
+
+기존 파일은 기본적으로 보존한다. scaffold 관리 파일까지 갱신하려면 명시적으로 `--force`를 사용한다.
+
+기존 12스킬 버전에서 마이그레이션할 때는 아래 명령이 이전 스킬과 자가 진화 파일을 제거한다. 수정한 기존 스킬도 삭제되므로 먼저 diff를 확인한다.
+
+```bash
+npx @taejung3852/project-scaffold@latest add --agent claude-code,codex --force
+```
+
+### 에이전트 추가와 상태 검사
+
+```bash
+npx @taejung3852/project-scaffold@latest add-agent --agent codex,cursor
+npx @taejung3852/project-scaffold@latest doctor
+```
+
+설치 상태는 `.project-scaffold/manifest.json`에 기록한다.
+
+## 핵심 스킬 3개
+
+### `/wiki` — 프로젝트 지식 수명주기
+
+`/wiki`만 입력하면 현재 프로젝트 상태를 읽고 할 일을 추천한다. 사용자는 아래 내부 기능 이름을 외울 필요가 없다.
+
+| 모드 | 역할 |
+|---|---|
+| `setup` | 코드베이스를 읽고 14개 카테고리 컨벤션 인터뷰 진행 |
+| `capture` | 회의·결정 원문을 `raw/`에 보존 |
+| `devlog` | git과 대화 컨텍스트로 개발 기록 초안 생성 |
+| `ingest` | pending raw 소스를 구조화된 wiki로 반영 |
+| `query` | 프로젝트 성격, 과거 결정과 기록을 근거로 답변 |
+| `lint` | 깨진 링크, 고아 페이지, 모순과 stale 정보 점검 |
+
+```text
+/wiki
+이 구조를 왜 선택했지?
+이 결정을 기록해줘
+```
+
+### `/brief` — 사람 중심 브리핑
+
+`/brief`만 입력하면 최근 git 상태와 devlog를 보고 가장 적절한 브리핑을 첫 번째 선택지로 보여준다.
+
+기본 브리핑은 다음 순서로 구성한다.
+
+1. 지금 무엇을 하는가
+2. 왜 하는가
+3. 마지막 확인 이후 무엇이 달라졌는가
+4. 내가 결정해야 할 것은 무엇인가
+5. 다음 한 단계는 무엇인가
+6. 근거 문서는 어디인가
+
+| 모드 | 역할 |
+|---|---|
+| 기본 | 30초 브리핑. 요청 시 5분·상세 보기로 확장 |
+| `dashboard` | TODO, 마일스톤, 최근 devlog와 주의 항목 갱신 |
+| `report` | 회의록, 인터뷰, ADR, 스프린트 리포트 생성 |
+| `handoff` | 다음 세션이나 다른 에이전트를 위한 인계 저장·복원 |
+
+```text
+/brief
+최근 변화까지 자세히 알려줘
+다음 세션용 인계를 남겨줘
+```
+
+### `/review` — 컨벤션 기반 변경사항 검토
+
+`wiki/conventions/`를 기준으로 정적 분석과 LLM 검토를 결합한다.
+
+- 네이밍과 아키텍처 의존성
+- 테스트 누락
+- 에러 처리
+- 보안과 하드코딩된 시크릿
+- 프로젝트 고유 리뷰 규칙
+
+자동 수정하지 않고 위반 근거와 수정 제안을 보여준다.
+
+## 사용자는 스킬명을 외울 필요가 없다
+
+`AGENT.md`가 intent router 역할을 한다.
+
+| 사용자 요청 | 에이전트 행동 |
+|---|---|
+| “지금 어디까지 했어?” | `/brief` |
+| “왜 이 DB를 선택했지?” | `/wiki`가 프로젝트 질의로 판단 |
+| “이 결정 기록해줘” | `/wiki`가 결정 기록으로 판단 |
+| “오늘 작업 정리해줘” | `/wiki`가 devlog로 판단 |
+| “PR 올리기 전에 봐줘” | `/review` |
+
+각 에이전트 설정 파일은 `AGENT.md`를 공통 진실 소스로 사용한다.
+
+## LLM Wiki 구조
+
+```text
+raw/                     사람이 남긴 불변 원본
+  └─ /wiki가 맥락에 따라 반영
+wiki/                    에이전트가 정리한 프로젝트 지식
+  ├─ conventions/        프로젝트 규칙
+  ├─ decisions/          기술·제품 결정
+  ├─ devlog/             정제된 개발 흐름
+  ├─ sources/            raw 소스 요약
+  ├─ synthesis/          여러 문서를 연결한 답변
+  ├─ index.md            탐색 진입점
+  ├─ dashboard.md        현재 상태
+  └─ log.md              wiki 작업 이력
+AGENT.md                 상황별 행동과 프로젝트 불변 규칙
+SOUL.md                  사용자 선호와 비서 페르소나
+```
+
+`raw/` 본문은 수정하지 않는다. wiki에서 모순이 발견되면 한쪽을 지우지 않고 양쪽 출처를 함께 보존한다.
+
+## 지원 에이전트
+
+공식 [`skills@1.5.16`](https://github.com/vercel-labs/skills) 레지스트리의 73개 에이전트 ID와 프로젝트 경로를 지원한다.
+
+| 경로 유형 | 예시 |
+|---|---|
+| `.agents/skills/` 공통 경로 | Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Amp, Warp, Zed 등 |
+| `.claude/skills/` | Claude Code |
+| `.continue/skills/` | Continue |
+| `.hermes/skills/` | Hermes Agent |
+| `.windsurf/skills/` | Windsurf |
+| 기타 고유 경로 | Goose, Kiro CLI, Roo Code, Qwen Code, AiderDesk 등 |
+
+```bash
+npx @taejung3852/project-scaffold@latest agents
+```
+
+전체 목록과 실제 설치 경로는 위 명령으로 확인한다. `--agent all`과 `--agent '*'`도 지원한다.
+
+CLI는 루트 `skills/{wiki,brief,review}`를 한 번 설치한 뒤 같은 경로를 사용하는 에이전트를 묶어서 상대 심링크를 생성한다. `--agent`를 생략하면 로컬 설치 흔적을 감지해 후보를 추천하고, 감지하지 못하면 범용 `.agents/skills/`를 기본값으로 사용한다. `claude`, `hermes` 같은 기존 별칭도 계속 지원한다.
+
+## 설치되는 구조
+
+```text
+[your-project]/
+├── .project-scaffold/manifest.json
+├── AGENT.md
+├── SOUL.md
+├── skills/
+│   ├── wiki/
+│   │   ├── SKILL.md
+│   │   └── references/
+│   ├── brief/
+│   │   ├── SKILL.md
+│   │   └── references/
+│   └── review/SKILL.md
+├── wiki/
+│   ├── index.md
+│   ├── dashboard.md
+│   ├── log.md
+│   └── devlog/
+├── raw/
+└── .hooks/
+```
+
+설치 진입점은 Node CLI 하나다. 기존 shell 설치기는 제거했다.
+
+## Git hooks
+
+- `pre-commit` — staged blob 기준으로 시크릿과 사용 가능한 정적 분석 규칙 점검. 공백 파일명을 안전하게 처리하고 도구를 자동 다운로드하지 않는다.
+- `post-commit` — 커밋 메시지와 변경 파일을 안전한 Markdown으로 `raw/dev-logs/`에 기록
+
+기존 hook이 있으면 기본적으로 덮어쓰지 않는다.
+
+## Obsidian과 Graphify
+
+- `wiki/`를 Obsidian vault로 열어 사람이 탐색할 수 있다.
+- Graphify가 설치되어 있으면 wiki 변경 후 지식 그래프를 갱신한다.
+- 둘 다 선택 기능이며 LLM Wiki의 기본 동작에는 필수가 아니다.
+
+## 개발과 배포
+
+```bash
+npm test
+npm run check
+npm pack --dry-run
+```
+
+모든 기능과 문서를 확정한 뒤 최초 publish를 수행한다.
+
+```bash
+npm publish --access public
+```
+
+## 현재 상태
+
+| 항목 | 상태 |
+|---|---|
+| Node CLI (`init`, `add`, `add-agent`, `agents`, `doctor`) | ✅ 구현 |
+| skills@1.5.16 기반 73개 에이전트 레지스트리 | ✅ 구현 |
+| 핵심 스킬 3개 (`wiki`, `brief`, `review`) | ✅ 구현 |
+| Hermes식 스킬 사용 추적·자가 진화 | 🗑️ 제거 |
+| npm 최초 publish | ⏳ 전체 수정 완료 후 진행 |