claude-code-config: Skill for Claude Code

Automate the full issue-to-coding flow: create issue (if needed) → wait for CR plan → merge plans → create worktree + branch → output ready-to-code summary. Replaces 5-10 minutes of manual setup per issue.

Step 0: Resolve shared tooling

/start-issue is symlinked into every repo, but its helper scripts and reference docs are not — most repos carry no .claude/ directory. Resolve them; never invoke a bare .claude/scripts/… path. Full contract and the classified dependency inventory: .claude/reference/portable-skill-resolution.md (issue #1189).

resolve_script() {
  local name="$1" candidate
  for candidate in \
    "$HOME/.claude/skills-worktree/.claude/scripts/$name" \
    "$HOME/.claude/scripts/$name" \
    ".claude/scripts/$name"; do
    if [[ -x "$candidate" ]]; then echo "$candidate"; return 0; fi
  done
  return 1
}
ISSUE_CLAIM=$(resolve_script issue-claim.sh || true)
CR_PLAN=$(resolve_script cr-plan.sh || true)
ISSUE_DEDUP=$(resolve_script issue-dedup.sh || true)
REPO_ROOT_SH=$(resolve_script repo-root.sh || true)
SPLIT_THRESHOLDS=$(resolve_script split-thresholds.sh || true)

Read reference docs through the same order — $HOME/.claude/skills-worktree/.claude/reference/<name> first, then $HOME/.claude/reference/, then .claude/reference/. That covers chip-launching.md, autofile-dedup.md, and issue-claim.md.

When something does not resolve, say so in one line; never skip the contract silently.

• chip-launching.md unreadable → required. Print ERROR: chip-launching.md not found (checked all three paths) — PM-context inline gate unavailable and stop before offering a chip; without the gate a subagent-fit issue routes to its own thread instead of the inline pipeline (#1189).

• ISSUE_CLAIM empty → optional, but loud. Print DEGRADED: issue-claim.sh not found (checked all three paths) — Step 2b gate cannot run, proceeding unclaimed and continue. Say it once, in the visible output — an unclaimed start that nobody was told about is how two threads end up on one issue.

• CR_PLAN empty → optional. Print DEGRADED: cr-plan.sh not found (checked all three paths) — CR plan detection skipped and go straight to Step 4; Claude's own plan and the issue-body merge are still mandatory.

• ISSUE_DEDUP empty → optional. Print DEGRADED: issue-dedup.sh not found (checked all three paths) — duplicate search skipped and continue.

• REPO_ROOT_SH empty → optional. Fall back to git worktree list --porcelain | awk '/^worktree /{sub(/^worktree /, ""); print; exit}'; no warning needed, the inline form is equivalent.

• SPLIT_THRESHOLDS empty → optional. Print DEGRADED: split-thresholds.sh not found (checked all three paths) — using default thresholds 180/120 and read Step 7's time trigger against those defaults. The thresholds are knobs, so an unresolved helper must be said, not silently defaulted — a lowered SPLIT_OVER_MIN that never loaded is a split that never fires.

  Read both knobs, in one call, the way /issue-maker's sizing block does — "$SPLIT_THRESHOLDS" --json, then SPLIT_OVER_MIN and INCREMENT_BOUND_MIN out of it with jq, both or neither, keeping the documented 180/120 on a partial read. Step 7's trigger only needs the first, but its split branch runs /subagent Step 5.1, which bounds every child it files at or under the second; resolving one knob here and letting the decomposition fall back to a default the config overrode is how a chain gets filed against a bound nobody chose.