OpenParable
Skip to content
← Back to skills

Tsz Worktree Intake

Productivity
tsz-worktree-intake

Tsz Worktree Intake is an Agent Skill for productivity published in the tsz-org/tsz repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Start TSZ work safely in a crowded multi-agent checkout. Use when beginning a TSZ task, resuming a goal, switching or creating branches/worktrees, recovering from a merged or stale branch, checking disk/cache state, picking a roadmap goal, or deciding whether local dirty files belong to the requested work.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/tsz-org/tsz/blob/HEAD/.agents/skills/tsz-worktree-intake/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/tsz-worktree-intake, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

TSZ Worktree Intake

Use before non-trivial TSZ work.

Fast Path

git fetch origin main
sed -n '1,260p' docs/plan/ROADMAP.md
git status --short --branch
scripts/agents/disk-preflight.sh
git worktree list
gh pr list --state open --limit 100 --json number,title,isDraft,headRefName,baseRefName,labels,updatedAt,url
gh issue list --state open --limit 100 --json number,title,labels,updatedAt,url

Pick the roadmap goal the work serves (green, fast, grow, or hold); docs/plan/ROADMAP.md is the only planning doc.

If disk is low or worktree reuse is unclear, use tsz-disk-cache-hygiene. Read references/common-failure-modes.md only for stale merged branches, dirty same-path files, low disk, missing TS corpus, or overlapping active PRs.

Branch/Worktree Decision

  • Continue current branch only if it is the active PR branch for this work.
  • Otherwise create a fresh branch from origin/main.
  • Reuse inactive sister worktrees when useful. New worktrees go beside this checkout:
git worktree add ../tsz-<scope> -b codex/<scope>-<yyyymmdd> origin/main
cd ../tsz-<scope>
scripts/setup/link-ts-submodule.sh

Do not run broad du, cargo clean, or destructive cache cleanup as intake.

State The Decision

Before editing, say one sentence: continue existing PR, start fresh branch, handoff/unblock draft, or file an issue. For behavior work also state the structural rule and owner layer; for process/docs work state the recurring cost and evidence.

Stop

Pause for stronger evidence if overlap is ambiguous, branch is merged with local-only changes, dirty files affect your paths, TS corpus is needed but missing, or the next command would destroy caches/state.