finishing-branch

Finishing a Branch

Complete development work with verification, memory storage, and merge options.

Announce: "I'm using the finishing-branch skill to complete this work."

The Flow

Verify Tests → EC Review → Present Options → Execute

Step 1: Verify Tests @verifying

Load project config:

ec_search:
  query: project config
  type: config

Run all verifications:

{test_command}
{lint_command}
{build_command}

If failures: Stop. Fix using @debugging before proceeding.

If passing: Continue.

Step 2: EC Review

Before finishing, review what's worth remembering.

Look at what changed:

git log --oneline main..HEAD
git diff --stat main..HEAD

Use AskUserQuestion:

{
  "questions": [{
    "question": "Any decisions, learnings, or patterns worth storing in EC?",
    "header": "Memory",
    "options": [
      { "label": "Yes", "description": "I'll describe what to store" },
      { "label": "No", "description": "Nothing notable this time" },
      { "label": "Let me suggest", "description": "Claude proposes, I approve" }
    ],
    "multiSelect": false
  }]
}

If "Let me suggest" - analyze the changes and propose:

• decisions - Architectural choices made
• learnings - Gotchas discovered during implementation
• patterns - New conventions established

For each approved memory:

ec_add:
  type: decision|learning|pattern
  area: [component]
  content: [What to remember]
  rationale: [Why it matters]

Step 3: Present Options

Load branch convention:

ec_search:
  query: project config branch
  type: config

{
  "questions": [{
    "question": "How do you want to finish this branch?",
    "header": "Finish",
    "options": [
      { "label": "Create PR", "description": "Push and open pull request" },
      { "label": "Merge locally", "description": "Merge to main locally" },
      { "label": "Keep as-is", "description": "I'll handle it later" },
      { "label": "Discard", "description": "Delete this branch and work" }
    ],
    "multiSelect": false
  }]
}