# Tsz Worktree Intake

> 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.

- Skill: `tsz-org/tsz-worktree-intake` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tsz-org/tsz-worktree-intake`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tsz-org/tsz-worktree-intake/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: tsz-org (https://skillmd.com/u/tsz-org)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tsz-org/tsz-worktree-intake

---


# TSZ Worktree Intake

Use before non-trivial TSZ work.

## Fast Path

```bash
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:

```bash
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.