@yeongjaeyou/claude-code-config 0.16.0 → 0.17.0

package/.claude/commands/gh/post-merge.md

@@ -54,16 +54,37 @@ Perform branch cleanup and CLAUDE.md updates after a PR has been merged. Follow
 6. **Analyze and Update Configuration Files**
    - Check which configuration files exist:
      - `CLAUDE.md` - Claude Code specific instructions
-     - `AGENTS.md` - Cross-tool AI coding agent instructions (Codex, Cursor, Gemini, etc.)
+     - `AGENTS.md` - Cross-tool AI coding agent instructions
      - `GEMINI.md` - Google Gemini CLI specific instructions
-   - For each existing file, analyze:
-     - Find temporary instructions related to resolved issue (e.g., mentions of `#<issue_number>`, `issue-<number>`)
-     - Identify outdated or inaccurate information
-     - Identify redundant or unnecessary content
-   - Prepare update proposal for each file:
-     - **To remove**: Temporary notes/instructions related to resolved issue
-     - **To add**: New patterns/conventions discovered during issue resolution
-     - **To modify**: Outdated or inaccurate information
+     - `.claude/rules/*.md` - Modular rule files
+
+   - **Placement Rules** (applies to all config files):
+
+     | Content Type | Placement |
+     |--------------|-----------|
+     | Project-wide constraints | Golden Rules > Immutable |
+     | Project-wide recommendations | Golden Rules > Do's |
+     | Project-wide prohibitions | Golden Rules > Don'ts |
+     | Module-specific rules | Delegate to `.claude/rules/[module].md` |
+     | New commands | Commands section |
+     | New module references | Modular Rules section |
+
+   - **Content Removal**:
+     - Temporary instructions (e.g., `TODO: remove after #N`)
+     - Resolved known issues
+     - Workaround descriptions for fixed bugs
+
+   - **Content Addition**:
+     - Module-specific rule -> propose `.claude/rules/[module].md` creation/update
+     - Project-wide rule -> add to appropriate Golden Rules subsection
+     - New module documented -> add `See @.claude/rules/[module].md` reference
+
+   - **Modular Rule Files** (.claude/rules/*.md):
+     - Check if relevant module file exists
+     - Propose path-specific rules with frontmatter: `paths: src/[module]/**/*.py`
+     - Follow structure: Role, Key Components, Do's, Don'ts
+     - **Always confirm with user before creating new rule files**
+
    - Present proposal to user for confirmation before applying
 
 7. **Commit Changes (Optional)**
@@ -75,7 +96,28 @@ Perform branch cleanup and CLAUDE.md updates after a PR has been merged. Follow
 
 ## Configuration File Update Guide
 
-The following guidelines apply to CLAUDE.md, AGENTS.md, and GEMINI.md:
+The following guidelines apply to CLAUDE.md, AGENTS.md, GEMINI.md, and `.claude/rules/*.md`:
+
+### Expected File Structure
+
+**Root Config (CLAUDE.md, AGENTS.md, GEMINI.md)**:
+1. Project Context - Business goal + tech stack (1-2 sentences)
+2. Commands - Package manager and run commands
+3. Golden Rules - Immutable / Do's / Don'ts
+4. Modular Rules - `See @.claude/rules/[module].md` references
+5. Project-Specific - Data locations, tracking, etc.
+
+**Modular Rules (.claude/rules/*.md)**:
+```markdown
+---
+paths: src/[module]/**/*.py  # Optional: conditional loading
+---
+# [Module] Rules
+Role description (1-2 lines)
+## Key Components
+## Do's
+## Don'ts
+```
 
 ### Examples of Content to Remove
 - Temporary notes like `TODO: remove after #123 is resolved`

package/.claude/commands/gh/resolve-and-review.md

@@ -0,0 +1,69 @@
+---
+description: Full issue resolution pipeline with automated code review
+---
+
+# Resolve and Review
+
+Issue 해결부터 CodeRabbit 리뷰 처리까지 자동화된 전체 파이프라인.
+
+## Arguments
+
+`$ARGUMENTS` = Issue number
+
+## Pipeline
+
+### Step 1: Issue Resolution
+
+Spawn issue-resolver agent (blocking, wait for result):
+
+```
+Task(subagent_type="issue-resolver"):
+  prompt: |
+    Resolve GitHub issue #${ARGUMENTS}.
+
+    Follow the complete workflow in your system prompt.
+    End with: PR_CREATED: {number} or PR_FAILED: {reason}
+```
+
+Parse result:
+- Extract PR number from `PR_CREATED: (\d+)`
+- If `PR_FAILED`, report failure and **stop pipeline**
+
+### Step 2: Code Review Loop
+
+Spawn code-review-handler agent (blocking, wait for result):
+
+```
+Task(subagent_type="code-review-handler"):
+  prompt: |
+    Handle CodeRabbit reviews for PR #${PR_NUMBER}.
+
+    End with: REVIEW_COMPLETE, REVIEW_INCOMPLETE, or REVIEW_SKIPPED
+```
+
+### Step 3: Final Report
+
+Report to user:
+
+```
+## Pipeline Complete
+
+- Issue: #${ARGUMENTS}
+- PR: #${PR_NUMBER}
+- Review Status: ${REVIEW_STATUS}
+- PR URL: https://github.com/${REPO}/pull/${PR_NUMBER}
+```
+
+## Error Handling
+
+| Stage | Error | Action |
+|-------|-------|--------|
+| Step 1 | PR_FAILED | Stop pipeline, report reason |
+| Step 2 | REVIEW_INCOMPLETE | Continue, warn user |
+| Step 2 | REVIEW_SKIPPED | Continue, note no review |
+
+## Guidelines
+
+- Follow `@CLAUDE.md` project conventions
+- Each agent runs in independent context
+- Use `/tasks` to monitor agent status

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

@@ -1,3 +1,6 @@
+---
+description: Resolve GitHub Issue
+---
 
 # Resolve GitHub Issue
 

package/.claude/commands/tm/convert-prd.md

@@ -1,3 +1,7 @@
+---
+description: Convert Draft to TaskMaster PRD
+---
+
 # Convert Draft to TaskMaster PRD
 
 Convert a draft file to TaskMaster PRD format.

package/.claude/commands/tm/post-merge.md

@@ -1,3 +1,7 @@
+---
+description: Post-Merge Cleanup (TaskMaster Integration)
+---
+
 # Post-Merge Cleanup (TaskMaster Integration)
 
 After PR merge, perform branch cleanup, TaskMaster status update, and CLAUDE.md update.
@@ -12,7 +16,9 @@ Follow project guidelines in `@CLAUDE.md`.
 
 ## Arguments
 
-- PR number (optional): If not provided, determine from conversation context or request selection from recent merged PR list
+`$ARGUMENTS` parsing:
+- If provided: Use as PR number (e.g., `/tm:post-merge 42`)
+- If empty: Determine from conversation context or show recent merged PR list for selection
 
 ---
 

package/.claude/commands/tm/resolve-issue.md

@@ -1,3 +1,7 @@
+---
+description: Resolve GitHub Issue with TaskMaster
+---
+
 # Resolve GitHub Issue with TaskMaster
 
 Systematically resolve GitHub Issues by TaskMaster subtask units and create PR.

package/.claude/commands/tm/sync-to-github.md

@@ -1,3 +1,7 @@
+---
+description: TaskMaster -> GitHub Issue Sync
+---
+
 # TaskMaster -> GitHub Issue Sync
 
 Reads TaskMaster's tasks.json and automatically creates GitHub Issues and Milestones.

package/.claude/settings.json

@@ -0,0 +1,15 @@
+{
+    "hooks": {
+        "UserPromptSubmit": [
+            {
+                "matcher": "",
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "bash .claude/hooks/inject-guidelines.sh"
+                    }
+                ]
+            }
+        ]
+    }
+}

package/.claude/skills/claude-md-generator/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: claude-md-generator
+description: Generate or restructure CLAUDE.md systems for any project. This skill should be used when starting new projects (provide project description + tech stack), reorganizing existing CLAUDE.md files into modular .claude/rules/ structures, or creating team coding standards with central control and delegation patterns.
+---
+
+# CLAUDE.md Generator
+
+This skill designs optimized CLAUDE.md systems following Claude Code official patterns with central control and delegation structure.
+
+## Role
+
+Act as an AI Context Architect with authority to design and implement CLAUDE.md systems. Analyze project structure, identify high-context zones, and create modular rule files.
+
+## Core Philosophy
+
+1. **500-Line Limit** - All context files must remain under 500 lines for readability and token efficiency
+2. **No Emojis** - Never use emojis anywhere for maximum context efficiency
+3. **Central Control + Delegation** - Root file serves as control tower; details delegate to `.claude/rules/`
+4. **Golden Rules** - Provide Do's/Don'ts format for clear behavioral guidance
+5. **@import Syntax** - Use `@path/to/file.md` for referencing modular rules
+
+## Operation Modes
+
+### Mode 1: New Project
+
+When no CLAUDE.md exists:
+
+1. Collect project description (1-2 sentences) and tech stack
+2. Analyze directory structure to identify boundaries
+3. Propose file list with paths and roles
+4. Wait for user confirmation
+5. Generate files sequentially
+6. Summarize created structure
+
+### Mode 2: Restructure Existing
+
+When CLAUDE.md already exists:
+
+1. Read and analyze current CLAUDE.md content
+2. Identify sections that should delegate to `.claude/rules/`
+3. Propose restructuring plan showing before/after
+4. Preserve existing information while improving structure
+5. Wait for user confirmation
+6. Execute restructuring
+7. Summarize changes
+
+## Execution Flow
+
+1. **Analyze** - Scan project structure, identify Dependency/Framework/Logical boundaries
+2. **Propose** - List files to create with paths and brief descriptions
+3. **Confirm** - Wait for user approval before any file operations
+4. **Generate** - Create files sequentially after approval
+5. **Summarize** - Report created files and provide next steps
+
+## Boundary Detection
+
+Create separate `.claude/rules/*.md` files when these signals appear:
+
+**Dependency Boundary**
+- Separate package.json, requirements.txt, Cargo.toml, etc.
+- Indicates isolated dependency scope
+
+**Framework Boundary**
+- Tech stack transition points (frontend/backend, API/infra)
+- Different tooling or patterns required
+
+**Logical Boundary**
+- High business logic density modules
+- Core engine, billing, auth, ML pipeline, etc.
+
+## Agent Rules
+
+1. **Analyze First** - Always scan project structure before proposing
+2. **Propose Before Execute** - Present file list and wait for confirmation
+3. **Preserve Existing** - When restructuring, keep existing information intact
+4. **Markdown Only** - Output valid Markdown without unnecessary prose
+
+## Official Patterns
+
+### Folder Structure
+
+Claude Code recognizes this hierarchy:
+
+```
+.claude/
+├── CLAUDE.md              # Alternative to root CLAUDE.md
+├── CLAUDE.local.md        # Personal overrides (auto-gitignored)
+├── rules/                 # Modular rules (AUTO-LOADED)
+│   ├── code-style.md
+│   ├── testing.md
+│   └── security.md
+├── agents/                # Custom subagents
+├── skills/                # Project skills
+└── settings.json          # Project settings
+```
+
+### @import Syntax
+
+Reference other files using `@` syntax:
+
+```markdown
+See @.claude/rules/models.md for model architecture guidance
+See @README.md for project overview
+```
+
+### Path-Specific Rules
+
+Use `paths:` frontmatter for conditional loading:
+
+```markdown
+---
+paths: src/models/**/*.py
+---
+
+# Model Rules
+[These rules only apply when working on matching files]
+```
+
+## Maintenance Policy
+
+When rules and actual code diverge:
+- Report the discrepancy to user
+- Propose update (either modify rules or suggest code changes)
+- Apply changes only after confirmation
+
+## References
+
+For detailed templates and examples, see:
+- @references/templates.md - Root and rules file templates
+- @references/examples.md - Project type examples (ML, Web, CLI, Monorepo)

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

@@ -0,0 +1,261 @@
+# Project Type Examples
+
+## Python ML/DL Project
+
+**Input:**
+```
+Project: Deepfake detection using DINOv3-ViT with LoRA adaptation
+Tech: Python, PyTorch, Optuna, YOLO, Gradio
+```
+
+**Output Structure:**
+```
+./CLAUDE.md (root - overview + @imports)
+.claude/rules/
+  - models.md       # paths: src/models/**/*.py
+  - data.md         # paths: src/data/**/*.py
+  - inference.md    # paths: src/inference/**/*.py
+  - optimization.md # paths: src/optimization/**/*.py
+  - labeling.md     # paths: src/labeling/**/*.py
+```
+
+**Sample Root CLAUDE.md:**
+```markdown
+# CLAUDE.md
+
+## Project Context
+
+Deepfake detection competition project using DINOv3-ViT with LoRA adaptation.
+Tech: Python 3.11, PyTorch, Optuna, YOLO-Face, Gradio
+
+## Operational Commands
+
+```bash
+uv sync
+uv run python run_inference.py
+uv run pytest tests/
+```
+
+## Golden Rules
+
+### Immutable
+
+- BGR to RGB conversion required for all OpenCV inputs
+- LoRA rank/alpha must match checkpoint exactly
+
+### Do's
+
+- Use albumentations for image augmentation
+- Back-half sampling for video inference
+
+### Don'ts
+
+- Optimize solely for local metrics (inverse LDB correlation)
+- Use system Python directly
+
+## Modular Rules
+
+See @.claude/rules/models.md for detector architecture and checkpoints
+See @.claude/rules/data.md for preprocessing, caching, face detection
+See @.claude/rules/inference.md for prediction pipeline and aggregation
+See @.claude/rules/optimization.md for Optuna hyperparameter tuning
+```
+
+---
+
+## Web Application (Fullstack)
+
+**Input:**
+```
+Project: SaaS dashboard with user auth and billing
+Tech: Next.js 14, TypeScript, Prisma, Stripe, Tailwind
+```
+
+**Output Structure:**
+```
+./CLAUDE.md (root)
+.claude/rules/
+  - api.md          # paths: app/api/**/*
+  - components.md   # paths: components/**/*
+  - auth.md         # paths: lib/auth/**/*
+  - billing.md      # paths: lib/billing/**/*
+  - db.md           # paths: prisma/**/*
+```
+
+**Sample Root CLAUDE.md:**
+```markdown
+# CLAUDE.md
+
+## Project Context
+
+SaaS dashboard with authentication, team management, and Stripe billing.
+Tech: Next.js 14 (App Router), TypeScript, Prisma, Stripe, Tailwind CSS
+
+## Operational Commands
+
+```bash
+pnpm install
+pnpm dev
+pnpm test
+pnpm db:push
+```
+
+## Golden Rules
+
+### Immutable
+
+- Never commit .env files
+- All API routes require authentication middleware
+
+### Do's
+
+- Use server components by default
+- Validate all inputs with Zod
+
+### Don'ts
+
+- Store API keys in client code
+- Skip error boundaries
+
+## Modular Rules
+
+See @.claude/rules/api.md for API route patterns
+See @.claude/rules/components.md for UI component guidelines
+See @.claude/rules/auth.md for authentication flow
+See @.claude/rules/billing.md for Stripe integration
+See @.claude/rules/db.md for Prisma schema conventions
+```
+
+---
+
+## CLI Tool
+
+**Input:**
+```
+Project: CLI for managing cloud infrastructure
+Tech: Rust, clap, tokio, AWS SDK
+```
+
+**Output Structure:**
+```
+./CLAUDE.md (root)
+.claude/rules/
+  - commands.md     # paths: src/commands/**/*
+  - core.md         # paths: src/core/**/*
+  - aws.md          # paths: src/aws/**/*
+```
+
+**Sample Root CLAUDE.md:**
+```markdown
+# CLAUDE.md
+
+## Project Context
+
+CLI tool for managing AWS infrastructure with declarative configs.
+Tech: Rust, clap (CLI parsing), tokio (async), AWS SDK
+
+## Operational Commands
+
+```bash
+cargo build --release
+cargo test
+cargo run -- --help
+```
+
+## Golden Rules
+
+### Immutable
+
+- All AWS operations must be idempotent
+- Never store credentials in code
+
+### Do's
+
+- Use structured logging with tracing
+- Provide --dry-run for destructive operations
+
+### Don'ts
+
+- Block the async runtime
+- Panic in library code
+
+## Modular Rules
+
+See @.claude/rules/commands.md for CLI command structure
+See @.claude/rules/core.md for business logic patterns
+See @.claude/rules/aws.md for AWS SDK usage
+```
+
+---
+
+## Monorepo
+
+**Input:**
+```
+Project: E-commerce platform with web, mobile API, and shared packages
+Tech: Turborepo, Next.js, Fastify, React Native, TypeScript
+```
+
+**Output Structure:**
+```
+./CLAUDE.md (root - routing only)
+apps/
+  web/CLAUDE.md           # Next.js storefront
+  api/CLAUDE.md           # Fastify backend
+  mobile/CLAUDE.md        # React Native app
+packages/
+  shared/CLAUDE.md        # Shared utilities
+  ui/CLAUDE.md            # Component library
+infra/CLAUDE.md           # Terraform/Pulumi
+```
+
+**Sample Root CLAUDE.md:**
+```markdown
+# CLAUDE.md
+
+## Project Context
+
+E-commerce platform monorepo with web storefront, API, mobile app, and shared packages.
+Tech: Turborepo, pnpm workspaces, TypeScript throughout
+
+## Operational Commands
+
+```bash
+pnpm install
+pnpm dev           # Run all apps
+pnpm build         # Build all packages
+pnpm test          # Test all packages
+```
+
+## Golden Rules
+
+### Immutable
+
+- All packages must have explicit dependencies (no implicit imports)
+- Shared types live in @repo/shared only
+
+### Do's
+
+- Use workspace protocol for internal deps
+- Run affected tests before PR
+
+### Don'ts
+
+- Import directly from other apps
+- Skip the build step for packages
+
+## App-Specific Rules
+
+Web storefront: @apps/web/CLAUDE.md
+API server: @apps/api/CLAUDE.md
+Mobile app: @apps/mobile/CLAUDE.md
+
+## Package Rules
+
+Shared utilities: @packages/shared/CLAUDE.md
+UI components: @packages/ui/CLAUDE.md
+
+## Infrastructure
+
+Terraform configs: @infra/CLAUDE.md
+```