wt-sequence

Executes multi-task implementation plans as stacked commits with overlapping review and speculative work.

1|Updated Dec 18, 2009
One-click install
npx skills add https://github.com/thurn/dotfiles --skill wt-sequence-thurn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wt-sequence
Source: https://github.com/thurn/dotfiles/tree/main/.llms/skills/wt-sequence
Command: npx skills add https://github.com/thurn/dotfiles --skill wt-sequence-thurn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Implementing a multi-task plan serially wastes time waiting for each task's review before starting the next. This Skill pipelines the work: it keeps exactly one task under review while speculatively implementing the next task in the same Git worktree, promoting each approved task independently through Tollgate. ## Core Features & Use Cases - Rolling task pipeline: Maintains one task under review and at most one speculative task in flight, submitting each as an independently valid commit candidate. - Pinned review links: Generates VS Code worktree-review URLs pinned to the exact reviewed commit, excluding speculative descendants and uncommitted changes. - Feedback interruption and restacking: Stashes speculative work, amends the reviewed commit, and rebases descendants with git rebase --onto when review feedback arrives. - Private state ledger: Tracks task commits, candidate IDs, review state, stashes, and runtime resources via scripts/ledger.py stored in the worktree's private Git metadata. - Use Case: Given a five-task implementation plan, the Skill commits task 1, hands it off for review, immediately implements task 2 speculatively, then promotes task 1 on approval and repeats until the final task triggers automatic worktree cleanup. ## Quick Start Use wt-sequence to implement this task-by-task plan, reviewing and promoting each task separately while working ahead on the next one.

Frequently Asked Questions about wt-sequence

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

FAQPage Schema
How do I implement a multi-task plan with per-task code review?▼

Invoke wt-sequence with an ordered task plan. It commits each task independently, submits it as a Tollgate candidate, presents a pinned review link, and speculatively implements the next task while you review the current one.

How does speculative implementation overlap with code review?▼

After freezing task N as a commit, the Skill immediately starts task N+1 in the same worktree. The review link is pinned to task N's exact commit OID, so the reviewer never sees the speculative descendant or uncommitted changes.

What happens when review feedback arrives during speculative work?▼

Speculative work is preserved in a named git stash, the reviewed commit is amended with the feedback, and descendants are restacked using git rebase --onto. Replacement candidates are submitted and a fresh approval is required for the amended commit.

When should I use wt instead of wt-sequence?▼

Use wt for any single-task request; wt-sequence explicitly refuses one-task plans and requires at least two tasks. wt-sequence inherits all of wt's isolation, verification, and promotion rules but adds the rolling review-and-speculation pipeline.

What tooling does wt-sequence require to run?▼

It requires Tollgate with --retain-worktree support on candidate and approve commands, the dthurn.worktree-review VS Code extension version 0.3.0 or newer, and a clean tg status and doctor check before starting a sequence.

Can a promoted commit be amended if a problem is found later?▼

No. Promoted commits are never amended. Corrections discovered after promotion must be represented as a new plan task, preserving the integrity of the already-pushed history.