finishing-a-development-branch

Verify tests, choose integration options, and clean up worktrees for development branches.

1|Updated May 25, 2025
One-click install
npx skills add https://github.com/circld/dotfiles --skill finishing-a-development-branch-circld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/circld/dotfiles/tree/main/external/opencode/skills/finishing-a-development-branch
Command: npx skills add https://github.com/circld/dotfiles --skill finishing-a-development-branch-circld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of concluding development work by providing a structured workflow for verifying code, deciding on integration strategies, and cleaning up.

Core Features & Use Cases

  • Test Verification: Ensures all tests pass before proceeding.
  • Integration Options: Guides the user through merging locally, creating a Pull Request, keeping the branch, or discarding the work.
  • Worktree Management: Handles the cleanup of associated worktrees.
  • Use Case: After finishing a new feature, use this Skill to safely merge your changes back into the main branch or create a PR, ensuring code quality and a clean repository.

Quick Start

Use the finishing-a-development-branch skill to complete your current work.

Frequently Asked Questions about finishing-a-development-branch

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

FAQPage Schema
How do I safely merge a git feature branch back into the main branch?

To safely merge a git feature branch, you can use a structured workflow that verifies all tests pass, guides you through integration options like merging locally or creating a pull request, and handles worktree cleanup to maintain repository hygiene.

What is the best workflow for completing a development branch before creating a pull request?

The best workflow for completing a development branch involves verifying passing tests, deciding whether to create a pull request, merge locally, keep the branch, or discard the work, and ensuring proper worktree cleanup for safe code integration.

How do I clean up git worktrees after finishing a feature branch?

To clean up git worktrees after finishing a feature branch, follow a structured completion process that includes managing worktree cleanup alongside test verification and integration choices to ensure repository hygiene and safe code integration.

Can I discard work on a development branch instead of merging it?

Yes, you can discard work on a development branch. A structured branch completion workflow presents integration options that include discarding the work, keeping the branch, merging locally, or creating a pull request based on your code completion needs.

Do I need to run tests before merging a git branch locally?

Yes, you need to run tests before merging a git branch locally. Ensuring test verification passes is a required preliminary step in a structured development branch completion workflow before proceeding to any code integration options.