build-git

Build Git Skill

Initializes a git repository at the build root directory, writes a two-phase .gitignore that excludes WordPress core and known reinstallable components while tracking custom-generated content, and provides a commit helper for staged commits after each build skill stage.

This skill runs at multiple points throughout the build pipeline — not as a single step. Git init happens early (after directory setup), .gitignore Phase 1 is written before any commits, .gitignore Phase 2 is appended after build-content, and commits happen after each skill stage.

This skill expects the following variables to be set by the calling command before invocation:

• BUILD_DIR — absolute path to the build directory (set by build-scaffold Section 2)
• THEME_SLUG — theme directory slug (required for Section 3, set by build-theme)
• INSTALLED_PLUGINS — array of slug:name:version entries (required for Section 3, set by build-content)
• MCP_ADAPTER_VERSION — MCP adapter version string (required for Section 5 commit messages, set by build-mcp)
• THEME_NAME — display name of installed theme (required for Section 5 commit messages, set by build-theme)
• SLUG — build slug used as the build(init) commit subject (set in Section 1 of COMMAND.md)
• PAGES_CREATED — count of pages created (required for Section 5 commit body, set by build-content)
• POSTS_CREATED — count of posts created (required for Section 5 commit body, set by build-content)

Section 1: Git Initialization and User Config

Initialize a git repository at the build root and configure a fallback git identity if none is globally set.

Runs ONCE, after build-scaffold Section 2 (directory setup), BEFORE WP core download.

echo "[Build] Initializing git repository at $BUILD_DIR..."
echo ""

# Initialize git at build root with main as default branch
if git -C "$BUILD_DIR" init -b main > /dev/null 2>&1; then
  echo "[Build] Git initialized at $BUILD_DIR (branch: main)"
else
  echo "[Build] WARNING: git init failed at $BUILD_DIR. Git versioning will be skipped."
  echo "[Build] WARNING: Build will continue without git history."
  GIT_INITIALIZED=false
fi

# Check for existing git user config — set project-level fallback if missing
if [ "${GIT_INITIALIZED:-true}" = "true" ]; then
  GIT_USER_NAME=$(git config --global user.name 2>/dev/null || echo "")
  GIT_USER_EMAIL=$(git config --global user.email 2>/dev/null || echo "")

  if [ -z "$GIT_USER_NAME" ] || [ -z "$GIT_USER_EMAIL" ]; then
    git -C "$BUILD_DIR" config user.name "CoWork Build"
    git -C "$BUILD_DIR" config user.email "[email protected]"
    echo "[Build] NOTE: No global git user config found. Using project-level fallback: CoWork Build <[email protected]>"
    echo "[Build] NOTE: Run 'git config --global user.name \"Your Name\"' to set your own identity."
  else
    echo "[Build] Git user: $GIT_USER_NAME <$GIT_USER_EMAIL>"
  fi

  GIT_INITIALIZED=true
fi

echo ""