finish

Finalize RDPI workflows by validating plan completion, marking todos, and committing artifacts.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/KMakayee/playbook --skill finish-kmakayee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finish
Source: https://github.com/KMakayee/playbook/tree/main/.claude/skills/finish
Command: npx skills add https://github.com/KMakayee/playbook --skill finish-kmakayee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents half-finished RDPI work by verifying plan completion, marking the correct todo item done, and reliably committing both code changes and RDPI artifacts in a clean, traceable way.

Core Features & Use Cases

  • Plan completion guardrail: Reads tasks/plan.md and stops if any checkboxes remain unchecked.
  • Accurate todo completion: Updates tasks/todo.md by selecting the correct task based on the current worktree branch or the first unchecked item as a fallback.
  • Commit + RDPI artifact cleanup: Commits staged changes and required artifact files, then performs a follow-up local cleanup commit that removes RDPI artifacts so the next task starts fresh.
  • Flow-aware behavior: Detects issue-flow worktree branches and instructs you to use /issue-finish instead of /finish.

Quick Start

Run finish to verify tasks/plan.md, mark the appropriate item in tasks/todo.md as done, commit changes plus RDPI artifacts, push the result, and locally clean up the artifact files.

Frequently Asked Questions about finish

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

FAQPage Schema
How do I prevent half-finished git worktree tasks from being committed?

To prevent half-finished worktree tasks from being committed, validate plan completion by checking tasks/plan.md for unchecked boxes before staging. The workflow stops if any checkboxes remain unchecked, ensuring only fully completed tasks proceed to the commit phase.

How do I automatically mark todo items done and commit RDPI artifacts in git?

You can mark todo items done and commit RDPI artifacts by running a completion command that updates tasks/todo.md based on the current worktree branch, stages required artifact files, and uses a two-commit process to push changes and clean up locally.

Does the git commit workflow support both worktree branches and regular branches?

The git commit workflow supports both worktree branches and regular branches. It applies to RDPI todo task flow on dedicated worktree branches, and falls back to regular branches when no worktree naming convention is detected.

Why does my workflow tell me to use issue-finish instead of a regular commit?

Your workflow instructs you to use issue-finish because the branch is detected as an issue-flow worktree branch. The system identifies the specific branch naming convention and redirects you to the appropriate issue-flow completion command.

What is the two-commit process for RDPI artifact cleanup?

The two-commit process for RDPI artifact cleanup involves committing staged code changes and required artifact files first, pushing the result, and then performing a follow-up local cleanup commit that removes RDPI artifacts so the next task starts fresh.