karimo-overview: Command for Claude Code

/karimo:merge — Feature Branch Merge Command

Consolidate feature branch changes and create final PR to main. This completes the v5.0 feature branch workflow after all task PRs have been merged.

Arguments

• --prd {slug} (required): The PRD slug to merge.
• --skip-validation (optional): Skip validation suite (use with caution).
• --auto-merge (optional): Automatically merge PR after creation (requires passing validation).

Prerequisites

Before merge, the PRD must be:

1. Orchestrated via /karimo:run (execution_mode: "feature-branch")
2. All tasks complete (status: "ready-for-merge")
3. Feature branch exists with all task commits

Behavior

1. Validation

Verify the PRD is ready for merge:

# 1. Check status.json
status=$(jq -r '.status' .karimo/prds/{NNN}_{slug}/status.json)
execution_mode=$(jq -r '.execution_mode' .karimo/prds/{NNN}_{slug}/status.json)
feature_branch=$(jq -r '.feature_branch' .karimo/prds/{NNN}_{slug}/status.json)

if [ "$status" != "ready-for-merge" ]; then
  echo "❌ PRD not ready for merge (status: $status)"
  echo "   Expected: ready-for-merge"
  echo "   Hint: Run /karimo:run --prd {slug} first"
  exit 1
fi

if [ "$execution_mode" != "feature-branch" ]; then
  echo "❌ PRD not using feature branch mode"
  echo "   This command is for v5.0 feature branch workflow only"
  echo "   For direct-to-main PRDs, tasks are already merged"
  exit 1
fi

# 2. Check feature branch exists
if ! git ls-remote --heads origin "$feature_branch" | grep -q "$feature_branch"; then
  echo "❌ Feature branch not found: $feature_branch"
  exit 1
fi

# 3. Check all tasks merged to feature branch
open_prs=$(gh pr list --label karimo-${prd_slug} --base "$feature_branch" --state open --json number --jq 'length')
if [ "$open_prs" -gt 0 ]; then
  echo "❌ $open_prs task PRs still open to feature branch"
  gh pr list --label karimo-${prd_slug} --base "$feature_branch" --state open
  echo "   Wait for all task PRs to merge before running /karimo:merge"
  exit 1
fi

echo "✓ PRD ready for merge"