skills.rest
GregoryHo
GregoryHoCOMMUNITY
Explore all skills by this author →
GitHub

arc-finishing-epic

Finalize epic implementations in a worktree by verifying tests and presenting integration options.

6|Updated Feb 8, 2026
Search Tags:#git#workflow#testing#code review#integration#epic
One-click install
npx skills add https://github.com/GregoryHo/arcforge --skill arc-finishing-epic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arc-finishing-epic
Source: https://github.com/GregoryHo/arcforge/tree/main/skills/arc-finishing-epic
Command: npx skills add https://github.com/GregoryHo/arcforge --skill arc-finishing-epic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @arcforge/scripts/cli.js, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of completing an epic's implementation within a dedicated worktree, ensuring all tests pass and providing clear options for integrating the completed work back into the main codebase.

Core Features & Use Cases

  • Automated Testing: Verifies that all tests pass before proceeding with integration options.
  • Integration Options: Offers choices to merge locally, push and create a Pull Request, keep the branch as-is, or discard the work.
  • Worktree Management: Handles the cleanup or preservation of worktrees based on the chosen integration path.
  • Use Case: After completing a feature defined by an .arcforge-epic file, this skill guides you through merging it back to main, creating a PR, or safely discarding it if necessary.

Quick Start

Use the arc-finishing-epic skill when your epic implementation in a worktree is complete and all tests are passing.

Frequently Asked Questions about arc-finishing-epic

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

FAQPage Schema
How do I finalize an epic worktree and merge changes back to the main branch?▼

To finalize epic changes, this skill verifies all tests pass, determines the base branch, and offers options to merge locally via a coordinator, push for a pull request, tag, or discard. It requires a `.arcforge-epic` file to proceed.

What happens to my git branch if epic tests fail during integration?▼

If epic tests fail during integration, the process halts. The skill requires all tests to pass before presenting any integration options, ensuring that broken changes are not merged or pushed to the remote repository.

Can I push a completed feature branch and create a pull request from a worktree?▼

Yes, you can push branches for pull requests. The skill provides integration options to push completed work for a PR after verifying all tests pass within the dedicated worktree.

How do I discard worktree changes when abandoning an epic implementation?▼

To discard worktree changes from an epic implementation, you select the discard option during the integration phase. The skill safely discards the changes upon confirmation after checking the `.arcforge-epic` file and test status.

Do I need a specific file to manage epic workflow integration and tagging?▼

Yes, you need a `.arcforge-epic` file to manage epic workflow integration. The skill requires this file to exist in the worktree to determine the base branch and handle tagging, merging, or discarding the completed work.

Related Skills

Explore More Software Engineering Skills→
GregoryHoGregoryHo
6

arc-using-worktrees

Create isolated Git worktrees for epic development within the arcforge framework.

Community
Advanced
JubaKitiashviliJubaKitiashvili
41

quality-gate

Run parallel code-reviewer and performance-profiler checks for React Native merges.

Community
Intermediate
NeuralChainXNeuralChainX

finishing-a-development-branch

Verify test suites and manage git branch integration for development workflows.

Official
Advanced
nicograefnicograef
2

finish-branch

Run tests and merge, pull request, or delete completed Git branches.

Community
Advanced