claude-pro-minmax 1.0.0

package/scripts/hooks/retry-check.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# retry-check.sh - Stop Hook (For Builder Subagent)
+# Enforce 2-Retry Cap (0 tokens, ~50 tokens on block)
+# Hardened Hook
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+# check stop_hook_active - to prevent infinite loops
+STOP_HOOK_ACTIVE=$(echo "$INPUT" | jq -r '.stop_hook_active // false')
+if [ "$STOP_HOOK_ACTIVE" = "true" ]; then
+  exit 0  # Already continuing from stop hook result - do not intervene
+fi
+
+# Get transcript path
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty')
+
+if [ -n "$TRANSCRIPT_PATH" ] && [ -f "$TRANSCRIPT_PATH" ]; then
+  # Extract tool_result from last 50 lines (sufficient buffer) and check if last 2 are both errors
+  # tail: optimizes performance by not reading the entire file
+  # jq: parses JSONL to extract is_error field
+  CONSECUTIVE_ERRORS=$(tail -n 50 "$TRANSCRIPT_PATH" | jq -r 'select(.type=="tool_result") | .is_error // false' | tail -n 2 | grep -c "true")
+  
+  # Escalate on 2 consecutive failures
+  if [ "$CONSECUTIVE_ERRORS" -ge 2 ]; then
+    echo "RETRY_CAP: 2 consecutive failures detected. Escalation to --sonnet, @planner, or @dplanner is recommended." >&2
+    exit 2
+  fi
+fi
+
+exit 0

package/scripts/hooks/session-cleanup.sh

@@ -0,0 +1,83 @@
+#!/bin/bash
+# session-cleanup.sh - SessionEnd Hook
+# Save session summary + Secret scrubbing on session end (0 tokens)
+# Hardened Hook
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+# Check jq dependency
+if ! command -v jq &> /dev/null; then
+    echo "Error: jq is required but not installed." >&2
+    exit 1
+fi
+
+# Set project directories
+SESSION_DIR="$HOME/.claude/sessions"
+SCRUBBER="$HOME/.claude/scripts/scrub-secrets.js"
+
+mkdir -p "$SESSION_DIR"
+
+# Save session summary
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
+REASON=$(echo "$INPUT" | jq -r '.reason // "other"')
+TIMESTAMP=$(date +"%Y-%m-%d_%H-%M-%S")
+SUMMARY_FILE="$SESSION_DIR/${TIMESTAMP}-session-end.md"
+
+# Git change summary
+GIT_SUMMARY=""
+if git rev-parse --is-inside-work-tree &>/dev/null; then
+  CHANGED_FILES=$(git diff --name-only HEAD 2>/dev/null | wc -l | tr -d ' ')
+  STAGED_FILES=$(git diff --cached --name-only 2>/dev/null | wc -l | tr -d ' ')
+  BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
+  GIT_SUMMARY="Branch: $BRANCH, Changed: $CHANGED_FILES, Staged: $STAGED_FILES"
+else
+  GIT_SUMMARY="Not a git repository"
+fi
+
+# Create summary file
+cat > "$SUMMARY_FILE" <<EOF
+---
+type: session-end
+session_id: $SESSION_ID
+reason: $REASON
+timestamp: $(date +"%Y-%m-%d %H:%M:%S")
+---
+
+# Session End Summary
+
+## Session Info
+- ID: $SESSION_ID
+- End Reason: $REASON
+- Time: $(date +"%H:%M:%S")
+
+## Git Status
+$GIT_SUMMARY
+
+## Working Directory
+$(pwd)
+
+## Context for Next Session
+[Reference this file with /session-load in the next session]
+EOF
+
+echo "[SessionEnd] Summary saved: $SUMMARY_FILE" >&2
+
+# ===== Existing: Secret Scrubbing =====
+# Skip if scrubber does not exist
+[ ! -f "$SCRUBBER" ] && exit 0
+
+# Scrub session files modified within last 5 minutes (*.md)
+find "$SESSION_DIR" -name "*.md" -mmin -5 -print0 2>/dev/null | while IFS= read -r -d '' file; do
+  if [ -f "$file" ]; then
+    temp_file=$(mktemp)
+    if node "$SCRUBBER" < "$file" > "$temp_file" 2>/dev/null; then
+      mv "$temp_file" "$file"
+    else
+      rm -f "$temp_file"
+    fi
+  fi
+done
+
+exit 0

package/scripts/hooks/session-start.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+# session-start.sh - SessionStart Hook
+# 1. Set environment variables (using CLAUDE_ENV_FILE)
+# 2. Notify previous session context (opt-in: CLAUDE_SESSION_NOTIFY=1)
+# Official Docs: Environment variables can be persisted via CLAUDE_ENV_FILE in SessionStart
+set -euo pipefail
+
+# 1. Set environment variables (0 tokens) - Always runs
+if [ -n "${CLAUDE_ENV_FILE:-}" ]; then
+  # Example: project-specific environment variables
+  # echo 'export NODE_ENV=development' >> "$CLAUDE_ENV_FILE"
+  # echo 'export DEBUG=true' >> "$CLAUDE_ENV_FILE"
+  
+  # Load .env.local if exists (Security: values are not exposed)
+  ENV_LOCAL="${CLAUDE_PROJECT_DIR:-.}/.env.local"
+  if [ -f "$ENV_LOCAL" ]; then
+    # Extract only variable names and export (values are loaded at runtime)
+    grep -v '^#' "$ENV_LOCAL" | grep '=' | while read -r line; do
+      var_name="${line%%=*}"
+      echo "export $var_name=\"\${$var_name:-}\"" >> "$CLAUDE_ENV_FILE"
+    done
+  fi
+fi
+
+# 2. Previous session notification (opt-in, ~30 tokens)
+if [ "${CLAUDE_SESSION_NOTIFY:-0}" = "1" ]; then
+  SESSION_DIR="$HOME/.claude/sessions"
+  RECENT=$(find "$SESSION_DIR" -name "*.md" -mtime -7 2>/dev/null | sort -r | head -1)
+
+  if [ -n "$RECENT" ] && [ -f "$RECENT" ]; then
+    cat <<EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": "📂 Previous session found: $(basename "$RECENT"). To restore: /session-load $(basename "$RECENT" .md)"
+  }
+}
+EOF
+  fi
+fi
+
+# 3. Failure log notification (opt-in, ~30 tokens)
+if [ "${CLAUDE_FAILURE_NOTIFY:-0}" = "1" ]; then
+  LOG_FILE="$HOME/.claude/logs/tool-failures.log"
+  if [ -f "$LOG_FILE" ]; then
+    FAILURE_COUNT=$(wc -l < "$LOG_FILE" 2>/dev/null | tr -d ' ')
+    if [ "$FAILURE_COUNT" -gt 10 ]; then
+      cat <<EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": "⚠️ ${FAILURE_COUNT} tool failures accumulated. To analyze: /analyze-failures"
+  }
+}
+EOF
+    fi
+  fi
+fi
+
+# 4. Message budget reminder (always-on, ~40 tokens)
+cat <<'BUDGET'
+{
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": "📊 Pro Plan Strategy: ~45 msg/5h target (short conversations)\n• Default (/do): 2 msg (Batch plan+build+verify)\n• Complex (/plan): 6+ msg (Use for 4+ files)\n• Cost: Haiku(1x) vs Sonnet(3x) vs Opus(5x) | Out=5x In"
+  }
+}
+BUDGET
+
+exit 0

package/scripts/hooks/stop-collect-context.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+# stop-collect-context.sh - Stop Hook
+# Collect additional context on tool failure (0 tokens)
+# Optional: Activated when additional context is needed besides PostToolUseFailure
+# Hardened Hook
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+# Check jq dependency
+if ! command -v jq &> /dev/null; then
+    exit 0  # Silently skip if jq is missing
+fi
+
+# check stop_hook_active - to prevent infinite loops
+STOP_HOOK_ACTIVE=$(echo "$INPUT" | jq -r '.stop_hook_active // false')
+[ "$STOP_HOOK_ACTIVE" = "true" ] && exit 0
+
+# Transcript path
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty')
+[ -z "$TRANSCRIPT_PATH" ] || [ ! -f "$TRANSCRIPT_PATH" ] && exit 0
+
+# Check for error in recent tool_result
+LAST_ERROR=$(tail -100 "$TRANSCRIPT_PATH" 2>/dev/null | jq -s '[.[] | select(.type=="tool_result" and .is_error==true)] | last' 2>/dev/null || echo "null")
+
+if [ "$LAST_ERROR" != "null" ] && [ "$LAST_ERROR" != "" ]; then
+  TOOL_NAME=$(echo "$LAST_ERROR" | jq -r '.tool_name // "unknown"')
+  ERROR_MSG=$(echo "$LAST_ERROR" | jq -r '.error // "unknown"')
+
+  LOG_DIR="$HOME/.claude/logs"
+  mkdir -p "$LOG_DIR"
+  CONTEXT_FILE="$LOG_DIR/failure-contexts.jsonl"
+
+  # Save context (JSONL format)
+  echo "$LAST_ERROR" >> "$CONTEXT_FILE"
+fi
+
+exit 0

package/scripts/hooks/tool-failure-log.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+# tool-failure-log.sh - PostToolUseFailure Hook
+# Logging and escalation recommendations on tool failure (0 tokens)
+# Hardened Hook
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+# Check jq dependency
+if ! command -v jq &> /dev/null; then
+    echo "Error: jq is required but not installed." >&2
+    exit 1
+fi
+
+# Parsing
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // "unknown"')
+ERROR_MSG=$(echo "$INPUT" | jq -r '.error // "unknown error"')
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
+
+# Log directory
+LOG_DIR="$HOME/.claude/logs"
+mkdir -p "$LOG_DIR"
+
+LOG_FILE="$LOG_DIR/tool-failures.log"
+TIMESTAMP=$(date +"%Y-%m-%d %H:%M:%S")
+
+# Record log
+echo "[$TIMESTAMP] Tool: $TOOL_NAME | Error: $ERROR_MSG | Session: $SESSION_ID" >> "$LOG_FILE"
+
+# Check for identical tool failures within last 5 minutes (from log file)
+if [ -f "$LOG_FILE" ]; then
+  FIVE_MIN_AGO=$(date -v-5M +"%Y-%m-%d %H:%M:%S" 2>/dev/null || date -d "5 minutes ago" +"%Y-%m-%d %H:%M:%S" 2>/dev/null || echo "")
+  if [ -n "$FIVE_MIN_AGO" ]; then
+    RECENT_FAILURES=$(grep "$TOOL_NAME" "$LOG_FILE" 2>/dev/null | tail -10 | wc -l | tr -d ' ')
+  else
+    RECENT_FAILURES=$(grep -c "$TOOL_NAME" "$LOG_FILE" 2>/dev/null || echo 0)
+  fi
+else
+  RECENT_FAILURES=1
+fi
+
+# Recommend escalation on 3 or more failures
+if [ "$RECENT_FAILURES" -ge 3 ]; then
+  echo "[ToolFailure] Tool $TOOL_NAME failed ${RECENT_FAILURES} times. Escalation to @planner or @dplanner recommended." >&2
+fi

package/scripts/lint.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# lint.sh - Universal Lint
+# Delegates to runtime-specific adapter
+set -euo pipefail
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+RUNTIME_DIR="$SCRIPT_DIR/runtime"
+
+# Detect runtime
+RUNTIME=$("$RUNTIME_DIR/detect.sh" "$@")
+
+# Parse JSON - prefer jq, fallback to bash
+parse_json() {
+  local key="$1"
+  if command -v jq &>/dev/null; then
+    echo "$RUNTIME" | jq -r ".$key"
+  else
+    echo "$RUNTIME" | sed 's/.*"'"$key"'":"\([^"]*\)".*/\1/'
+  fi
+}
+
+ADAPTER=$(parse_json adapter)
+RUNTIME_NAME=$(parse_json runtime)
+TOOL_NAME=$(parse_json tool)
+
+echo "🔍 Detected: $RUNTIME_NAME ($TOOL_NAME)"
+
+# Source adapter
+source "$RUNTIME_DIR/adapters/$ADAPTER"
+
+# Execute
+echo "🔎 Running linter..."
+adapter_lint

package/scripts/runtime/README.ko.md

@@ -0,0 +1,60 @@
+> **[English Version](README.md)**
+
+# Runtime Detection Layer
+
+## 목적
+언어 독립적 작업을 위한 OCP 준수 런타임 감지. 코어 스크립트 수정 없이 새 언어 추가 가능.
+
+## 구조
+
+```
+runtime/
+├── detect.sh         # 프로젝트 런타임 자동 감지
+└── adapters/         # 언어별 구현체
+```
+
+## detect.sh
+
+프로젝트 유형을 자동 감지하고 JSON을 출력합니다.
+
+**사용법:**
+```bash
+# 기본 사용
+./detect.sh
+# 출력: {"runtime":"node","tool":"npm","adapter":"node.sh"}
+
+# 모노레포 지원 (하위 디렉토리)
+./detect.sh --path backend
+# 출력: {"runtime":"jvm","tool":"gradle","adapter":"jvm.sh"}
+```
+
+**감지 우선순위:**
+1. JVM: `build.gradle.kts` > `build.gradle` > `pom.xml`
+2. Node: `package.json` (락 파일로 패키지 매니저 확인)
+3. Rust: `Cargo.toml`
+4. Go: `go.mod`
+5. Python: `pyproject.toml` > `setup.py` > `requirements.txt`
+6. Generic: Makefile로 폴백
+
+## 통합
+
+유니버설 스크립트가 이 레이어를 사용합니다:
+
+```bash
+# scripts/verify.sh
+RUNTIME=$("$RUNTIME_DIR/detect.sh" "$@")
+ADAPTER=$(echo "$RUNTIME" | jq -r '.adapter')
+source "$RUNTIME_DIR/adapters/$ADAPTER"
+adapter_verify
+```
+
+## 새 런타임 추가
+
+`detect.sh`만 업데이트:
+
+```bash
+# 감지 패턴 추가
+[[ -f "$dir/mix.exs" ]] && echo '{"runtime":"elixir","tool":"mix","adapter":"elixir.sh"}' && return
+```
+
+그 다음 `adapters/elixir.sh`에 어댑터 생성.

package/scripts/runtime/README.md

@@ -0,0 +1,60 @@
+> **[한국어 버전](README.ko.md)**
+
+# Runtime Detection Layer
+
+## Purpose
+OCP-compliant runtime detection for language-agnostic operations. Add new languages without modifying core scripts.
+
+## Structure
+
+```
+runtime/
+├── detect.sh         # Auto-detect project runtime
+└── adapters/         # Language-specific implementations
+```
+
+## detect.sh
+
+Automatically detects project type and outputs JSON.
+
+**Usage:**
+```bash
+# Basic usage
+./detect.sh
+# Output: {"runtime":"node","tool":"npm","adapter":"node.sh"}
+
+# Monorepo support (subdirectory)
+./detect.sh --path backend
+# Output: {"runtime":"jvm","tool":"gradle","adapter":"jvm.sh"}
+```
+
+**Detection Priority:**
+1. JVM: `build.gradle.kts` > `build.gradle` > `pom.xml`
+2. Node: `package.json` (then check lock files for pm)
+3. Rust: `Cargo.toml`
+4. Go: `go.mod`
+5. Python: `pyproject.toml` > `setup.py` > `requirements.txt`
+6. Generic: Fallback to Makefile
+
+## Integration
+
+Universal scripts use this layer:
+
+```bash
+# scripts/verify.sh
+RUNTIME=$("$RUNTIME_DIR/detect.sh" "$@")
+ADAPTER=$(echo "$RUNTIME" | jq -r '.adapter')
+source "$RUNTIME_DIR/adapters/$ADAPTER"
+adapter_verify
+```
+
+## Adding New Runtimes
+
+Update `detect.sh` only:
+
+```bash
+# Add detection pattern
+[[ -f "$dir/mix.exs" ]] && echo '{"runtime":"elixir","tool":"mix","adapter":"elixir.sh"}' && return
+```
+
+Then create the adapter in `adapters/elixir.sh`.

package/scripts/runtime/adapters/README.ko.md

@@ -0,0 +1,68 @@
+> **[English Version](README.md)**
+
+# Adapters Directory
+
+## 목적
+어댑터 계약을 따르는 언어별 구현체. 각 어댑터는 빌드, 테스트, 린트 작업에 대해 통합 인터페이스를 제공합니다.
+
+## 사용 가능한 어댑터
+
+| 어댑터 | 런타임 | 빌드 도구 | 언어 |
+|---------|---------|-------------|-----------|
+| `jvm.sh` | JVM | Gradle, Maven | Java, Kotlin |
+| `node.sh` | Node | npm, pnpm, yarn, bun | TypeScript, JavaScript |
+| `go.sh` | Go | Go 모듈 | Go |
+| `rust.sh` | Rust | Cargo | Rust |
+| `python.sh` | Python | pip, poetry, uv | Python |
+| `generic.sh` | Generic | Makefile | Any |
+
+## 개발 유틸리티
+
+| 파일 | 목적 |
+|------|------|
+| `_interface.sh` | 계약 검증기 - 어댑터가 모든 필수 함수를 구현했는지 검증 |
+| `_template.sh` | 어댑터 템플릿 - 새 어댑터 생성 시 복사하여 사용 |
+
+## 어댑터 계약
+
+모든 어댑터는 다음 함수를 구현해야 합니다 (`_interface.sh`에 정의됨):
+
+```bash
+adapter_info()    # 어댑터 메타데이터를 JSON으로 반환
+adapter_verify()  # 전체 검증 실행 (빌드 + 테스트 + 린트)
+adapter_build()   # 프로젝트 빌드
+adapter_test()    # 테스트 실행
+adapter_lint()    # 린터 실행
+adapter_format()  # 코드 포맷
+adapter_clean()   # 빌드 산출물 정리
+```
+
+선택 사항:
+```bash
+adapter_run()     # 개발 서버 실행
+```
+
+## 새 어댑터 추가
+
+**3단계 (OCP - 코어 수정 없음):**
+
+1. 템플릿 복사:
+   ```bash
+   cp _template.sh elixir.sh
+   ```
+
+2. 모든 `adapter_*` 함수 구현
+
+3. `../detect.sh`에 감지 패턴 추가:
+   ```bash
+   [[ -f "$dir/mix.exs" ]] && echo '{"runtime":"elixir","tool":"mix","adapter":"elixir.sh"}' && return
+   ```
+
+완료! Universal scripts가 자동으로 새 어댑터 사용
+
+## 어댑터 준수 검증
+
+```bash
+./adapters/_interface.sh ./adapters/elixir.sh
+# 출력: ✓ Adapter implements all required functions
+```

package/scripts/runtime/adapters/README.md

@@ -0,0 +1,68 @@
+> **[한국어 버전](README.ko.md)**
+
+# Adapters Directory
+
+## Purpose
+Language-specific implementations following the adapter contract. Each adapter provides a unified interface for build, test, lint operations.
+
+## Available Adapters
+
+| Adapter | Runtime | Build Tools | Languages |
+|---------|---------|-------------|-----------|
+| `jvm.sh` | JVM | Gradle, Maven | Java, Kotlin |
+| `node.sh` | Node | npm, pnpm, yarn, bun | TypeScript, JavaScript |
+| `go.sh` | Go | Go modules | Go |
+| `rust.sh` | Rust | Cargo | Rust |
+| `python.sh` | Python | pip, poetry, uv | Python |
+| `generic.sh` | Generic | Makefile | Any |
+
+## Development Utilities
+
+| File | Purpose |
+|------|---------|
+| `_interface.sh` | Contract validator - verifies adapter implements all required functions |
+| `_template.sh` | Adapter template - copy this to create new adapters |
+
+## Adapter Contract
+
+All adapters MUST implement these functions (defined in `_interface.sh`):
+
+```bash
+adapter_info()    # Return adapter metadata as JSON
+adapter_verify()  # Run full verification (build + test + lint)
+adapter_build()   # Build project
+adapter_test()    # Run tests
+adapter_lint()    # Run linter
+adapter_format()  # Format code
+adapter_clean()   # Clean build artifacts
+```
+
+Optional:
+```bash
+adapter_run()     # Run dev server
+```
+
+## Adding a New Adapter
+
+**3 Steps (OCP - no core modifications):**
+
+1. Copy template:
+   ```bash
+   cp _template.sh elixir.sh
+   ```
+
+2. Implement all `adapter_*` functions
+
+3. Add detection pattern to `../detect.sh`:
+   ```bash
+   [[ -f "$dir/mix.exs" ]] && echo '{"runtime":"elixir","tool":"mix","adapter":"elixir.sh"}' && return
+   ```
+
+Done! Universal scripts automatically use the new adapter.
+
+## Verify Adapter Compliance
+
+```bash
+./adapters/_interface.sh ./adapters/elixir.sh
+# Output: ✓ Adapter implements all required functions
+```

package/scripts/runtime/adapters/_interface.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# _interface.sh - Adapter Interface Contract
+# All adapters MUST implement these functions
+#
+# Usage: source this file to verify adapter compliance
+# 
+# Required functions:
+#   adapter_info()    - Return adapter metadata as JSON
+#   adapter_verify()  - Run full verification (build + test + lint)
+#   adapter_build()   - Build project
+#   adapter_test()    - Run tests
+#   adapter_lint()    - Run linter
+#   adapter_format()  - Format code
+#   adapter_clean()   - Clean build artifacts
+#
+# Optional functions:
+#   adapter_run()     - Run dev server
+
+REQUIRED_FUNCTIONS=(
+  "adapter_info"
+  "adapter_verify"
+  "adapter_build"
+  "adapter_test"
+  "adapter_lint"
+  "adapter_format"
+  "adapter_clean"
+)
+
+verify_adapter() {
+  local adapter_file="$1"
+  local missing=()
+  
+  source "$adapter_file"
+  
+  for func in "${REQUIRED_FUNCTIONS[@]}"; do
+    if ! declare -f "$func" > /dev/null 2>&1; then
+      missing+=("$func")
+    fi
+  done
+  
+  if [ ${#missing[@]} -gt 0 ]; then
+    echo "ERROR: Adapter missing functions: ${missing[*]}" >&2
+    return 1
+  fi
+  
+  echo "✓ Adapter $adapter_file implements all required functions"
+  return 0
+}
+
+# If called directly with an argument, verify that adapter
+if [ $# -gt 0 ]; then
+  verify_adapter "$1"
+fi

package/scripts/runtime/adapters/_template.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+# _template.sh - Template for New Adapters
+# Copy this file to create a new adapter
+#
+# Steps to add a new language:
+# 1. cp _template.sh elixir.sh
+# 2. Implement all adapter_* functions
+# 3. Add detection pattern to ../detect.sh
+# Done! Core scripts unchanged (OCP).
+#
+set -euo pipefail
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
+
+# Return adapter metadata as JSON
+adapter_info() {
+  echo '{"runtime":"RUNTIME_NAME","tool":"TOOL_NAME","languages":["LANGUAGE"]}'
+}
+
+# Run full verification (compile + test + lint)
+adapter_verify() {
+  echo "TODO: Implement verify for RUNTIME_NAME"
+  echo "Example: mix compile && mix test"
+  exit 1
+}
+
+# Build the project
+adapter_build() {
+  echo "TODO: Implement build for RUNTIME_NAME"
+  echo "Example: mix release"
+  exit 1
+}
+
+# Run tests
+adapter_test() {
+  echo "TODO: Implement test for RUNTIME_NAME"
+  echo "Example: mix test"
+  exit 1
+}
+
+# Run linter
+adapter_lint() {
+  echo "TODO: Implement lint for RUNTIME_NAME"
+  echo "Example: mix credo"
+  exit 1
+}
+
+# Format code
+adapter_format() {
+  echo "TODO: Implement format for RUNTIME_NAME"
+  echo "Example: mix format"
+  exit 1
+}
+
+# Clean build artifacts
+adapter_clean() {
+  echo "TODO: Implement clean for RUNTIME_NAME"
+  echo "Example: mix clean"
+  exit 1
+}
+
+# Optional: Run dev server
+adapter_run() {
+  echo "TODO: Implement run for RUNTIME_NAME"
+  echo "Example: mix phx.server"
+  exit 1
+}