selfish-pipeline 1.0.0

package/scripts/session-start-context.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# Session Start Hook: 세션 시작 시 파이프라인 상태 복원
+# resume/compact 후에도 진행 상태를 잃지 않도록 컨텍스트 주입
+#
+# Gap 해결: OMC의 세션 연속성 → 물리적 스크립트로 강제
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+# Auto-memory 디렉토리를 프로젝트 경로에서 동적 파생
+PROJECT_PATH=$(cd "$PROJECT_DIR" 2>/dev/null && pwd || echo "$PROJECT_DIR")
+ENCODED_PATH=$(echo "$PROJECT_PATH" | sed 's|/|-|g')
+MEMORY_DIR="$HOME/.claude/projects/$ENCODED_PATH/memory"
+CHECKPOINT="$MEMORY_DIR/checkpoint.md"
+PIPELINE_FLAG="$PROJECT_DIR/.claude/.selfish-active"
+
+OUTPUT=""
+
+# 1. 활성 파이프라인 확인
+if [ -f "$PIPELINE_FLAG" ]; then
+  FEATURE=$(cat "$PIPELINE_FLAG")
+  OUTPUT="[SELFISH PIPELINE ACTIVE] Feature: $FEATURE"
+
+  # tasks.md 진행 상태
+  TASKS_FILE="$PROJECT_DIR/specs/$FEATURE/tasks.md"
+  if [ -f "$TASKS_FILE" ]; then
+    DONE=$(grep -cE '\[x\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+    TOTAL=$(grep -cE '\[(x| )\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+    OUTPUT="$OUTPUT | Tasks: $DONE/$TOTAL"
+  fi
+
+  # CI 통과 여부
+  CI_FLAG="$PROJECT_DIR/.claude/.selfish-ci-passed"
+  if [ -f "$CI_FLAG" ]; then
+    OUTPUT="$OUTPUT | Last CI: PASSED ($(cat "$CI_FLAG"))"
+  fi
+fi
+
+# 2. 체크포인트 존재 확인
+if [ -f "$CHECKPOINT" ]; then
+  CHECKPOINT_DATE=$(grep '자동 생성:' "$CHECKPOINT" 2>/dev/null | head -1 | sed 's/.*자동 생성: //')
+  if [ -n "$CHECKPOINT_DATE" ]; then
+    if [ -n "$OUTPUT" ]; then
+      OUTPUT="$OUTPUT | Checkpoint: $CHECKPOINT_DATE"
+    else
+      OUTPUT="[CHECKPOINT EXISTS] Date: $CHECKPOINT_DATE — Run /selfish.resume to restore"
+    fi
+  fi
+fi
+
+# 3. Safety tag 확인
+BRANCH=$(cd "$PROJECT_DIR" 2>/dev/null && git branch --show-current 2>/dev/null)
+HAS_SAFETY_TAG=$(cd "$PROJECT_DIR" 2>/dev/null && git tag -l 'selfish/pre-*' 2>/dev/null | head -1)
+if [ -n "$HAS_SAFETY_TAG" ]; then
+  if [ -n "$OUTPUT" ]; then
+    OUTPUT="$OUTPUT | Safety tag: $HAS_SAFETY_TAG"
+  fi
+fi
+
+# 출력 (stdout → Claude 컨텍스트에 주입됨)
+if [ -n "$OUTPUT" ]; then
+  echo "$OUTPUT"
+fi
+
+exit 0

package/scripts/track-selfish-changes.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# PostToolUse Hook: 파일 변경 추적
+# Edit/Write 도구 사용 후 변경된 파일을 기록
+# CI 게이트에서 어떤 파일이 변경되었는지 추적
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+PIPELINE_FLAG="$PROJECT_DIR/.claude/.selfish-active"
+
+# jq 필수 의존성 확인
+if ! command -v jq &> /dev/null; then
+  exit 0
+fi
+CHANGES_LOG="$PROJECT_DIR/.claude/.selfish-changes.log"
+CI_FLAG="$PROJECT_DIR/.claude/.selfish-ci-passed"
+
+# 파이프라인 비활성이면 → 스킵
+if [ ! -f "$PIPELINE_FLAG" ]; then
+  exit 0
+fi
+
+# stdin에서 tool input 파싱
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null)
+
+if [ -n "$FILE_PATH" ]; then
+  # 변경 로그에 추가 (중복 제거)
+  echo "$FILE_PATH" >> "$CHANGES_LOG"
+  sort -u -o "$CHANGES_LOG" "$CHANGES_LOG"
+
+  # 파일이 변경되었으므로 CI 결과 무효화
+  rm -f "$CI_FLAG"
+fi
+
+exit 0

package/templates/selfish.config.nextjs-fsd.md

@@ -0,0 +1,107 @@
+# Selfish Configuration
+
+> 이 파일은 selfish 커맨드 시스템의 프로젝트별 설정을 정의한다.
+> 모든 selfish 커맨드는 이 파일을 참조하여 프로젝트별 동작을 결정한다.
+
+## CI Commands
+
+```yaml
+ci: "yarn ci"                           # 전체 CI (lint + typecheck + build)
+typecheck: "yarn typecheck"             # 타입 체크만
+lint: "yarn lint"                       # 린트만
+lint_fix: "yarn lint:fix"               # 린트 자동 수정
+gate: "yarn typecheck && yarn lint"     # Phase 게이트 (implement 중 반복 실행)
+test: "yarn test"                       # 테스트
+```
+
+## Architecture
+
+```yaml
+style: "FSD"                            # Feature-Sliced Design
+layers:                                 # 상위 → 하위 순서
+  - app
+  - views
+  - widgets
+  - features
+  - entities
+  - shared
+  - core
+import_rule: "상위 계층은 하위 계층만 import 가능 (역방향 불가)"
+segments:
+  - api       # API 관련 로직 (React Query hooks)
+  - model     # 상태 관리 및 타입 정의
+  - ui        # UI 컴포넌트
+  - lib       # 유틸리티 함수
+  - config    # 설정 및 상수
+  - hooks     # 커스텀 훅
+path_alias: "@/* → ./src/*"
+```
+
+## Framework
+
+```yaml
+name: "Next.js 14"
+runtime: "App Router"
+client_directive: "'use client'"
+client_directive_rule: >
+  useState/useEffect/useRef 등 클라이언트 훅을 사용하는 파일은
+  반드시 'use client' 선언 필요. barrel export(index.ts)를 통해
+  서버 컴포넌트에서 간접 import 되는 경우 특히 주의.
+server_client_boundary: true            # 서버/클라이언트 경계가 존재
+```
+
+## Code Style
+
+```yaml
+language: "TypeScript"
+strict_mode: true
+type_keyword: "type"                    # interface 대신 type 사용
+import_type: true                       # import type { ... } 사용
+component_style: "PascalCase"
+props_position: "above component"       # Props 타입은 컴포넌트 위에 정의
+handler_naming: "handle[Event]"
+boolean_naming: "is/has/can[State]"
+constant_naming: "UPPER_SNAKE_CASE"
+any_policy: "최소화 (strict mode 준수)"
+```
+
+## State Management
+
+```yaml
+global_state: "Zustand"
+server_state: "React Query v5"
+local_state: "Context API (use-context-selector)"
+store_location: "model/ 세그먼트"
+query_location: "api/ 세그먼트"
+```
+
+## Styling
+
+```yaml
+framework: "Tailwind CSS v3"
+```
+
+## Testing
+
+```yaml
+framework: "Jest + React Testing Library"
+```
+
+## Project-Specific Risks
+
+> Plan의 RISK Critic에서 반드시 점검할 프로젝트 고유 위험 패턴
+
+1. barrel export 체인에서 `'use client'` 누락 → build 실패
+2. import 순서 위반 (ESLint FSD import order)
+3. 순환 참조 (shared/ui 내부에서 barrel import 사용 시)
+4. FSD 계층 역방향 import
+5. `as any` 잔류 → typecheck 우회
+
+## Mini-Review Checklist
+
+> Implement Phase 게이트의 Mini-Review에서 각 파일에 대해 점검할 항목
+
+1. `'use client'` 필요 여부 (클라이언트 훅 사용 시 필수)
+2. FSD 계층 위반 (import 경로 N개 중 위반 M개)
+3. 프로젝트 패턴 (`type` vs `interface`, naming, import order)
+4. 미사용 코드 (미사용 import, 빈 export, dead code)

package/templates/selfish.config.template.md

@@ -0,0 +1,90 @@
+# Selfish Configuration
+
+> 이 파일은 selfish 커맨드 시스템의 프로젝트별 설정을 정의한다.
+> 모든 selfish 커맨드는 이 파일을 참조하여 프로젝트별 동작을 결정한다.
+> 각 섹션을 프로젝트에 맞게 수정하세요.
+
+## CI Commands
+
+```yaml
+ci: "npm run ci"                        # 전체 CI (lint + typecheck + build)
+typecheck: "npm run typecheck"          # 타입 체크만
+lint: "npm run lint"                    # 린트만
+lint_fix: "npm run lint:fix"            # 린트 자동 수정
+gate: "npm run typecheck && npm run lint"  # Phase 게이트 (implement 중 반복 실행)
+test: "npm test"                        # 테스트
+```
+
+## Architecture
+
+```yaml
+style: "Layered"                        # 예: FSD, Clean Architecture, Modular Monolith, Layered
+layers: []                              # 상위 → 하위 순서로 나열
+import_rule: ""                         # import 방향 규칙 (예: "상위→하위만 허용")
+segments: []                            # 각 계층의 하위 세그먼트
+path_alias: ""                          # 예: "@/* → ./src/*"
+```
+
+## Framework
+
+```yaml
+name: ""                                # 예: Next.js 14, Vite, CRA
+runtime: ""                             # 예: App Router, Pages Router
+client_directive: ""                    # 예: 'use client' (없으면 비워두기)
+client_directive_rule: ""               # 클라이언트 디렉티브 적용 규칙
+server_client_boundary: false           # 서버/클라이언트 경계 존재 여부
+```
+
+## Code Style
+
+```yaml
+language: "TypeScript"
+strict_mode: true
+type_keyword: "type"                    # type vs interface
+import_type: true                       # import type 사용 여부
+component_style: "PascalCase"
+props_position: "above component"
+handler_naming: "handle[Event]"
+boolean_naming: "is/has/can[State]"
+constant_naming: "UPPER_SNAKE_CASE"
+any_policy: "최소화"
+```
+
+## State Management
+
+```yaml
+global_state: ""                        # 예: Zustand, Redux, Pinia
+server_state: ""                        # 예: React Query, SWR, Apollo
+local_state: ""                         # 예: Context API, useState
+store_location: ""                      # store 파일 위치 패턴
+query_location: ""                      # query 파일 위치 패턴
+```
+
+## Styling
+
+```yaml
+framework: ""                           # 예: Tailwind CSS, styled-components, CSS Modules
+```
+
+## Testing
+
+```yaml
+framework: ""                           # 예: Jest, Vitest, Playwright
+```
+
+## Project-Specific Risks
+
+> Plan의 RISK Critic에서 반드시 점검할 프로젝트 고유 위험 패턴
+> 프로젝트에 맞게 수정하세요.
+
+1. (예시) import 순서 위반
+2. (예시) 순환 참조
+3. (예시) 타입 안전성 우회 (as any)
+
+## Mini-Review Checklist
+
+> Implement Phase 게이트의 Mini-Review에서 각 파일에 대해 점검할 항목
+
+1. 아키텍처 규칙 위반 여부
+2. 코드 스타일 패턴 준수
+3. 미사용 코드 (미사용 import, 빈 export, dead code)