finishing-a-development-branch

Verify tests and present branch integration options for development completion.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/thiagobutignon/nooa-the-pragmatic --skill finishing-a-development-branch-thiagobutignon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/thiagobutignon/nooa-the-pragmatic/tree/main/.agent/skills/finishing-a-development-branch
Command: npx skills add https://github.com/thiagobutignon/nooa-the-pragmatic --skill finishing-a-development-branch-thiagobutignon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured process to finalize development work, ensuring code quality and offering clear, safe options for integrating changes into the main codebase.

Core Features & Use Cases

  • Test Verification: Automatically checks if all tests pass before proceeding.
  • Branch 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 to maintain a clean development environment.
  • Use Case: After completing a new feature, use this Skill to ensure tests are green, then choose the best way to merge your code, whether it's a direct local merge or a formal Pull Request.

Quick Start

Use the finishing-a-development-branch skill to finalize 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 finalize a git development branch and ensure code quality before integration?

To finalize a development branch, you need to verify that all tests pass and perform mandatory dogfooding before choosing an integration path. This process ensures code quality and presents structured options like merging locally or creating a pull request.

What's the best way to merge a finished feature branch locally or create a pull request?

The best way to merge a feature branch is to use a guided workflow that checks test status first, then offers structured integration options. You can choose between a direct local merge, a formal pull request, keeping the branch, or discarding the work.

How does branch management handle worktree cleanup after merging?

Branch management handles worktree cleanup by automatically managing and removing associated worktrees after you select an integration option. This maintains a clean development environment once your development work is finalized and merged.

Can I discard my development work instead of merging a branch?

Yes, you can discard your development work instead of merging. When finalizing a branch, the workflow presents multiple options including discarding the work entirely, keeping the branch, merging locally, or submitting a pull request.

Do I need to run tests manually before creating a pull request?

You do not need to run tests manually before creating a pull request if you use a guided finalization process. The workflow automatically performs test verification to ensure all checks pass before offering pull request creation as an integration option.

Why does my code integration fail when tests are not passing?

Code integration fails when tests are not passing because the finalization workflow mandates test verification before proceeding. Ensuring tests are green is a required step to guarantee code quality before any branch merging or pull request options are presented.