watch-parallel-stacks-cursor

Coordinate dependency-aware parallel task execution with per-lane workers and a durable watcher.

Updated May 18, 2025
One-click install
npx skills add https://github.com/nthpaul/dotfiles --skill watch-parallel-stacks-cursor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: watch-parallel-stacks-cursor
Source: https://github.com/nthpaul/dotfiles/tree/main/cursor/.cursor/skills/watch-parallel-stacks-cursor
Command: npx skills add https://github.com/nthpaul/dotfiles --skill watch-parallel-stacks-cursor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of implementing multiple interdependent tickets efficiently by coordinating parallel workstreams while preserving correct dependency order and PR stacking behavior.

Core Features & Use Cases

  • Dependency-aware parallel orchestration: Runs one long-lived watcher (coordinator) and one worker per active lane, enabling independent lanes to progress in parallel.
  • PR stack lane discipline: Keeps directly dependent tickets in the same lane and worktree so dependent changes can land as an intentional stacked PR sequence.
  • Durable, state-driven monitoring: Maintains a plan-driven state.json, relaunches/resumes behavior when needed, and only marks completion when every task in the plan is finished.

Quick Start

Use the watch-parallel-stacks-cursor skill by generating a JSON plan (with your Linear issue ids, lane definitions, and dependencies) and then running the launcher command with the plan.json path.

Frequently Asked Questions about watch-parallel-stacks-cursor

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

FAQPage Schema
How do I coordinate parallel worktrees for stacked PRs with dependency management?

To coordinate parallel worktrees for stacked PRs, you need a durable watcher and per-lane workers that process a JSON plan with issue ids, keeping dependent tickets in the same worktree. This ensures dependency order is preserved while independent lanes progress concurrently.

How does dependency-aware parallel orchestration work with tmux?

Dependency-aware parallel orchestration with tmux works by generating a long-lived watcher session and separate worker sessions for each active lane. The watcher validates plan dependencies and maintains a state.json file, relaunching workers as needed until all planned tasks are complete.

Do I need tmux to run parallel lane workers for multi-ticket implementation?

Yes, you need tmux installed to run parallel lane workers for multi-ticket implementation. The tool generates tmux-backed watcher and lane sessions to manage the concurrent execution and coordinate the dependency graph across independent workstreams.

What is the best way to manage stacked PR sequences for dependent Linear tickets?

The best way to manage stacked PR sequences for dependent Linear tickets is to group directly dependent tickets in the same lane and worktree. This allows dependent changes to land as an intentional stacked PR sequence while independent tickets proceed in parallel.

How do I create a JSON plan for dependency-aware parallel task execution?

To create a JSON plan for dependency-aware parallel task execution, define your Linear issue ids, assign them to specific lanes, and map their dependencies. The launcher command reads this plan.json file to validate dependencies and generate the tmux sessions.

When should I not use parallel lane orchestration for PR stacking?

You should not use parallel lane orchestration for PR stacking when your tickets lack clear dependency graphs or cannot be grouped into independent lanes. It requires that independent work can proceed concurrently, while blocked and dependent tickets must wait or share a worktree.