oh-my-customcode 0.1.0

package/templates/.claude/hooks/memory-persistence/session-start.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# SessionStart Hook - Load previous context on new session
+#
+# Runs when a new Claude session starts. Checks for recent session
+# files and learned skills to provide continuity hints.
+#
+# Hook config (in ~/.claude/settings.json):
+# {
+#   "hooks": {
+#     "SessionStart": [{
+#       "matcher": "*",
+#       "hooks": [{
+#         "type": "command",
+#         "command": "~/.claude/hooks/memory-persistence/session-start.sh"
+#       }]
+#     }]
+#   }
+# }
+
+SESSIONS_DIR="${HOME}/.claude/sessions"
+SKILLS_DIR="${HOME}/.claude/skills/learned"
+
+# Check for recent session files (last 7 days)
+if [ -d "$SESSIONS_DIR" ]; then
+  RECENT_SESSIONS=$(find "$SESSIONS_DIR" -name "*.tmp" -mtime -7 2>/dev/null | wc -l | tr -d ' ')
+  if [ "$RECENT_SESSIONS" -gt 0 ]; then
+    echo "[SessionStart] Found $RECENT_SESSIONS recent session(s)" >&2
+    LATEST=$(find "$SESSIONS_DIR" -name "*.tmp" -mtime -7 2>/dev/null | sort -r | head -1)
+    if [ -n "$LATEST" ]; then
+      echo "[SessionStart] Latest: $LATEST" >&2
+    fi
+  fi
+fi
+
+# Check for learned skills
+if [ -d "$SKILLS_DIR" ]; then
+  SKILLS_COUNT=$(find "$SKILLS_DIR" -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+  if [ "$SKILLS_COUNT" -gt 0 ]; then
+    echo "[SessionStart] $SKILLS_COUNT learned skill(s) available" >&2
+  fi
+fi

package/templates/.claude/hooks/strategic-compact/suggest-compact.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+# Strategic Compact Suggester - Suggest manual compaction at logical intervals
+#
+# Tracks tool usage and suggests compaction at strategic points.
+# Manual compaction preserves context through logical phases.
+#
+# Best times to compact:
+# - After completing an exploration phase, before starting execution
+# - After reaching a milestone (feature complete, tests passing)
+# - When context feels cluttered but before it auto-compacts
+#
+# Hook config (in ~/.claude/settings.json):
+# {
+#   "hooks": {
+#     "PreToolUse": [{
+#       "matcher": "tool == \"Edit\" || tool == \"Write\"",
+#       "hooks": [{
+#         "type": "command",
+#         "command": "~/.claude/hooks/strategic-compact/suggest-compact.sh"
+#       }]
+#     }]
+#   }
+# }
+
+COUNTER_FILE="/tmp/claude-tool-count-$$"
+THRESHOLD=${COMPACT_THRESHOLD:-50}
+
+# Initialize or increment counter
+if [ -f "$COUNTER_FILE" ]; then
+  COUNT=$(cat "$COUNTER_FILE")
+  COUNT=$((COUNT + 1))
+else
+  COUNT=1
+fi
+echo "$COUNT" > "$COUNTER_FILE"
+
+# Suggest compaction at threshold
+if [ "$COUNT" -eq "$THRESHOLD" ]; then
+  echo "[StrategicCompact] Reached $THRESHOLD tool calls" >&2
+  echo "[StrategicCompact] Consider running /compact if at a logical breakpoint" >&2
+  echo "[StrategicCompact] Good times: after exploration, before implementation" >&2
+fi
+
+# Reminder every 25 calls after threshold
+if [ "$COUNT" -gt "$THRESHOLD" ] && [ $(((COUNT - THRESHOLD) % 25)) -eq 0 ]; then
+  echo "[StrategicCompact] $COUNT tool calls - /compact reminder" >&2
+fi
+
+# Pass through input
+cat

package/templates/.claude/install-hooks.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+# Claude Code Hooks & Contexts Installer
+# Source: https://github.com/affaan-m/everything-claude-code
+# Adapted for baekgom-agents project
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CLAUDE_HOME="${HOME}/.claude"
+SETTINGS_FILE="${CLAUDE_HOME}/settings.json"
+
+echo "┌─────────────────────────────────────────────┐"
+echo "│  Claude Code Hooks & Contexts Installer     │"
+echo "└─────────────────────────────────────────────┘"
+echo ""
+
+# Create directories
+echo "[1/5] Creating directories..."
+mkdir -p "${CLAUDE_HOME}/hooks/memory-persistence"
+mkdir -p "${CLAUDE_HOME}/hooks/strategic-compact"
+mkdir -p "${CLAUDE_HOME}/sessions"
+mkdir -p "${CLAUDE_HOME}/skills/learned"
+mkdir -p "${CLAUDE_HOME}/contexts"
+echo "      ✓ Directories created"
+
+# Copy scripts
+echo "[2/5] Copying hook scripts..."
+cp "${SCRIPT_DIR}/hooks/memory-persistence/"*.sh "${CLAUDE_HOME}/hooks/memory-persistence/"
+cp "${SCRIPT_DIR}/hooks/strategic-compact/"*.sh "${CLAUDE_HOME}/hooks/strategic-compact/"
+echo "      ✓ Scripts copied"
+
+# Copy contexts
+echo "[3/5] Copying context files..."
+cp "${SCRIPT_DIR}/contexts/"*.md "${CLAUDE_HOME}/contexts/"
+echo "      ✓ Contexts copied"
+
+# Set permissions
+echo "[4/5] Setting execute permissions..."
+chmod +x "${CLAUDE_HOME}/hooks/memory-persistence/"*.sh
+chmod +x "${CLAUDE_HOME}/hooks/strategic-compact/"*.sh
+echo "      ✓ Permissions set"
+
+# Handle settings.json
+echo "[5/5] Configuring settings.json..."
+
+if [ -f "$SETTINGS_FILE" ]; then
+  # Backup existing settings
+  BACKUP_FILE="${SETTINGS_FILE}.backup.$(date +%Y%m%d_%H%M%S)"
+  cp "$SETTINGS_FILE" "$BACKUP_FILE"
+  echo "      ✓ Backed up existing settings to: $BACKUP_FILE"
+
+  # Check if jq is available for merging
+  if command -v jq &> /dev/null; then
+    # Merge hooks into existing settings
+    HOOKS_JSON="${SCRIPT_DIR}/hooks/hooks.json"
+    TEMP_FILE=$(mktemp)
+
+    # Extract hooks from hooks.json and merge with existing settings
+    jq -s '.[0] * .[1]' "$SETTINGS_FILE" "$HOOKS_JSON" > "$TEMP_FILE"
+    mv "$TEMP_FILE" "$SETTINGS_FILE"
+    echo "      ✓ Merged hooks into settings.json"
+  else
+    echo "      ⚠ jq not found. Please manually merge hooks."
+    echo "      Copy content from: ${SCRIPT_DIR}/hooks/hooks.json"
+    echo "      Into: ${SETTINGS_FILE}"
+  fi
+else
+  # Create new settings.json from hooks.json
+  cp "${SCRIPT_DIR}/hooks/hooks.json" "$SETTINGS_FILE"
+  echo "      ✓ Created new settings.json"
+fi
+
+echo ""
+echo "┌─────────────────────────────────────────────┐"
+echo "│  Installation Complete!                     │"
+echo "└─────────────────────────────────────────────┘"
+echo ""
+echo "Installed to: ${CLAUDE_HOME}/"
+echo ""
+echo "Structure:"
+echo "  ~/.claude/"
+echo "  ├── settings.json          (hooks config)"
+echo "  ├── hooks/"
+echo "  │   ├── memory-persistence/"
+echo "  │   │   ├── pre-compact.sh"
+echo "  │   │   ├── session-start.sh"
+echo "  │   │   └── session-end.sh"
+echo "  │   └── strategic-compact/"
+echo "  │       └── suggest-compact.sh"
+echo "  ├── contexts/"
+echo "  │   ├── dev.md"
+echo "  │   ├── review.md"
+echo "  │   └── research.md"
+echo "  ├── sessions/              (auto-created logs)"
+echo "  └── skills/learned/        (for future use)"
+echo ""
+echo "Next steps:"
+echo "  1. Restart Claude Code to activate hooks"
+echo "  2. Use contexts by referencing them in prompts"
+echo ""

package/templates/.claude/rules/MAY-optimization.md

@@ -0,0 +1,93 @@
+# [MAY] Optimization Guide
+
+> **Priority**: MAY - Optional
+> **Apply when**: Basic functionality is stable
+
+## Efficiency Optimization
+
+### Parallel Processing
+```
+Apply when:
+- 3+ independent tasks
+- Each task is I/O bound
+
+Example:
+- Read multiple files simultaneously
+- Run independent searches in parallel
+```
+
+### Caching
+```
+Apply when:
+- Same data accessed repeatedly
+- Data changes infrequently
+
+Example:
+- Cache file contents
+- Reuse search results
+```
+
+### Lazy Loading
+```
+Apply when:
+- Large datasets
+- Only portion actually used
+
+Example:
+- Read only needed files
+- Stream results
+```
+
+## Token Optimization
+
+### Context Management
+```
+✓ Include only necessary info
+✓ Remove duplicates
+✓ Use summaries
+```
+
+### Response Optimization
+```
+✓ Concise expressions
+✓ Minimize code blocks
+✓ Remove unnecessary repetition
+```
+
+## Task Optimization
+
+### Batch Processing
+```
+Group similar tasks together
+Example: Edit 10 files → Process at once
+```
+
+### Incremental Processing
+```
+Process only changed parts
+Example: Full build → Incremental build
+```
+
+## Apply Criteria
+
+### Do Optimize
+```
+✓ Repetitive tasks
+✓ Clear performance bottleneck
+✓ Measurable improvement
+```
+
+### Don't Optimize
+```
+✗ One-time tasks
+✗ Already fast enough
+✗ Complexity increase outweighs benefit
+```
+
+## Caution
+
+```
+⚠ Premature optimization is root of evil
+⚠ Readability > Optimization
+⚠ No optimization without measurement
+```

package/templates/.claude/rules/MUST-agent-design.md

@@ -0,0 +1,107 @@
+# [MUST] Agent Design Rules
+
+> **Priority**: MUST - Never violate
+> **ID**: R006
+
+## Agent Structure
+
+### Required Files
+```
+agents/{type}/{name}/
+├── AGENT.md          # Agent definition (REQUIRED)
+├── index.yaml        # Agent metadata (REQUIRED)
+└── refs/             # Symlinks to guides/skills (OPTIONAL)
+```
+
+### AGENT.md Must NOT Contain
+```
+✗ Detailed skill instructions (use skills/ instead)
+✗ Reference documentation (use guides/ instead)
+✗ Implementation scripts (use skills/scripts/ instead)
+```
+
+### AGENT.md Should Contain
+```
+✓ Agent purpose and role
+✓ Capabilities overview (not details)
+✓ Required skills (by reference)
+✓ Workflow description
+✓ Source info (if external)
+```
+
+## External Agent Requirements
+
+External agents (from GitHub, npm, etc.) MUST include:
+
+### index.yaml Fields
+```yaml
+metadata:
+  name: agent-name
+  type: worker | orchestrator
+  source:
+    type: external
+    origin: github | npm | other
+    url: https://github.com/org/repo
+    version: 1.0.0
+    last_updated: 2025-01-22
+    update_command: "npx add-skill org/repo"
+```
+
+### Update Tracking
+```
+- version: Current version installed
+- last_updated: Date of last sync
+- update_command: Command to update
+- changelog_url: Where to check updates
+```
+
+## Separation of Concerns
+
+### agents/
+```
+Purpose: Define WHAT the agent does
+Content: Role, capabilities, workflow
+NOT: How to do it (that's skills/)
+```
+
+### skills/
+```
+Purpose: Define HOW to do tasks
+Content: Instructions, scripts, rules
+Location: skills/{category}/{name}/
+```
+
+### guides/
+```
+Purpose: Reference documentation
+Content: Best practices, tutorials
+Location: guides/{topic}/
+```
+
+## Linking
+
+### Agent → Skills
+```yaml
+# In AGENT.md or index.yaml
+skills:
+  - category: development
+    name: react-best-practices
+    path: ../../../../skills/development/react-best-practices
+```
+
+### Agent → Guides
+```bash
+# Symlink in refs/
+ln -s ../../../../guides/web-design refs/web-design
+```
+
+## Naming Conventions
+
+| Type | Pattern | Example |
+|------|---------|---------|
+| Agent folder | `kebab-case` | `vercel-agent` |
+| Skill folder | `kebab-case` | `react-best-practices` |
+| Guide folder | `kebab-case` | `web-design` |
+| AGENT.md | UPPERCASE | `AGENT.md` |
+| SKILL.md | UPPERCASE | `SKILL.md` |
+| index.yaml | lowercase | `index.yaml` |

package/templates/.claude/rules/MUST-agent-identification.md

@@ -0,0 +1,108 @@
+# [MUST] Agent Identification Rules
+
+> **Priority**: MUST - ENFORCED, NO EXCEPTIONS
+> **ID**: R007
+> **Violation**: Immediate correction required
+
+## CRITICAL
+
+**EVERY response MUST start with agent identification. This is NON-NEGOTIABLE.**
+
+Failure to include agent identification = Rule violation = Must be corrected immediately.
+
+## Purpose
+
+Display which agent is responding and which skills are being used for transparency and traceability.
+
+## Response Header Format
+
+Every response MUST start with an agent identification block:
+
+```
+┌─ Agent: {agent-name} ({agent-type})
+├─ Skill: {skill-name} (if applicable)
+└─ Task: {brief-task-description}
+```
+
+## Examples
+
+### Single Agent Response
+```
+┌─ Agent: creator (manager)
+└─ Task: Creating new agent
+
+[Response content...]
+```
+
+### With Skill Usage
+```
+┌─ Agent: vercel-agent (worker)
+├─ Skill: react-best-practices
+└─ Task: Optimizing React component
+
+[Response content...]
+```
+
+### Multiple Skills
+```
+┌─ Agent: vercel-agent (worker)
+├─ Skills: react-best-practices, web-design-guidelines
+└─ Task: Full code review
+
+[Response content...]
+```
+
+### No Specific Agent (Default)
+```
+┌─ Agent: claude (default)
+└─ Task: General assistance
+
+[Response content...]
+```
+
+## When to Display
+
+| Situation | Display |
+|-----------|---------|
+| Agent-specific task | Full header with agent |
+| Using skill | Include skill name |
+| General conversation | "claude (default)" |
+| Multiple agents | Show primary agent |
+
+## Agent Types
+
+| Type | Symbol | Example |
+|------|--------|---------|
+| manager | 🔧 | creator, updater |
+| worker | ⚙️ | vercel-agent |
+| orchestrator | 🎯 | (future) |
+| default | 💬 | claude |
+
+## Simplified Format (Optional)
+
+For brief responses, use inline format:
+
+```
+[creator] Creating agent structure...
+```
+
+Or with skill:
+
+```
+[vercel-agent → react-best-practices] Analyzing performance...
+```
+
+## Status Updates
+
+During long tasks, show progress with agent context:
+
+```
+┌─ Agent: updater (manager)
+└─ Task: Checking external updates
+
+[Progress] Scanning agents/index.yaml (1/3)
+[Progress] Scanning skills/index.yaml (2/3)
+[Progress] Scanning guides/index.yaml (3/3)
+
+[Done] Found 2 updates available
+```

package/templates/.claude/rules/MUST-continuous-improvement.md

@@ -0,0 +1,132 @@
+# [MUST] Continuous Improvement Rules
+
+> **Priority**: MUST - Top-level enforcement
+> **ID**: R016
+> **Trigger**: User points out rule violation
+
+## CRITICAL
+
+**When user points out a rule violation, you MUST update the rules to prevent future violations BEFORE continuing with the task.**
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║  WHEN USER POINTS OUT A VIOLATION:                               ║
+║                                                                   ║
+║  1. STOP current task immediately                                ║
+║  2. UPDATE the relevant rule to be clearer/stronger              ║
+║  3. COMMIT the rule update                                       ║
+║  4. THEN continue with the original task                         ║
+║                                                                   ║
+║  DO NOT just apologize and continue.                             ║
+║  DO NOT promise to do better next time.                          ║
+║  ACTUALLY UPDATE THE RULES.                                      ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+## Workflow
+
+```
+User points out violation
+         │
+         ▼
+┌─────────────────────────┐
+│ 1. Acknowledge violation │
+└───────────┬─────────────┘
+            │
+            ▼
+┌─────────────────────────┐
+│ 2. Identify root cause   │
+│    - Which rule was weak?│
+│    - What was unclear?   │
+└───────────┬─────────────┘
+            │
+            ▼
+┌─────────────────────────┐
+│ 3. Update the rule       │
+│    - Add clarity         │
+│    - Add examples        │
+│    - Add self-checks     │
+└───────────┬─────────────┘
+            │
+            ▼
+┌─────────────────────────┐
+│ 4. Commit the change     │
+└───────────┬─────────────┘
+            │
+            ▼
+┌─────────────────────────┐
+│ 5. Continue original task│
+│    (now following rules) │
+└─────────────────────────┘
+```
+
+## Examples
+
+### Example 1: Parallel Execution Violation
+
+```
+User: "병렬 실행을 안 지킨거 아닌가?"
+
+WRONG Response:
+  "맞습니다, 죄송합니다. 다음부터 잘 지키겠습니다."
+  [continues task without updating rules]
+
+CORRECT Response:
+  1. "맞습니다. R009 위반입니다."
+  2. [Updates MUST-parallel-execution.md with clearer guidance]
+  3. [Commits the update]
+  4. [Continues task with proper parallel execution]
+```
+
+### Example 2: Wrong Agent Used
+
+```
+User: "creator 에이전트를 써야 하는거 아닌가?"
+
+WRONG Response:
+  "맞습니다. creator를 사용하겠습니다."
+  [continues without updating rules]
+
+CORRECT Response:
+  1. "맞습니다. R010 위반입니다."
+  2. [Updates relevant rules to clarify agent delegation]
+  3. [Commits the update]
+  4. [Continues with proper agent delegation]
+```
+
+## Why This Matters
+
+```
+Without rule updates:
+  Violation → Apology → Same mistake later → Apology → ...
+
+With rule updates:
+  Violation → Rule improvement → Better behavior → Learning preserved
+```
+
+1. **Institutional Memory**: Rules capture learnings permanently
+2. **Prevents Recurrence**: Clearer rules = fewer future violations
+3. **Continuous Improvement**: System gets better over time
+4. **Accountability**: Actions, not just words
+
+## Integration with Other Rules
+
+This rule takes precedence when violations are pointed out:
+
+| Situation | Action |
+|-----------|--------|
+| User points out violation | STOP → Update rule → Continue |
+| Self-detected violation | Fix immediately, consider rule update |
+| Ambiguous situation | Ask user, then update if needed |
+
+## Enforcement
+
+```
+Violation of this rule = Ignoring user feedback = Unacceptable
+
+When caught violating this rule:
+1. Stop immediately
+2. Update THIS rule to be even clearer
+3. Update the ORIGINAL violated rule
+4. Continue with proper behavior
+```