x-internal-ensure-epic-branch

Ensure an epic/<ID> branch exists locally and on origin.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/edercnj/ia-dev-environment --skill x-internal-ensure-epic-branch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-internal-ensure-epic-branch
Source: https://github.com/edercnj/ia-dev-environment/tree/main/src/main/resources/claude/skills/x-internal-ensure-epic-branch
Command: npx skills add https://github.com/edercnj/ia-dev-environment --skill x-internal-ensure-epic-branch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures that an epic/XXXX branch exists idempotently, locally and on origin, preventing duplicate branches and drift in multi-user workflows.

Core Features & Use Cases

  • Idempotent branch enforcement: creates or reconciles epic/<ID> so repeated invocations yield consistent results.
  • Local and remote awareness: checks both local refs and origin to determine the current state and actions.
  • Delegated creation with optional push: delegates actual branch creation to x-create-git-branch when needed, with optional remote pushing via --push.

Quick Start

Invoke the skill with --epic-id 0050 to ensure epic/0050 exists locally and on origin.

Frequently Asked Questions about x-internal-ensure-epic-branch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ensure an epic branch exists idempotently in both local and origin git repositories?

To ensure an epic branch exists idempotently, the skill identifies and guarantees the existence of epic/<ID> locally and on origin, preventing duplicate branches. It checks local refs and remote state, delegating actual creation to x-create-git-branch when needed.

What is the best way to automate epic branch creation for orchestrator workflows?

Automating epic branch creation for orchestrator workflows is best handled by enforcing one branch per epic. The skill validates a four-digit epic ID, resolves the base branch, and coordinates local checks with optional remote pushing to maintain consistency across multi-user environments.

How does idempotent branch enforcement prevent drift in multi-user git workflows?

Idempotent branch enforcement prevents drift by creating or reconciling epic/<ID> so repeated invocations yield consistent results. It checks both local refs and origin to determine current state, ensuring multi-user workflows avoid duplicate branches and maintain synchronization.

Do I need a specific format for the epic ID when creating an epic branch?

Yes, you need a specific four-digit number format for the epic ID when creating an epic branch. The skill validates the --epic-id argument as a four-digit number before resolving the base branch and ensuring the epic/<ID> branch exists.

Can I automatically push an epic branch to origin after ensuring it exists locally?

Yes, you can automatically push an epic branch to origin after ensuring it exists locally. By invoking the skill with the --push flag, it delegates branch creation to x-create-git-branch and performs an optional remote push to the origin repository.

Why does ensuring a git branch exist require resolving a base branch?

Ensuring a git branch exists requires resolving a base branch to establish the correct starting point for branch creation. When the epic/<ID> branch is missing, the skill delegates to x-create-git-branch, using the resolved base branch to prevent duplicate branches and drift.