finishing-a-development-branch

Run three-tier validation and compute readiness scores for development branches.

2|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon-framework --skill finishing-a-development-branch-krzemienski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/krzemienski/shannon-framework/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill finishing-a-development-branch-krzemienski

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, three-tier readiness validation for development branches, plus MCP analysis and Serena risk assessment to guide merge decisions.

Core Features & Use Cases

  • Three-tier validation: Tier 1 (tests), Tier 2 (code quality), Tier 3 (integration readiness).
  • Readiness scoring: Overall score guides merge decisions.
  • MCP pattern analysis: Compare against historical merges for risk.
  • Merger options: Present choices to merge, PR, keep as-is, or discard.

Quick Start

Run Tier 1 tests, then Tier 2/3 checks; compute readiness_score and choose one of four merge options.

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 validate if a development branch is ready to merge?

Branch readiness validation enforces three-tier checks: Tier 1 runs automated tests, Tier 2 analyzes code quality and MCP patterns, and Tier 3 verifies integration prerequisites. A readiness score (0.00–1.00) summarizes all checks to guide merge decisions.

What is MCP pattern analysis and why does it matter for merge decisions?

MCP pattern analysis compares your branch against historical merges to identify integration risk. This assessment feeds into the overall readiness score and helps determine whether a branch should merge, stay open as a PR, remain unpublished, or be discarded.

How does Serena risk telemetry contribute to merge readiness?

Serena risk telemetry provides integration risk metrics that inform the three-tier validation and readiness scoring. These metrics, combined with test results and code quality analysis, establish quantitative gate thresholds to determine merge safety.

Can I use branch readiness validation with CI systems?

Yes. The Skill integrates with CI pipelines to enforce Tier 1 test execution, Tier 2 code quality checks, and Tier 3 integration validation. Results feed directly into merge gate decisions and readiness scoring within your workflow.

What happens if my branch fails readiness checks?

Failed checks lower your readiness score, indicating merge risk. The Skill presents four options: merge anyway, open as a PR for review, keep the branch unpublished, or discard it. Lower scores signal which tiers need attention before proceeding.

Do I need specific test infrastructure to run branch validation?

The Skill requires automated tests to execute Tier 1 validation and integration checks to run Tier 3 assessment. Your CI system must support test execution and code quality analysis; the Skill orchestrates these within its three-tier framework.