butler-flow

Orchestrate GitButler CLI feature lifecycles with plan-driven surgical commits.

33|2|Updated Feb 21, 2025
One-click install
npx skills add https://github.com/yspreen/dotfiles --skill butler-flow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: butler-flow
Source: https://github.com/yspreen/dotfiles/tree/main/.agents/skills/butler-flow
Command: npx skills add https://github.com/yspreen/dotfiles --skill butler-flow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates a complete feature lifecycle from idea to implementation using the GitButler CLI, enabling disciplined branch management and plan-driven commits.

Core Features & Use Cases

  • End-to-end feature workflow: gather context, name a branch, create it, enter plan mode, and execute a plan with surgical commits using but.
  • Supports parallel agents workflows with strict isolation: ignore changes not from YOUR plan, verify after every commit.
  • Plan-driven collaboration: uses a structured Markdown plan containing Branch info, Version Control Rules, and commit steps.

Quick Start

Initiate a feature request, then follow the Butler Flow to name a branch, generate a plan, and perform surgical commits using the but CLI.

Frequently Asked Questions about butler-flow

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

FAQPage Schema
How do I manage branch creation and surgical commits for a new feature workflow?

Feature workflow management uses the GitButler CLI to orchestrate branch creation, enter plan mode, and execute surgical commits. You gather context, name a branch, generate a structured Markdown plan, and verify changes using but diff and but status after each commit.

What is plan-driven collaboration for parallel agents using GitButler?

Plan-driven collaboration for parallel agents uses a structured Markdown plan containing branch info, version control rules, and commit steps to enforce strict isolation. Agents ignore changes not from their own plan and verify outputs using but diff and but status after every surgical commit.

How do I execute a formal plan document with exact but commands for feature development?

Executing a formal plan document requires entering plan mode via the GitButler CLI and following a structured Markdown plan embedded with exact but commands. The workflow enforces surgical commits and mandates verification using but diff and but status after each commit step.

Does GitButler CLI support strict isolation for parallel agents working on the same repository?

GitButler CLI supports strict isolation for parallel agents by enforcing plan-driven commits. Agents follow a structured Markdown plan, ignore changes not from their own plan, and verify their specific feature lifecycle outputs using but diff and but status after every commit.

When should I use a plan-driven commit workflow instead of standard branch management?

A plan-driven commit workflow is necessary when starting new features or bug fixes in environments with parallel agents. It enforces strict isolation and requires a formal plan document with exact but commands, ensuring surgical commits and verification using but diff and but status.

Why does feature lifecycle orchestration require verification after every commit?

Feature lifecycle orchestration requires verification after every commit to maintain strict isolation in parallel agent environments. Running but diff and but status after each surgical commit ensures that only changes from your specific structured Markdown plan are applied to the branch.