dev

Orchestrate Momentum story development with isolated worktrees and completion signals.

Updated Mar 10, 2026
One-click install
npx skills add https://github.com/iamsteveholmes/momentum --skill dev-iamsteveholmes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev
Source: https://github.com/iamsteveholmes/momentum/tree/main/skills/momentum/skills/dev
Command: npx skills add https://github.com/iamsteveholmes/momentum --skill dev-iamsteveholmes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Momentum dev workflow automates end-to-end story execution by orchestrating story selection, per-story git worktrees, and delegation to the bmad-dev-story agent, emitting a completion signal when complete.

Core Features & Use Cases

  • End-to-end orchestration: selects ready-for-dev stories, spins up isolated worktrees, and delegates to the Dev Story agent.
  • State management: uses lock files to track in-progress sessions and prevent cross-session conflicts.
  • Integrity and handoff: emits a structured completion signal for downstream validation and merge readiness.

Quick Start

Run momentum:dev to start the end-to-end dev workflow for the next ready story.

Frequently Asked Questions about dev

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

FAQPage Schema
How do I automate git worktree lifecycle management for story development?

You can automate git worktree lifecycle management by running an orchestration executor that selects ready-for-dev stories, creates isolated per-story worktrees, and delegates implementation to a development agent. It tracks in-progress sessions using lock files to prevent cross-session conflicts.

How do I prevent cross-session conflicts when running parallel dev story workflows?

Prevent cross-session conflicts during parallel dev story workflows by using an orchestration executor that enforces isolated per-story worktrees and tracks active sessions with lock files. This ensures only one session operates on a story at a time.

How does a completion signal work for downstream validation after story development?

A completion signal works by writing a structured output after story development finishes. This signal emits merge readiness data for downstream validation, allowing the Momentum pipeline to verify that the delegated dev story task completed successfully.

Do I need specific dependencies to orchestrate end-to-end Momentum story development?

Orchestrating end-to-end Momentum story development does not require external dependencies. The executor operates independently to select ready stories, manage worktree lifecycles, and write completion signals, though it delegates actual implementation to the bmad-dev-story agent.

What is the best way to integrate isolated worktrees with a continuous development pipeline?

The best way to integrate isolated worktrees with a continuous development pipeline is to use an orchestration executor that manages the full worktree lifecycle and emits structured completion signals. This bridges automated story selection directly with downstream pipeline validation.

Why does dev story orchestration target only ready-for-dev stories?

Dev story orchestration targets only ready-for-dev stories to ensure the automated workflow picks up actionable tasks. It selects stories that have cleared upstream planning, creates their isolated worktrees, and delegates them to the development agent for implementation.