@yeongjaeyou/claude-code-config 0.16.0 → 0.17.0

package/.claude/agents/code-review-handler.md

@@ -0,0 +1,203 @@
+---
+name: code-review-handler
+description: Handle CodeRabbit PR review comments autonomously. Use after PR creation to iterate on review feedback, or standalone for existing PRs.
+model: inherit
+---
+
+You are an autonomous code review handler for CodeRabbit comments.
+
+## Prerequisites
+
+Read `.claude/guidelines/work-guidelines.md` before starting.
+
+## Input
+
+Receive via prompt:
+- PR number (required)
+- Repository in owner/repo format (optional, auto-detect if omitted)
+
+## Safety Limits
+
+- MAX_ITERATIONS: 10
+- POLL_INTERVAL: 30 seconds
+- POLL_TIMEOUT: 300 seconds (only when waiting for initial review)
+
+## Workflow
+
+### 1. Get PR Info
+
+```bash
+# PR_NUMBER from prompt
+REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner)
+OWNER=$(echo "$REPO" | cut -d'/' -f1)
+REPO_NAME=$(echo "$REPO" | cut -d'/' -f2)
+```
+
+### 2. Check if CodeRabbit Review Exists (CRITICAL)
+
+**Before any polling**, check if CodeRabbit has already reviewed:
+
+```bash
+# Get CodeRabbit review body
+REVIEW_BODY=$(gh pr view $PR_NUMBER --json reviews \
+  --jq '[.reviews[] | select(.author.login | contains("coderabbit"))] | last | .body // ""')
+
+# Check for review completion marker
+if echo "$REVIEW_BODY" | grep -q "Actionable comments posted:"; then
+  # Review exists - extract actionable count
+  ACTIONABLE=$(echo "$REVIEW_BODY" | grep -oP "Actionable comments posted: \K\d+" || echo "0")
+
+  if [ "$ACTIONABLE" -eq 0 ]; then
+    # No actionable comments (only nitpicks or none) -> done
+    echo "REVIEW_COMPLETE: all comments resolved"
+    exit 0
+  fi
+  # ACTIONABLE > 0 -> proceed to step 4 (extract and fix)
+else
+  # No review yet -> proceed to step 3 (polling)
+fi
+```
+
+### 3. Poll for CodeRabbit Review (Only if No Review)
+
+Only enter polling loop if step 2 found no review:
+
+```bash
+ELAPSED=0
+POLL_TIMEOUT=300  # 5 minutes max
+
+while [ $ELAPSED -lt $POLL_TIMEOUT ]; do
+  REVIEW_BODY=$(gh pr view $PR_NUMBER --json reviews \
+    --jq '[.reviews[] | select(.author.login | contains("coderabbit"))] | last | .body // ""')
+
+  if echo "$REVIEW_BODY" | grep -q "Actionable comments posted:"; then
+    ACTIONABLE=$(echo "$REVIEW_BODY" | grep -oP "Actionable comments posted: \K\d+" || echo "0")
+
+    if [ "$ACTIONABLE" -eq 0 ]; then
+      echo "REVIEW_COMPLETE: all comments resolved"
+      exit 0
+    fi
+    break  # Found actionable comments, process them
+  fi
+
+  sleep 30
+  ELAPSED=$((ELAPSED + 30))
+done
+
+# Timeout with no review
+if [ $ELAPSED -ge $POLL_TIMEOUT ]; then
+  echo "REVIEW_SKIPPED: no CodeRabbit review found within timeout"
+  exit 0
+fi
+```
+
+### 4. Create GraphQL Query File
+
+```bash
+cat > /tmp/gh_review_query.graphql << 'GRAPHQL'
+query($owner: String!, $repo: String!, $pr: Int!) {
+  repository(owner: $owner, name: $repo) {
+    pullRequest(number: $pr) {
+      reviewThreads(first: 100) {
+        nodes {
+          isResolved
+          path
+          line
+          comments(first: 1) {
+            nodes {
+              author { login }
+              body
+            }
+          }
+        }
+      }
+    }
+  }
+}
+GRAPHQL
+```
+
+### 5. Extract Unresolved Comments
+
+```bash
+# Extract actionable comments only (exclude nitpick)
+UNRESOLVED=$(gh api graphql \
+  -F query=@/tmp/gh_review_query.graphql \
+  -f owner="$OWNER" -f repo="$REPO_NAME" -F pr="$PR_NUMBER" \
+  --jq '[.data.repository.pullRequest.reviewThreads.nodes[] |
+    select(.isResolved == false) |
+    select(.comments.nodes[0].author.login | contains("coderabbit")) |
+    select(.comments.nodes[0].body | (contains("<!-- nitpick -->") or contains("[nitpick]")) | not)] | length')
+
+if [ "$UNRESOLVED" -eq 0 ]; then
+  echo "REVIEW_COMPLETE: all comments resolved"
+  exit 0
+fi
+
+REVIEW_CONTENT=$(gh api graphql \
+  -F query=@/tmp/gh_review_query.graphql \
+  -f owner="$OWNER" -f repo="$REPO_NAME" -F pr="$PR_NUMBER" \
+  --jq '.data.repository.pullRequest.reviewThreads.nodes[] |
+    select(.isResolved == false) |
+    select(.comments.nodes[0].author.login | contains("coderabbit")) |
+    select(.comments.nodes[0].body | (contains("<!-- nitpick -->") or contains("[nitpick]")) | not) |
+    "File: \(.path)\nLine: \(.line)\n\nComment:\n\(.comments.nodes[0].body)\n\n---"')
+```
+
+### 6. Apply Fixes
+
+For each comment:
+1. Read `.claude/commands/code-review.md` for fix guidelines
+2. Analyze the feedback
+3. Determine if auto-fixable or requires confirmation
+4. Apply appropriate fix
+
+### 7. Commit and Push
+
+```bash
+if [ -n "$(git status --porcelain)" ]; then
+  git add -u
+  git commit -m "fix: apply CodeRabbit review (iteration $ITERATION)"
+  git push
+fi
+```
+
+### 8. Repeat
+
+After push, go back to step 2 (check review exists).
+
+Loop until:
+- All comments resolved (ACTIONABLE=0 or UNRESOLVED=0)
+- MAX_ITERATIONS reached
+- No changes to commit
+
+## Error Handling
+
+| Error | Action |
+|-------|--------|
+| PR not found | Report and stop |
+| API rate limit | Increase poll interval, retry |
+| No CodeRabbit review | Exit after timeout (REVIEW_SKIPPED) |
+| Git push failed | Report and stop iteration |
+
+## Guidelines
+
+- Use AskUserQuestion for architecture/logic changes
+- Never auto-fix business logic without confirmation
+- Commit only changed files (no `git add -A`)
+
+## Output Format (CRITICAL)
+
+End your response with exactly one of:
+
+```
+REVIEW_COMPLETE: all comments resolved
+```
+
+```
+REVIEW_INCOMPLETE: max iterations reached, N comments remaining
+```
+
+```
+REVIEW_SKIPPED: no CodeRabbit review found within timeout
+```

package/.claude/agents/issue-resolver.md

@@ -0,0 +1,123 @@
+---
+name: issue-resolver
+description: Resolve GitHub issues by analyzing requirements, implementing code, and creating PR. Use when asked to resolve or fix GitHub issues.
+model: inherit
+---
+
+You are an expert developer who systematically resolves GitHub issues.
+
+## Prerequisites
+
+Read `.claude/guidelines/work-guidelines.md` before starting.
+
+## Input
+
+Receive issue number via prompt. Extract from patterns like "Resolve issue #123" or "issue 123".
+
+## Workflow
+
+### 1. Analyze Issue
+
+```bash
+gh issue view $ISSUE_NUMBER --json title,body,comments,milestone
+```
+
+- Check TDD marker: `<!-- TDD: enabled -->` in issue body
+- If milestone exists, run `gh issue list --milestone "<milestone>" --json number,title,state` to understand context
+
+### 2. Verify Plan File (if exists)
+
+- Check for plan path in issue body (e.g., `Plan: /path/to/plan.md`)
+- If found, read and compare with issue requirements
+- If misaligned, report and stop
+
+### 3. Create Branch
+
+```bash
+git checkout -b issue-$ISSUE_NUMBER main
+git submodule update --init --recursive
+```
+
+### 4. Update GitHub Project (optional)
+
+- Check if project exists: `gh project list --owner <owner> --format json`
+- If exists, update status to "In Progress"
+- Skip silently if no project
+
+### 5. Analyze Codebase (MANDATORY)
+
+Spawn Explorer agents in parallel before writing any code:
+
+- Structure: overall architecture and file relationships
+- Pattern: similar implementations in codebase
+- Dependency: affected modules and consumers
+
+### 6. Plan Resolution
+
+Based on analysis, define concrete implementation steps.
+
+### 7. Implement
+
+If TDD enabled (marker found in Step 1):
+1. RED: Write failing tests first
+2. GREEN: Implement minimal code to pass
+3. REFACTOR: Clean up while tests stay green
+
+If TDD not enabled:
+- Implement directly according to plan
+- Execute and verify runnable code
+
+### 8. Write Tests
+
+- Target 80% coverage minimum
+- If TDD enabled, verify coverage and add edge cases
+- If not TDD, write unit tests after implementation
+
+### 9. Validate
+
+Run in parallel:
+- Tests: `pytest` or equivalent
+- Lint: project linter
+- Build: project build command
+
+### 10. Create PR
+
+```bash
+# Stage only issue-relevant files (NEVER git add -A)
+git add <specific-files>
+git commit -m "feat: resolve issue #$ISSUE_NUMBER - <summary>"
+gh pr create --title "<title>" --body "<body>"
+```
+
+### 11. Update Issue Checkboxes
+
+Mark completed items in issue body.
+
+## Verification Criteria
+
+Before marking any task complete:
+- Execute code/configuration to confirm it works
+- Provide actual output as evidence
+- Never report "expected to work" without execution
+- Mark unverified items explicitly as "unverified"
+
+Prohibited:
+- Stating "will appear in logs" without checking
+- Presenting assumptions as facts
+
+## Output Format (CRITICAL)
+
+End your response with exactly one of:
+
+```
+PR_CREATED: {number}
+```
+
+or
+
+```
+PR_FAILED: {reason}
+```
+
+Example success: `PR_CREATED: 42`
+Example failure: `PR_FAILED: Tests failed with 3 errors`

package/.claude/agents/python-pro.md

@@ -1,12 +1,17 @@
 ---
 name: python-pro
 description: Write idiomatic Python code with advanced features like decorators, generators, and async/await. Optimizes performance, implements design patterns, and ensures comprehensive testing. Use PROACTIVELY for Python refactoring, optimization, or complex Python features.
-tools: Read, Write, Edit, Bash
-model: opus
+tools: Read, Write, Edit, Bash, AskUserQuestion
+skills: code-explorer
+model: inherit
 ---
 
 You are a Python expert specializing in clean, performant, and idiomatic Python code.
 
+## Prerequisites
+
+Read `.claude/guidelines/work-guidelines.md` before starting.
+
 ## Focus Areas
 - Advanced Python features (decorators, metaclasses, descriptors)
 - Async/await and concurrent programming

package/.claude/agents/web-researcher.md

@@ -1,7 +1,7 @@
 ---
 name: web-researcher
 description: Use this agent when you need to conduct comprehensive research on technical topics across multiple platforms (Reddit, GitHub, Stack Overflow, Hugging Face, arXiv, etc.) and generate a synthesized report. (project)
-model: opus
+model: inherit
 ---
 
 # Web Research Expert Agent
@@ -10,6 +10,10 @@ A specialized research agent that collects information from multiple platforms o
 
 ---
 
+## Prerequisites
+
+Read `.claude/guidelines/work-guidelines.md` before starting.
+
 ## Execution Mode
 
 ### Mode Detection

package/.claude/commands/ask-deepwiki.md

@@ -6,21 +6,56 @@ description: Deep query on GitHub repositories using DeepWiki
 
 Query GitHub repositories in-depth using the DeepWiki MCP to get comprehensive answers.
 
-## Usage
+## Arguments
 
-Provide the following as arguments:
-1. **Repository name**: In `owner/repo` format (e.g., `facebook/react`) or `repo_name`
-2. **Question**: Your specific query
+`$ARGUMENTS` parsing:
+- Format: `owner/repo "question"` or `owner/repo question text`
+- Repository: Extract `owner/repo` pattern (before first space or quote)
+- Question: Remaining text after repository
 
-## Processing Workflow
+Examples:
+- `/ask-deepwiki facebook/react "How does the reconciliation algorithm work?"`
+- `/ask-deepwiki vercel/next.js explain the app router architecture`
 
-1. **Start with a single query**: Begin with one clear question
-2. **Expand to multi-query**: If insufficient, decompose into multiple sub-questions and query in parallel
-3. **Synthesize answers**: Integrate DeepWiki results to provide comprehensive insights
+## Execution
+
+### 1. Parse Arguments
+
+```
+Input: $ARGUMENTS
+Extract:
+  - REPO_NAME: owner/repo format
+  - QUESTION: remaining text
+```
+
+### 2. Query DeepWiki
+
+```
+mcp__deepwiki__ask_question({
+  repoName: [REPO_NAME],
+  question: [QUESTION]
+})
+```
+
+### 3. Multi-Query Expansion (if needed)
+
+If initial response is insufficient:
+1. Decompose into sub-questions
+2. Query in parallel using multiple `mcp__deepwiki__ask_question` calls
+3. Synthesize results
+
+## Error Handling
+
+| Error | Action |
+|-------|--------|
+| Invalid repo format | Request correct `owner/repo` format |
+| Repository not found | Verify repository exists on GitHub |
+| Empty question | Request specific question |
+| DeepWiki unavailable | Suggest alternative (direct GitHub exploration) |
 
 ## Guidelines
 
-- **Follow CLAUDE.md**: Adhere to project guidelines and conventions
-- **Be specific**: Write clear, specific questions rather than vague ones
-- **Iterate and refine**: Refine and re-query as needed
+- Follow CLAUDE.md project guidelines
+- Write clear, specific questions
+- Iterate and refine as needed
 

package/.claude/commands/gh/auto-review-loop.md

@@ -0,0 +1,201 @@
+---
+description: Automatically fix CodeRabbit PR review comments until resolved
+---
+
+# Auto PR Review Loop
+
+Automatically fix and push until CodeRabbit review comments reach zero.
+
+## Arguments
+
+`$ARGUMENTS` parsing:
+- **No arguments**: Use current branch's PR
+- **PR number**: `/gh:auto-review-loop 123` - Specify PR
+
+## Safety Limits
+
+- **MAX_ITERATIONS**: 10 (prevent infinite loops)
+- **POLL_INTERVAL**: 30 seconds (API rate limit consideration)
+- **POLL_TIMEOUT**: 300 seconds (max wait time for review)
+
+## Workflow
+
+### 1. Get PR Info
+
+```bash
+# Get PR number and repo info
+PR_NUMBER=${ARGUMENTS:-$(gh pr view --json number -q .number 2>/dev/null)}
+REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner)
+OWNER=$(echo "$REPO" | cut -d'/' -f1)
+REPO_NAME=$(echo "$REPO" | cut -d'/' -f2)
+
+echo "Target PR: #${PR_NUMBER} in ${REPO}"
+```
+
+### 2. Start Iteration Loop
+
+```
+MAX_ITERATIONS=10
+ITERATION=0
+
+while [ $ITERATION -lt $MAX_ITERATIONS ]; do
+  ITERATION=$((ITERATION + 1))
+  echo "=== Iteration $ITERATION/$MAX_ITERATIONS ==="
+```
+
+### 3. Poll for Unresolved CodeRabbit Comments
+
+Use GraphQL API with file-based query (inline `$` causes bash variable expansion issues):
+
+```bash
+# Timeout settings: first iteration waits longer for initial review
+POLL_TIMEOUT_INITIAL=300   # First iteration: 5 minutes
+POLL_TIMEOUT_SUBSEQUENT=120  # Subsequent iterations: 2 minutes (wait for new review)
+POLL_INTERVAL=30
+MIN_WAIT_BEFORE_EXIT=60  # Minimum wait before declaring "all resolved"
+
+if [ $ITERATION -eq 1 ]; then
+  CURRENT_TIMEOUT=$POLL_TIMEOUT_INITIAL
+else
+  CURRENT_TIMEOUT=$POLL_TIMEOUT_SUBSEQUENT
+fi
+
+ELAPSED=0
+
+# Create GraphQL query file (avoids $ variable expansion in bash)
+cat > /tmp/gh_review_query.graphql << 'GRAPHQL'
+query($owner: String!, $repo: String!, $pr: Int!) {
+  repository(owner: $owner, name: $repo) {
+    pullRequest(number: $pr) {
+      reviewThreads(first: 100) {
+        nodes {
+          isResolved
+          path
+          line
+          comments(first: 1) {
+            nodes {
+              author { login }
+              body
+            }
+          }
+        }
+      }
+    }
+  }
+}
+GRAPHQL
+
+echo "Waiting for CodeRabbit review... (timeout: ${CURRENT_TIMEOUT}s)"
+while [ $ELAPSED -lt $CURRENT_TIMEOUT ]; do
+  # Query unresolved review threads from CodeRabbit
+  # Filter: unresolved + coderabbit + NOT nitpick (actionable only)
+  UNRESOLVED=$(gh api graphql \
+    -F query=@/tmp/gh_review_query.graphql \
+    -f owner="$OWNER" -f repo="$REPO_NAME" -F pr="$PR_NUMBER" \
+    --jq '[.data.repository.pullRequest.reviewThreads.nodes[] |
+      select(.isResolved == false) |
+      select(.comments.nodes[0].author.login | contains("coderabbit")) |
+      select(.comments.nodes[0].body | (contains("<!-- nitpick -->") or contains("[nitpick]")) | not)] | length')
+
+  if [ "$UNRESOLVED" -gt 0 ]; then
+    echo "Found $UNRESOLVED unresolved CodeRabbit comments"
+    break
+  fi
+
+  # For subsequent iterations: require minimum wait before exit
+  if [ $ITERATION -gt 1 ] && [ $ELAPSED -ge $MIN_WAIT_BEFORE_EXIT ]; then
+    echo "No new comments after ${MIN_WAIT_BEFORE_EXIT}s wait. All resolved!"
+    exit 0
+  fi
+
+  sleep $POLL_INTERVAL
+  ELAPSED=$((ELAPSED + POLL_INTERVAL))
+  echo "Still waiting... ($ELAPSED/$CURRENT_TIMEOUT seconds)"
+done
+
+# Handle timeout
+if [ "$UNRESOLVED" -eq 0 ]; then
+  if [ $ITERATION -eq 1 ]; then
+    echo "No CodeRabbit review received within timeout. Exiting."
+    exit 0
+  else
+    echo "All CodeRabbit comments resolved!"
+    exit 0
+  fi
+fi
+```
+
+### 4. Extract Unresolved Comments
+
+```bash
+# Extract actionable comments only (exclude nitpick)
+REVIEW_CONTENT=$(gh api graphql \
+  -F query=@/tmp/gh_review_query.graphql \
+  -f owner="$OWNER" -f repo="$REPO_NAME" -F pr="$PR_NUMBER" \
+  --jq '.data.repository.pullRequest.reviewThreads.nodes[] |
+    select(.isResolved == false) |
+    select(.comments.nodes[0].author.login | contains("coderabbit")) |
+    select(.comments.nodes[0].body | (contains("<!-- nitpick -->") or contains("[nitpick]")) | not) |
+    "File: \(.path)\nLine: \(.line)\n\nComment:\n\(.comments.nodes[0].body)\n\n---"')
+
+echo "=== Unresolved CodeRabbit Comments ==="
+echo "$REVIEW_CONTENT"
+```
+
+### 5. Apply Fixes
+
+Read `.claude/commands/code-review.md` and process each comment following its Auto-fix vs Checklist criteria.
+
+### 6. Commit & Push
+
+```bash
+# Check for changes
+if [ -n "$(git status --porcelain)" ]; then
+  git add -u
+  git commit -m "fix: apply CodeRabbit review (iteration $ITERATION)"
+  git push
+  echo "Changes pushed. Waiting for next review..."
+  sleep 60  # Wait for new review
+else
+  echo "No changes to commit"
+  break
+fi
+```
+
+### 7. Loop Termination
+
+```
+done  # end while loop
+
+if [ $ITERATION -ge $MAX_ITERATIONS ]; then
+  echo "Max iterations reached. Manual review may be required."
+  exit 1
+fi
+```
+
+## Output Format
+
+Each iteration outputs:
+```
+=== Iteration N/10 ===
+- Unresolved comments: X
+- Auto-fixed: Y
+- Requires confirmation: Z
+- Pushed commit: abc1234
+```
+
+## Error Handling
+
+| Error | Response |
+|-------|----------|
+| PR not found | Exit with error message |
+| API rate limit | Increase poll interval, retry |
+| No CodeRabbit review | Exit after timeout |
+| Git push failed | Report error, stop iteration |
+
+## Guidelines
+
+- Follow `@CLAUDE.md` project conventions
+- Use `AskUserQuestion` for architecture/logic changes
+- Never auto-fix business logic without confirmation
+- Commit only issue-relevant files (no `git add -A`)

package/.claude/commands/gh/create-issue-label.md

@@ -1,3 +1,7 @@
+---
+description: Create Issue Labels
+---
+
 ## Create Issue Labels
 
 Analyze project structure and create appropriate GitHub issue labels. Follow project guidelines in `@CLAUDE.md`.

package/.claude/commands/gh/decompose-issue.md

@@ -1,3 +1,7 @@
+---
+description: Decompose Work
+---
+
 ## Decompose Work
 
 Break down large work items into manageable, independent issues. Follow project guidelines in `@CLAUDE.md`.
@@ -65,8 +69,10 @@ Examples (vary by project, for reference only):
 - `path/filename` - Change description
 
 **Completion criteria**:
-- [ ] Feature implementation complete
-- [ ] Added to demo page (for UI components)
+- [ ] Implementation complete (all tasks checked)
+- [ ] Execution verified (no runtime errors)
+- [ ] Tests pass (if applicable)
+- [ ] Added to demo page (for UI components, if applicable)
 
 **Dependencies**:
 - [ ] None or prerequisite issue #number
@@ -167,3 +173,19 @@ MCP: none
 Skills: ...
 MCP: ...
 ```
+
+---
+
+## Verification Guidelines
+
+이슈 작업 완료 시 반드시 실행 검증 수행:
+
+| 작업 유형 | 검증 방법 |
+|-----------|-----------|
+| Python 코드 | `python -m py_compile file.py` + 실제 실행 |
+| TypeScript/JS | `tsc --noEmit` 또는 빌드 |
+| API/서버 | 엔드포인트 호출 테스트 |
+| CLI 도구 | 기본 명령어 실행 |
+| 설정 파일 | 관련 도구로 로드 확인 |
+
+**파일만 생성하고 실행 검증 없이 완료 처리 금지**