skills.rest
AnthemFlynn
AnthemFlynnCOMMUNITY
Explore all skills by this author →
GitHub

openspec-finishing-branch

Validate tests, select a merge/PR option, and archive OpenSpec changes.

Updated Aug 27, 2026
Search Tags:#merge#archive#openspec#specs#branch-management#dev-workflow
One-click install
npx skills add https://github.com/AnthemFlynn/dwc --skill openspec-finishing-branch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-finishing-branch
Source: https://github.com/AnthemFlynn/dwc/tree/main/plugins/openspec/skills/openspec-finishing-branch
Command: npx skills add https://github.com/AnthemFlynn/dwc --skill openspec-finishing-branch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finishes a development branch by coordinating test verification, option selection, and finalization, including archiving the related OpenSpec changes for knowledge continuity.

Core Features & Use Cases

  • Validates the test suite to ensure the branch is stable before finishing.
  • Determines the appropriate base branch and presents four completion options (merge locally, push/PR, keep as-is, or discard).
  • Archives the OpenSpec changes to the project specs on completion to preserve history and knowledge.

Quick Start

Use the openspec-finishing-branch skill to finalize a development branch after tests pass.

Frequently Asked Questions about openspec-finishing-branch

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

FAQPage Schema
How do I finish a Git feature branch and archive OpenSpec changes?▼

To finish a Git feature branch, you validate the test suite, select a merge or PR option, and archive the related OpenSpec changes to the project specs directory to preserve development history.

What are the options for completing an OpenSpec development branch?▼

Completing an OpenSpec development branch offers four options: merging the branch locally, pushing to create a pull request, keeping the branch as-is, or discarding the changes entirely.

Do I need to run tests before merging a branch with OpenSpec integration?▼

Yes, you must run tests to ensure branch stability before finishing. The finishing process requires test execution validation and provides clear failure handling if the test suite does not pass.

How does OpenSpec archive branch changes after a local merge?▼

OpenSpec archives branch changes by moving the finalized specifications back into the openspec/specs directory, ensuring that the knowledge and history from the completed feature branch are preserved.

Can I discard changes instead of merging when finishing an OpenSpec branch?▼

Yes, discarding changes is one of the four provided completion options. When finishing the branch, you can choose to discard the changes instead of proceeding with a local merge or pull request.

What should I do if tests fail while finishing a development branch?▼

If tests fail while finishing a development branch, the process provides clear failure handling and guardrails. You must fix the failing tests to ensure the branch is stable before attempting completion.

Related Skills

Explore More Software Engineering Skills→
good-ideagood-idea
3

using-git-worktrees

Create Git worktrees for isolated feature development and cleanup optionally deleting branches.

Community
Intermediate
npc-chrisnpc-chris
1

land-and-deploy

Merge pull requests, deploy updates, and verify production health.

Community
Advanced
HsienWHsienW
63

openspec-archive-change

Finalize and archive completed changes in an experimental workflow using the openspec CLI.

Community
Advanced
nsheapsnsheaps
3

update-branch

Synchronize feature branches with their PR base using git and gh.

Community
Advanced