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.