skills.rest
felho
felhoCOMMUNITY
Explore all skills by this author →
GitHub

UsePairflow

Automate Pairflow bubble lifecycle management with state-aware routing and gated transitions.

26|4|Updated Feb 21, 2026
Search Tags:#workflow#orchestration#worktree#tmux#state-machine#bubble#pairflow
One-click install
npx skills add https://github.com/felho/pairflow --skill usepairflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: UsePairflow
Source: https://github.com/felho/pairflow/tree/main/.claude/skills/UsePairflow
Command: npx skills add https://github.com/felho/pairflow --skill usepairflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pairflow bubbles can be mismanaged without strict state routing, leading to wasted time, lost work, and fragile handoffs. This skill enforces a state-aware lifecycle for creating, starting, intervening, reviewing, and closing bubbles, with safety checks and guardrails to keep operations deterministic.

Core Features & Use Cases

  • State-aware lifecycle orchestration for bubble workflows (create, start, kickoff, status, intervene, troubleshoot, review, approve, commit, merge, recover, and bootstrap evidence).
  • Workflow templates and routing guidelines that prevent common lifecycle mistakes and ensure consistent operations across local and remote bubbles.
  • Support for evidence bootstrap and audit-friendly handoffs via the evidence workflow.

Quick Start

Create a bubble using the provided workflows, then start it and monitor status to determine the next recommended action.

Frequently Asked Questions about UsePairflow

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

FAQPage Schema
What is state-aware workflow orchestration for bubble lifecycles?▼

State-aware bubble orchestration enforces strict state validation and guarded commands across a bubble's lifecycle, preventing mismanaged transitions and ensuring deterministic operations from creation to merge.

How do I create and start a bubble workflow with safe state transitions?▼

Use provided workflow templates to create a bubble, start it, and monitor its status to determine the next recommended action for safe state transitions throughout the lifecycle.

Can I recover lost work or troubleshoot a stuck bubble state machine?▼

Yes, the state machine supports specific troubleshoot and recover workflows designed to rescue lost work and safely resume operations from failed or stuck bubble states.

How does evidence bootstrap planning work for audit-friendly handoffs?▼

Evidence bootstrap planning captures structured artifacts during the bubble workflow, ensuring audit-friendly handoffs by validating state transitions and recording evidence before commit and merge.

Does Pairflow orchestration work with tmux and worktree environments?▼

Pairflow orchestration operates across local and remote bubbles, integrating with tmux and worktree setups to maintain consistent workflow routing and structured artifact handling.

Why do bubbles fail during commit and merge without gated transitions?▼

Without gated transitions, bubbles lack explicit state validation, leading to fragile handoffs and failed commits; enforcing strict state-aware routing prevents these common workflow mistakes.

Related Skills

Explore More Software Engineering Skills→
INNERJOINTINNERJOINT

project-session-manager

Manage isolated git worktrees and tmux sessions for issues and pull requests.

Community
Advanced
RobbyMo81RobbyMo81

prepare-pr

Rebase GitHub pull requests onto main, fix review findings, and run build gates.

Community
Advanced
calcosmiccalcosmic
9

colony-lifecycle

Enforce lifecycle state transitions and generate Next Up prompts for multi-step workflows.

Community
Advanced
Alpizar28Alpizar28

State Machine Specialist

Define and validate deterministic state machine lifecycles for reservation entities.

Community
Advanced