@yeongjaeyou/claude-code-config 0.16.0 → 0.17.0

package/.claude/skills/claude-md-generator/references/templates.md

@@ -0,0 +1,156 @@
+# Templates
+
+## Root CLAUDE.md Template
+
+```markdown
+# CLAUDE.md
+
+## Project Context
+
+[1-2 line business goal + tech stack summary]
+
+## Operational Commands
+
+```bash
+# [Package manager commands]
+[install command]
+[run command]
+[test command]
+```
+
+## Golden Rules
+
+### Immutable
+
+- [Non-negotiable security/architecture constraints]
+- [Critical patterns that must never be violated]
+
+### Do's
+
+- [Clear positive actions]
+- [Required patterns]
+
+### Don'ts
+
+- [Clear prohibitions]
+- [Anti-patterns to avoid]
+
+## Modular Rules
+
+See @.claude/rules/[module].md for [description]
+See @.claude/rules/[module].md for [description]
+
+## [Project-Specific Sections]
+
+[Data locations, submission tracking, deployment info, etc.]
+```
+
+## Rules File Template (General)
+
+```markdown
+---
+paths: [glob pattern, optional]
+---
+
+# [Module] Rules
+
+## Role
+
+[What this module does, 1-2 lines]
+
+## Dependencies
+
+- [Key external libraries]
+- [Internal module dependencies]
+
+## Patterns
+
+- [Common code patterns]
+- [File naming conventions]
+- [Directory structure expectations]
+
+## Do's
+
+- [Module-specific positive actions]
+- [Required patterns for this area]
+
+### Don'ts
+
+- [Module-specific prohibitions]
+- [Common mistakes to avoid]
+
+## Testing
+
+```bash
+[Module-specific test commands]
+```
+```
+
+## Rules File Template (Path-Specific)
+
+```markdown
+---
+paths: src/api/**/*.ts, src/api/**/*.tsx
+---
+
+# API Development Rules
+
+## Role
+
+Handle all backend API routes and server-side logic.
+
+## Patterns
+
+- All endpoints follow REST conventions
+- Use standard error response format
+- Include input validation on all routes
+
+## Do's
+
+- Validate all incoming data
+- Return consistent error structures
+- Log meaningful error context
+
+## Don'ts
+
+- Expose internal error details to clients
+- Skip authentication checks
+- Use raw SQL without parameterization
+```
+
+## Restructured Root Template
+
+When converting a large CLAUDE.md to modular structure:
+
+```markdown
+# CLAUDE.md
+
+## Project Context
+
+[Keep existing overview, condensed to 2-3 lines]
+
+## Operational Commands
+
+[Keep essential commands only]
+
+## Golden Rules
+
+### Immutable
+
+[Extract from existing, keep only critical rules]
+
+### Do's / Don'ts
+
+[Keep top 5-7 most important rules here]
+
+## Modular Rules
+
+Architecture and core pipeline: @.claude/rules/architecture.md
+Data processing and caching: @.claude/rules/data.md
+Model and inference: @.claude/rules/inference.md
+[Add more as needed based on existing sections]
+
+## [Keep minimal project-specific sections]
+
+[Submission tracking, data locations - things that change rarely]
+```

package/.claude/skills/hook-creator/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: hook-creator
+description: Create and configure Claude Code hooks for customizing agent behavior. Use when the user wants to (1) create a new hook, (2) configure automatic formatting, logging, or notifications, (3) add file protection or custom permissions, (4) set up pre/post tool execution actions, or (5) asks about hook events like PreToolUse, PostToolUse, Notification, etc.
+---
+
+# Hook Creator
+
+Create Claude Code hooks that execute shell commands at specific lifecycle events.
+
+## Hook Creation Workflow
+
+1. **Identify the use case** - Determine what the hook should accomplish
+2. **Select the appropriate event** - Choose from available hook events (see references/hook-events.md)
+3. **Design the hook command** - Write shell command that processes JSON input from stdin
+4. **Configure the matcher** - Set tool/event filter (use `*` for all, or specific tool names like `Bash`, `Edit|Write`)
+5. **Choose storage location** - User settings (`~/.claude/settings.json`) or project (`.claude/settings.json`)
+6. **Test the hook** - Verify behavior with a simple test case
+
+## Hook Configuration Structure
+
+```json
+{
+  "hooks": {
+    "<EventName>": [
+      {
+        "matcher": "<ToolPattern>",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "<shell-command>"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Common Patterns
+
+### Reading Input Data
+
+Hooks receive JSON via stdin. Use `jq` to extract fields:
+
+```bash
+# Extract tool input field
+jq -r '.tool_input.file_path'
+
+# Extract with fallback
+jq -r '.tool_input.description // "No description"'
+
+# Conditional processing
+jq -r 'if .tool_input.file_path then .tool_input.file_path else empty end'
+```
+
+### Exit Codes for PreToolUse
+
+- `0` - Allow the tool to proceed
+- `2` - Block the tool and provide feedback to Claude
+
+### Matcher Patterns
+
+- `*` - Match all tools
+- `Bash` - Match only Bash tool
+- `Edit|Write` - Match Edit or Write tools
+- `Read` - Match Read tool
+
+## Quick Examples
+
+**Log all bash commands:**
+```bash
+jq -r '"\(.tool_input.command)"' >> ~/.claude/bash-log.txt
+```
+
+**Auto-format TypeScript after edit:**
+```bash
+jq -r '.tool_input.file_path' | { read f; [[ "$f" == *.ts ]] && npx prettier --write "$f"; }
+```
+
+**Block edits to .env files:**
+```bash
+python3 -c "import json,sys; p=json.load(sys.stdin).get('tool_input',{}).get('file_path',''); sys.exit(2 if '.env' in p else 0)"
+```
+
+## Resources
+
+- **Hook Events Reference**: See `references/hook-events.md` for detailed event documentation with input/output schemas
+- **Example Configurations**: See `references/examples.md` for complete, tested hook configurations

package/.claude/skills/hook-creator/references/examples.md

@@ -0,0 +1,339 @@
+# Hook Examples
+
+Complete, tested hook configurations for common use cases.
+
+## Logging Hooks
+
+### Log All Bash Commands
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '\"\\(.tool_input.command) - \\(.tool_input.description // \"No description\")\"' >> ~/.claude/bash-command-log.txt"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Log All File Edits
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '\"[\\(now | strftime(\"%Y-%m-%d %H:%M:%S\"))] \\(.tool_name): \\(.tool_input.file_path)\"' >> ~/.claude/edit-log.txt"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Auto-Formatting Hooks
+
+### Format TypeScript Files
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.file_path' | { read file_path; if echo \"$file_path\" | grep -q '\\.tsx\\?$'; then npx prettier --write \"$file_path\" 2>/dev/null; fi; }"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Format Python Files with Black
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.file_path' | { read f; [[ \"$f\" == *.py ]] && black \"$f\" 2>/dev/null; }"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Format Go Files
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.file_path' | { read f; [[ \"$f\" == *.go ]] && gofmt -w \"$f\"; }"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## File Protection Hooks
+
+### Block Edits to Sensitive Files
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -c \"import json, sys; data=json.load(sys.stdin); path=data.get('tool_input',{}).get('file_path',''); blocked=['.env', 'package-lock.json', '.git/', 'secrets']; sys.exit(2 if any(p in path for p in blocked) else 0)\""
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Block Modifications to Production Directory
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input | .file_path // .command // \"\"' | grep -q '/prod/' && echo 'BLOCKED: Cannot modify production files' && exit 2 || exit 0"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Notification Hooks
+
+### macOS Desktop Notification
+
+```json
+{
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.message' | xargs -I{} osascript -e 'display notification \"{}\" with title \"Claude Code\"'"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Linux Desktop Notification
+
+```json
+{
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.message' | xargs -I{} notify-send 'Claude Code' '{}'"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Sound Notification (macOS)
+
+```json
+{
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "afplay /System/Library/Sounds/Glass.aiff"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Validation Hooks
+
+### Validate JSON Before Write
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -e '.tool_input | select(.file_path | endswith(\".json\")) | .content' | jq . > /dev/null 2>&1 || { echo 'Invalid JSON content'; exit 2; }"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Lint TypeScript Before Commit
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.command' | grep -q 'git commit' && npx eslint . --max-warnings 0 || exit 0"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Session Hooks
+
+### Initialize Environment on Session Start
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "[ -f .claude-env ] && source .claude-env"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Cleanup on Session End
+
+```json
+{
+  "hooks": {
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "rm -f /tmp/claude-session-* 2>/dev/null; exit 0"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Multiple Hooks Example
+
+Combine multiple hooks in one configuration:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -c \"import json,sys; p=json.load(sys.stdin).get('tool_input',{}).get('file_path',''); sys.exit(2 if '.env' in p else 0)\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.file_path' | { read f; [[ \"$f\" == *.ts ]] && npx prettier --write \"$f\" 2>/dev/null; exit 0; }"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "afplay /System/Library/Sounds/Glass.aiff"
+          }
+        ]
+      }
+    ]
+  }
+}
+```