start-thread

Start or resume a thread — scratch workspace with a handoff doc

Topic requested: $ARGUMENTS

Project + config: !bun "${CLAUDE_PLUGIN_ROOT}/scripts/where.ts"

Current branch: !git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "(not a git repo)"

Existing threads: !bun "${CLAUDE_PLUGIN_ROOT}/scripts/threads.ts" --slugs

Do this

1. If $ARGUMENTS is empty, ask for the topic — don't guess.
2. Normalize the topic to a slug — run via Bash: bun "${CLAUDE_PLUGIN_ROOT}/scripts/slug.ts" "<topic>" (one shared identity function — never re-implement slugging by hand; if the variable shows as a literal, use the plugin root: path from the injected block above). With ticket_system: none a thread is any unit of work; ticket-system adapters may extend this later.
3. If <scratch_root>/<slug>/ already has a STATE doc → RESUME. This is the normal day-2 path, not an error: no questions, no "want me to open it?" menu — brief and get to work. Treat slugs as the SAME thread when they match ignoring case and separators (CP-1758 ≡ cp-1758 ≡ cp1758 — the normalizeForMatch rule in scripts/lib/identity.ts): a near-match in the existing-threads list above resumes THAT thread. Never overwrite or re-scaffold an existing STATE (skip steps 4–6 entirely). Do all of this:
   1. Read the whole STATE doc — Status, the ask, plan, current state, open/deferred.
   2. Pull live deltas (parallel; each optional-degrade — an unreachable source gets a one-line note, never stalls the resume): current branch; a git worktree list / git branch --list match on the slug; if a matching worktree/branch exists — git status --porcelain (dirty files) and gh pr list --head <branch> --state all --json number,state,reviewDecision --limit 1 (when gh resolves).
   3. Report a resume briefing — where the user left off (Status, next plan step, open items), then what changed since (branch moved / PR merged / dirty files). Explicitly flag any live fact that CONTRADICTS the STATE. End ready to work — not with a menu.
   4. Resume is read-only on the STATE doc — flag drift in the briefing; the session updates STATE as work actually proceeds (the state-freshness-guard Stop hook enforces this before the session ends).
4. Seed the ask from the conversation — there is no ticket system to pull from. If the goal isn't clear from context, ask for one line. Mark anything unknown as TODO rather than inventing.
5. Create <scratch_root>/<slug>/ and write the STATE doc from the template below, filling the frontmatter (title: <slug> · kind: thread · summary: one-line blurb) and The ask. Use the state_basename from the injected config block (default STATE.md).
6. Version-control check: if this is a git repo and <scratch_root> is not ignored (git check-ignore -q <scratch_root> fails), ASK whether to add it to .gitignore — some people want the notebook versioned, some never want notes in PRs. Don't silently do either.
7. Report the path created and a one-line summary. (No need to run /ccx:save-state for indexing — the auto-compile-index hook recompiles the INDEX on every STATE write.)