wt

Implements tasks in isolated Tollgate git worktrees with speculative CI validation and gated promotion.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It prevents unreviewed or untested code from reaching your release and master branches by isolating every task in its own git worktree, running speculative CI through Tollgate before approval, and requiring one explicit promotion mandate before anything merges. ## Core Features & Use Cases - Isolated worktree implementation: Creates a fresh Tollgate-managed git worktree from the local release branch so task work never touches your primary checkout. - Speculative candidate submission: Submits the exact immutable commit as a non-promotable Tollgate candidate so CI runs while you review, overlapping validation with review time. - Bounded promotion workflow: After one explicit Yes/No approval, authorizes exact candidates, repairs in-scope CI failures without repeated prompts, and drives certified promotion to local release and remote master. - Review artifacts: Generates a clickable VS Code Worktree Review link, optional demo servers on non-default ports, and verified screenshots before the promotion question. - Use Case: Ask the agent to implement a bug fix; it creates a worktree, commits the change, submits it for speculative CI, presents review evidence, and only promotes to release and pushes master after you approve. ## Quick Start Ask the agent to implement a specific task using the wt workflow, for example: implement the login form validation fix in a Tollgate worktree and submit it for review.

Frequently Asked Questions about wt

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

FAQPage Schema
How do I implement a task in an isolated git worktree?▼

Create a fresh worktree with tg --no-launch worktree create before making any repository modification, then implement, verify, and commit entirely inside that worktree. Never edit the user's primary working tree once implementation begins.

What is a Tollgate candidate and how does speculative CI work?▼

A Tollgate candidate is an immutable submitted commit that CI validates speculatively without promotion authority. Submitting immediately after the commit lets validation overlap with user review time, and promotion only happens after explicit approval.

Can I reuse an existing worktree from a previous session?▼

No. Worktree ownership is categorical: you may only use a worktree you created in the same conversation. If a similar worktree exists, choose a new slug and create a fresh one, or ask the user for clarification.

What happens when CI fails after promotion is approved?▼

Run tg diagnose to attribute the failure, repair it in the same worktree if it stays within the approved scope, amend the commit, and submit a replacement candidate. The original mandate covers these repair iterations without asking again.

Why must I not use git worktree add or manual promotion commands?▼

Raw git worktree add bypasses Tollgate's placement and registration policy, while manual rebases, merges, or pushes replace the exact tested object and race Tollgate's authoritative queue state. Only tg commands preserve exact-promotion guarantees.