| name | worktree-health |
| description | Use this skill to review current checkout authority, run-bundle drift, legacy worktree cleanup evidence, and cleanup readiness. |
Worktree Health
Tool Commands
Use the command packet before applying this skill's workflow:
python3 tools/agent_tools/skill_tool_commands.py show --skill worktree-health --format text
Execute the required and task-matching conditional commands that the packet prints.
- Read
agents/skills/worktree-health.md.
- Read
reports/agents/.active_run, task_authority.yaml, and team_manifest.yaml before judging current checkout write authority.
- Open
WORKTREE_SCOPE.md and any legacy worktree action log as cleanup evidence only; do not treat them as scope authority for new work.
- Run
python3 tools/agent_tools/worktree_scope_lint.py --current only when legacy cleanup is in scope.
- Check
git status --short --branch, git diff --name-only, and git worktree list --porcelain.
- Treat
git branch --show-current and git worktree list --porcelain as diagnostics; branch/worktree creation is routed by agents/canonical/CODEX_WORKFLOW.md Branch Reuse Default and branch_worktree_guard.py, while this skill checks only the recorded branch_creation_reason=<reason> or worktree_creation_reason=<reason> evidence.
- Re-read
notes/guardrails/README.md and notes/failures/README.md when drift, cleanup, or carry-over risk is not obvious.
- Run
bash tools/docs/check_worktree_scopes.sh when legacy drift or stale worktrees are possible.
- Check task-authority drift, runtime output drift, carry-over readiness, and cleanup readiness before continuing or deleting a worktree.