Tsz Worktree Intake
Productivitytsz-worktree-intakeTsz 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
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.