tracerkit 1.17.0 → 1.17.2

package/README.md

@@ -98,7 +98,6 @@ Same skills, same workflow. Storage is configured per-project:
 
 ```bash
 tracerkit config storage github         # set current project to use GitHub
-tracerkit config github.repo org/repo   # set target repo
 ```
 
 PRDs and plans become GitHub Issues with `tk:prd` and `tk:plan` labels. On `/tk:check` pass, issues are closed with `completed` reason and any related PRs are linked automatically. Each project can use a different backend; local is the default. See [Configuration](docs/configuration.md) for details.

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as e, f as t, i as n, l as r, n as i, o as a, p as o, r as s, s as c, t as l, u } from "./uninstall-Ba_zfPOx.js";
+import { a as e, f as t, i as n, l as r, n as i, o as a, p as o, r as s, s as c, t as l, u } from "./uninstall-CNw_7khV.js";
 import { existsSync as d, readFileSync as f, statSync as p } from "node:fs";
 import { dirname as m, join as h, resolve as g } from "node:path";
 import { fileURLToPath as _ } from "node:url";

package/dist/index.js

@@ -1,2 +1,2 @@
-import { c as e, i as t, n, o as r, r as i, t as a, u as o } from "./uninstall-Ba_zfPOx.js";
+import { c as e, i as t, n, o as r, r as i, t as a, u as o } from "./uninstall-CNw_7khV.js";
 export { r as COMMANDS, e as DEPRECATED_SKILLS, o as SKILL_NAMES, i as init, n as migrateStorage, a as uninstall, t as update };

package/dist/{uninstall-Ba_zfPOx.js → uninstall-CNw_7khV.js}

@@ -25,32 +25,29 @@ function _(t) {
 		throw Error("Invalid .tracerkit/config.json — expected valid JSON");
 	}
 	return {
-		storage: v(i.storage),
-		paths: y(i.paths),
-		github: b(i.github)
+		storage: ee(i.storage),
+		paths: v(i.paths),
+		github: y(i.github)
 	};
 }
-function v(e) {
+function ee(e) {
 	return typeof e == "string" && m.includes(e) ? e : f;
 }
-function y(e) {
-	let t = C(e) ? e : {};
+function v(e) {
+	let t = S(e) ? e : {};
 	return {
 		prds: typeof t.prds == "string" ? t.prds : h.prds,
 		plans: typeof t.plans == "string" ? t.plans : h.plans
 	};
 }
-function b(e) {
-	let t = C(e) ? e : {}, n = C(t.labels) ? t.labels : {};
-	return {
-		...typeof t.repo == "string" ? { repo: t.repo } : {},
-		labels: {
-			prd: typeof n.prd == "string" ? n.prd : g.labels.prd,
-			plan: typeof n.plan == "string" ? n.plan : g.labels.plan
-		}
-	};
+function y(e) {
+	let t = S(e) ? e : {}, n = S(t.labels) ? t.labels : {};
+	return { labels: {
+		prd: typeof n.prd == "string" ? n.prd : g.labels.prd,
+		plan: typeof n.plan == "string" ? n.plan : g.labels.plan
+	} };
 }
-function x(r, i) {
+function b(r, i) {
 	let o = c(r, ".tracerkit", "config.json");
 	t(s(o), { recursive: !0 });
 	let l = {};
@@ -59,31 +56,31 @@ function x(r, i) {
 	} catch {
 		l = {};
 	}
-	let u = S(l, i);
+	let u = x(l, i);
 	a(o, JSON.stringify(u, null, 2) + "\n");
 }
-function S(e, t) {
+function x(e, t) {
 	let n = { ...e };
-	for (let e of Object.keys(t)) C(n[e]) && C(t[e]) ? n[e] = S(n[e], t[e]) : n[e] = t[e];
+	for (let e of Object.keys(t)) S(n[e]) && S(t[e]) ? n[e] = x(n[e], t[e]) : n[e] = t[e];
 	return n;
 }
-function C(e) {
+function S(e) {
 	return typeof e == "object" && !!e && !Array.isArray(e);
 }
-var w = [
+var C = [
 	"tk:brief",
 	"tk:prd",
 	"tk:plan",
 	"tk:check"
-], T = ["tk:verify"], E = {
+], w = ["tk:verify"], T = {
 	force: "--force",
 	help: "--help",
 	version: "--version"
-}, D = [
+}, E = [
 	"brief",
 	"progress",
 	"archive"
-], O = [
+], D = [
 	{
 		name: "init",
 		args: "[path]",
@@ -109,44 +106,44 @@ var w = [
 		args: "[path]",
 		desc: "Migrate artifacts between local and GitHub storage backends"
 	}
-], k = c(s(u(import.meta.url)), "..", "skills");
-function A(e, t = "") {
+], O = c(s(u(import.meta.url)), "..", "skills");
+function k(e, t = "") {
 	let n = r(e, { withFileTypes: !0 }), i = [];
 	for (let r of n) {
 		let n = t ? `${t}/${r.name}` : r.name;
-		r.isDirectory() ? i.push(...A(c(e, r.name), n)) : i.push(n);
+		r.isDirectory() ? i.push(...k(c(e, r.name), n)) : i.push(n);
 	}
 	return i.sort();
 }
-function j(e) {
+function A(e) {
 	return `.claude/skills/tk:${e}`;
 }
-function M(e) {
+function j(e) {
 	return e.slice(18);
 }
-function N(e, t) {
+function M(e, t) {
 	let n = e;
-	return t.paths.prds !== h.prds && (n = n.replaceAll(h.prds, t.paths.prds)), t.paths.plans !== h.plans && (n = n.replaceAll(h.plans, t.paths.plans)), t.github?.repo && (n = n.replaceAll("{{github.repo}}", t.github.repo)), t.github?.labels?.prd && (n = n.replaceAll("{{github.labels.prd}}", t.github.labels.prd)), t.github?.labels?.plan && (n = n.replaceAll("{{github.labels.plan}}", t.github.labels.plan)), n;
+	return t.paths.prds !== h.prds && (n = n.replaceAll(h.prds, t.paths.prds)), t.paths.plans !== h.plans && (n = n.replaceAll(h.plans, t.paths.plans)), t.github?.labels?.prd && (n = n.replaceAll("{{github.labels.prd}}", t.github.labels.prd)), t.github?.labels?.plan && (n = n.replaceAll("{{github.labels.plan}}", t.github.labels.plan)), n;
 }
-function P(e, r, i) {
-	let o = i ?? A(k).map(j);
+function N(e, r, i) {
+	let o = i ?? k(O).map(A);
 	for (let i of o) {
-		let o = c(k, M(i)), l = c(e, i);
-		t(s(l), { recursive: !0 }), a(l, N(n(o, "utf8"), r));
+		let o = c(O, j(i)), l = c(e, i);
+		t(s(l), { recursive: !0 }), a(l, M(n(o, "utf8"), r));
 	}
 	return { copied: o };
 }
-function F(e) {
+function P(e) {
 	return l("sha256").update(e).digest("hex");
 }
-function I(t, r) {
-	let i = A(k).map(j), a = [], o = [], s = [];
+function F(t, r) {
+	let i = k(O).map(A), a = [], o = [], s = [];
 	for (let l of i) {
 		let i = c(t, l);
 		if (!e(i)) s.push(l);
 		else {
-			let e = N(n(c(k, M(l)), "utf8"), r);
-			F(Buffer.from(e)) === F(n(i)) ? a.push(l) : o.push(l);
+			let e = M(n(c(O, j(l)), "utf8"), r);
+			P(Buffer.from(e)) === P(n(i)) ? a.push(l) : o.push(l);
 		}
 	}
 	return {
@@ -157,10 +154,10 @@ function I(t, r) {
 }
 //#endregion
 //#region src/commands/update.ts
-function L(t, n) {
-	if (!w.some((n) => e(c(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — run `tracerkit init` first");
-	let r = _(t), { unchanged: a, modified: o, missing: s } = I(t, r), l = [];
-	for (let n of T) {
+function I(t, n) {
+	if (!C.some((n) => e(c(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — run `tracerkit init` first");
+	let r = _(t), { unchanged: a, modified: o, missing: s } = F(t, r), l = [];
+	for (let n of w) {
 		let r = c(t, ".claude", "skills", n);
 		e(r) && (i(r, {
 			recursive: !0,
@@ -173,7 +170,7 @@ function L(t, n) {
 		...u ? o : []
 	];
 	if (d.length > 0) {
-		P(t, r, d);
+		N(t, r, d);
 		for (let e of a) l.push(`✓ ${e}`);
 		for (let e of s) l.push(`✓ ${e} (added)`);
 		if (u) for (let e of o) l.push(`✓ ${e} (replaced)`);
@@ -186,14 +183,14 @@ function L(t, n) {
 }
 //#endregion
 //#region src/commands/init.ts
-function ee(t) {
-	if (w.some((n) => e(c(t, ".claude", "skills", n)))) return L(t, { force: !1 });
-	let { copied: n } = P(t, _(t));
+function te(t) {
+	if (C.some((n) => e(c(t, ".claude", "skills", n)))) return I(t, { force: !1 });
+	let { copied: n } = N(t, _(t));
 	return n.map((e) => `✓ ${e}`);
 }
 //#endregion
 //#region src/commands/migrate-storage.ts
-var te = {
+var L = {
 	created: "tk:created",
 	in_progress: "tk:in-progress",
 	done: "tk:done"
@@ -225,7 +222,7 @@ function B(e) {
 	return t.length === 0 ? "<!-- tk:metadata\n-->" : `<!-- tk:metadata\n${t.map(([e, t]) => `${e}: ${t}`).join("\n")}\n-->`;
 }
 function V(e) {
-	return te[e] ?? "tk:created";
+	return L[e] ?? "tk:created";
 }
 function H(e) {
 	let t = e.match(/<!--\s*tk:metadata\n([\s\S]*?)-->\n*([\s\S]*)$/);
@@ -288,7 +285,7 @@ function q(e) {
 	let t = e;
 	if (t.code === "ENOENT") return /* @__PURE__ */ Error("gh CLI not found — install it: https://cli.github.com");
 	let n = (t.stderr ?? t.message ?? "").toLowerCase();
-	return n.includes("not logged in") || n.includes("authentication") ? /* @__PURE__ */ Error("Not authenticated with GitHub. Run: gh auth login") : n.includes("rate limit") || n.includes("403") ? /* @__PURE__ */ Error("GitHub rate limit exceeded. Wait and retry.") : n.includes("not found") || n.includes("404") ? /* @__PURE__ */ Error("Repository not found. Check github.repo in .tracerkit/config.json") : e instanceof Error ? e : Error(String(e));
+	return n.includes("not logged in") || n.includes("authentication") ? /* @__PURE__ */ Error("Not authenticated with GitHub. Run: gh auth login") : n.includes("rate limit") || n.includes("403") ? /* @__PURE__ */ Error("GitHub rate limit exceeded. Wait and retry.") : n.includes("not found") || n.includes("404") ? /* @__PURE__ */ Error("Repository not found. Check your git remote configuration.") : e instanceof Error ? e : Error(String(e));
 }
 function J(e) {
 	try {
@@ -305,23 +302,11 @@ function J(e) {
 	}
 }
 function Y(e, t) {
-	return e.github.repo ? e.github.repo : t([
-		"repo",
-		"view",
-		"--json",
-		"nameWithOwner",
-		"-q",
-		".nameWithOwner"
-	]);
-}
-function X(e, t, n) {
-	let r = n([
+	let n = t([
 		"issue",
 		"list",
-		"--repo",
-		e,
 		"--label",
-		t,
+		e,
 		"--state",
 		"all",
 		"--json",
@@ -329,9 +314,9 @@ function X(e, t, n) {
 		"--limit",
 		"1000"
 	]);
-	return JSON.parse(r || "[]");
+	return JSON.parse(n || "[]");
 }
-function Z(e, t) {
+function X(e, t) {
 	return t.some((t) => {
 		if (t.body) {
 			let { metadata: n } = H(t.body);
@@ -340,48 +325,40 @@ function Z(e, t) {
 		return W(t.title) === e;
 	});
 }
-function ne(e, t, n) {
-	for (let r of t) n([
+function Z(e, t) {
+	for (let n of e) t([
 		"label",
 		"create",
-		r,
-		"--repo",
-		e,
+		n,
 		"--force"
 	]);
 }
-function re(e, t, n) {
-	let r = [
+function ne(e, t) {
+	let n = [
 		"issue",
 		"create",
-		"--repo",
-		e,
 		"--title",
-		t.title,
+		e.title,
 		"--body",
-		t.body
+		e.body
 	];
-	for (let e of t.labels) r.push("--label", e);
-	let i = n(r).match(/\/(\d+)\s*$/);
-	return i ? parseInt(i[1], 10) : 0;
+	for (let t of e.labels) n.push("--label", t);
+	let r = t(n).match(/\/(\d+)\s*$/);
+	return r ? parseInt(r[1], 10) : 0;
 }
-function ie(e, t, n) {
-	n([
+function re(e, t) {
+	t([
 		"issue",
 		"close",
-		String(t),
-		"--repo",
-		e
+		String(e)
 	]);
 }
-function ae(e, t, n) {
-	let r = n([
+function ie(e, t) {
+	let n = t([
 		"pr",
 		"list",
-		"--repo",
-		e,
 		"--search",
-		t,
+		e,
 		"--state",
 		"merged",
 		"--json",
@@ -389,20 +366,18 @@ function ae(e, t, n) {
 		"--limit",
 		"5"
 	]);
-	return JSON.parse(r || "[]");
+	return JSON.parse(n || "[]");
 }
-function oe(e, t, n, r) {
-	r([
+function ae(e, t, n) {
+	n([
 		"issue",
 		"comment",
-		String(t),
-		"--repo",
-		e,
+		String(e),
 		"--body",
-		n
+		t
 	]);
 }
-function se(e) {
+function oe(e) {
 	for (let t of e) {
 		let e = R[t];
 		if (e) return e;
@@ -412,52 +387,52 @@ function se(e) {
 function Q(e, n) {
 	t(s(e), { recursive: !0 }), a(e, n);
 }
-function ce(e, t) {
+function $(e, t) {
 	let n = t?.runGh ?? J, r = _(e);
-	return r.storage === "local" ? le(e, r, n) : ue(e, r, n);
-}
-function le(e, t, n) {
-	let r = [], i = Y(t, n), a = K(e, t);
-	if (a.length === 0) return x(e, { storage: p }), r.push("No artifacts found — nothing to migrate."), r.push(`✓ Storage switched to "${p}".`), r;
-	let o = t.github.labels?.prd ?? "tk:prd", s = t.github.labels?.plan ?? "tk:plan";
-	ne(i, [
+	return r.storage === "local" ? se(e, r, n) : le(e, r, n);
+}
+function se(e, t, n) {
+	let r = [], i = K(e, t);
+	if (i.length === 0) return b(e, { storage: p }), r.push("No artifacts found — nothing to migrate."), r.push(`✓ Storage switched to "${p}".`), r;
+	let a = t.github.labels?.prd ?? "tk:prd", o = t.github.labels?.plan ?? "tk:plan";
+	Z([
+		a,
 		o,
-		s,
-		...[...new Set(a.map((e) => V(e.metadata.status ?? "created")))]
+		...[...new Set(i.map((e) => V(e.metadata.status ?? "created")))]
 	], n);
-	let c = X(i, o, n), l = X(i, s, n);
-	for (let e of a) {
-		let t = e.type === "prd" ? o : s, a = e.type === "prd" ? c : l;
-		if (Z(e.slug, a)) {
+	let s = Y(a, n), c = Y(o, n);
+	for (let e of i) {
+		let t = e.type === "prd" ? a : o, i = e.type === "prd" ? s : c;
+		if (X(e.slug, i)) {
 			r.push(`⚠ skip ${e.type} "${e.slug}" — already exists on GitHub`);
 			continue;
 		}
-		let u = e.metadata.status ?? "created", d = V(u), f = `${B(e.metadata)}\n\n${e.body.replace(/^\n/, "")}`, p = re(i, {
+		let l = e.metadata.status ?? "created", u = V(l), d = `${B(e.metadata)}\n\n${e.body.replace(/^\n/, "")}`, f = ne({
 			title: `[${t}] ${e.slug}: ${e.title}`,
-			body: f,
-			labels: [t, d]
+			body: d,
+			labels: [t, u]
 		}, n);
-		u === "done" ? (ie(i, p, n), $(i, e.slug, p, n), r.push(`✓ ${e.type} "${e.slug}" → issue #${p} (closed)`)) : r.push(`✓ ${e.type} "${e.slug}" → issue #${p}`);
+		l === "done" ? (re(f, n), ce(e.slug, f, n), r.push(`✓ ${e.type} "${e.slug}" → issue #${f} (closed)`)) : r.push(`✓ ${e.type} "${e.slug}" → issue #${f}`);
 	}
-	return x(e, { storage: p }), r.push(`✓ Storage switched to "${p}".`), r;
+	return b(e, { storage: p }), r.push(`✓ Storage switched to "${p}".`), r;
 }
-function $(e, t, n, r) {
-	let i = ae(e, t, r);
-	i.length !== 0 && oe(e, n, `Linked PR: ${i.map((e) => `#${e.number}`).join(", ")}`, r);
+function ce(e, t, n) {
+	let r = ie(e, n);
+	r.length !== 0 && ae(t, `Linked PR: ${r.map((e) => `#${e.number}`).join(", ")}`, n);
 }
-function ue(t, n, r) {
-	let i = [], a = Y(n, r), o = n.github.labels?.prd ?? "tk:prd", s = n.github.labels?.plan ?? "tk:plan", l = X(a, o, r), u = X(a, s, r), d = [...l.map((e) => ({
+function le(t, n, r) {
+	let i = [], a = n.github.labels?.prd ?? "tk:prd", o = n.github.labels?.plan ?? "tk:plan", s = Y(a, r), l = Y(o, r), u = [...s.map((e) => ({
 		...e,
 		type: "prd"
-	})), ...u.map((e) => ({
+	})), ...l.map((e) => ({
 		...e,
 		type: "plan"
 	}))];
-	if (d.length === 0) return x(t, { storage: f }), i.push("No GitHub issues found — nothing to migrate."), i.push(`✓ Storage switched to "${f}".`), i;
-	for (let r of d) {
+	if (u.length === 0) return b(t, { storage: f }), i.push("No GitHub issues found — nothing to migrate."), i.push(`✓ Storage switched to "${f}".`), i;
+	for (let r of u) {
 		let { metadata: a, body: o } = H(r.body ?? ""), s = a.slug ?? W(r.title);
 		if (!s) continue;
-		let l = r.labels.map((e) => e.name), u = a.status ?? se(l), d = c(t, r.type === "prd" ? n.paths.prds : n.paths.plans, `${s}.md`);
+		let l = r.labels.map((e) => e.name), u = a.status ?? oe(l), d = c(t, r.type === "prd" ? n.paths.prds : n.paths.plans, `${s}.md`);
 		if (e(d)) {
 			i.push(`⚠ skip ${r.type} "${s}" — local file already exists`);
 			continue;
@@ -472,14 +447,14 @@ function ue(t, n, r) {
 		}
 		i.push(`✓ ${r.type} "${s}" → ${d}`);
 	}
-	return x(t, { storage: f }), i.push(`✓ Storage switched to "${f}".`), i;
+	return b(t, { storage: f }), i.push(`✓ Storage switched to "${f}".`), i;
 }
 //#endregion
 //#region src/commands/uninstall.ts
-function de(t) {
-	if (!w.some((n) => e(c(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — nothing to uninstall");
+function ue(t) {
+	if (!C.some((n) => e(c(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — nothing to uninstall");
 	let n = [];
-	for (let r of w) {
+	for (let r of C) {
 		let a = c(t, ".claude", "skills", r);
 		e(a) && (i(a, {
 			recursive: !0,
@@ -489,4 +464,4 @@ function de(t) {
 	return n;
 }
 //#endregion
-export { P as a, T as c, f as d, _ as f, L as i, E as l, ce as n, O as o, x as p, ee as r, D as s, de as t, w as u };
+export { N as a, w as c, f as d, _ as f, I as i, T as l, $ as n, D as o, b as p, te as r, E as s, ue as t, C as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracerkit",
-  "version": "1.17.0",
+  "version": "1.17.2",
   "description": "Spec-driven workflow for AI coding agents — PRD → plan → verify. Pure Markdown skills, zero runtime deps.",
   "license": "MIT",
   "author": {

package/skills/brief/SKILL.md

@@ -2,7 +2,7 @@
 description: Session briefing — shows active features, progress, and suggested focus. Use at the start of a session to orient.
 ---
 
-**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks. GitHub: use `github.repo` from config or git remote.
+**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks.
 
 # Session Briefing
 

package/skills/check/SKILL.md

@@ -3,13 +3,13 @@ description: Verify implementation against plan. Shows progress, finds blockers,
 argument-hint: '[slug]'
 ---
 
-**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks. GitHub: use `github.repo` from config or git remote.
+**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks.
 
 # Check Implementation
 
 Check implementation against a plan. Update checks, stamp findings, transition status, and mark complete when done.
 
-**Interactive prompts**: use `AskUserQuestion` for all user-facing questions — selections and confirmations.
+**Interactive prompts**: use `AskUserQuestion` when available for selections and confirmations; otherwise present options as a numbered list.
 
 ## Pre-loaded context
 
@@ -52,7 +52,7 @@ For each `.md` file in `.tracerkit/prds/`:
 6. If plan issue exists, count progress from checkboxes in its body (see Progress Algorithm below). Show `—` if no plan.
 <!-- end:github -->
 
-Use `AskUserQuestion` with each feature as an option to let the user pick which to verify.
+Present each feature as an option and let the user pick which to verify. Use `AskUserQuestion` when available; otherwise present as a numbered list.
 
 ## Progress Algorithm
 
@@ -64,12 +64,12 @@ Count `- [x]` and `- [ ]` lines under each `## Phase N` heading. Per-phase: `Pha
 
 <!-- if:local -->
 
-Read `.tracerkit/plans/<slug>.md`. If missing, list plans and use `AskUserQuestion` to select one.
+Read `.tracerkit/plans/<slug>.md`. If missing, list plans and ask the user to select one (use `AskUserQuestion` when available).
 
 <!-- end:local -->
 <!-- if:github -->
 
-Find plan issue: open issue with label `{{github.labels.plan}}`, title matching `[{{github.labels.plan}}] <slug>:`. If missing, list plans and use `AskUserQuestion` to select one.
+Find plan issue: open issue with label `{{github.labels.plan}}`, title matching `[{{github.labels.plan}}] <slug>:`. If missing, list plans and ask the user to select one (use `AskUserQuestion` when available).
 
 <!-- end:github -->
 

package/skills/plan/SKILL.md

@@ -3,13 +3,13 @@ description: Turn a PRD into a multi-phase implementation plan using tracer-bull
 argument-hint: '[slug]'
 ---
 
-**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks. GitHub: use `github.repo` from config or git remote.
+**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks.
 
 # PRD to Plan
 
 Break a PRD into phased vertical slices (tracer bullets).
 
-**Interactive prompts**: use `AskUserQuestion` for all user-facing questions — selections, confirmations, and approval steps.
+**Interactive prompts**: use `AskUserQuestion` when available for selections, confirmations, and approval steps; otherwise present options as a numbered list.
 
 <!-- if:local -->
 
@@ -36,7 +36,7 @@ Output: a GitHub Issue with label `{{github.labels.plan}}`.
 
 The argument (if provided) is: $ARGUMENTS
 
-Use argument as `<slug>`. If empty, list available PRDs and use `AskUserQuestion` with each PRD as an option.
+Use argument as `<slug>`. If empty, list available PRDs and ask the user to select one (use `AskUserQuestion` when available; otherwise present as a numbered list).
 
 ## Workflow
 
@@ -44,12 +44,12 @@ Use argument as `<slug>`. If empty, list available PRDs and use `AskUserQuestion
 
 <!-- if:local -->
 
-Read `.tracerkit/prds/<slug>.md`. If missing, list PRDs and use `AskUserQuestion` to select one. If `.tracerkit/plans/<slug>.md` exists, use `AskUserQuestion` with options: "Overwrite existing" / "Pick a new name".
+Read `.tracerkit/prds/<slug>.md`. If missing, list PRDs and ask the user to select one. If `.tracerkit/plans/<slug>.md` exists, ask: "Overwrite existing" / "Pick a new name". Use `AskUserQuestion` when available; otherwise present as a numbered list.
 
 <!-- end:local -->
 <!-- if:github -->
 
-Find PRD issue: open issue with label `{{github.labels.prd}}`, title matching `[{{github.labels.prd}}] <slug>:`. If missing, list PRDs and use `AskUserQuestion` to select one. If plan issue with label `{{github.labels.plan}}` and matching title exists, use `AskUserQuestion` with options: "Update existing plan" / "Use a new name".
+Find PRD issue: open issue with label `{{github.labels.prd}}`, title matching `[{{github.labels.prd}}] <slug>:`. If missing, list PRDs and ask the user to select one. If plan issue with label `{{github.labels.plan}}` and matching title exists, ask: "Update existing plan" / "Use a new name". Use `AskUserQuestion` when available; otherwise present as a numbered list.
 
 <!-- end:github -->
 
@@ -112,7 +112,7 @@ Each phase: thin vertical slice through all layers (schema → service → API
 
 - 1 module touched → 2–3 phases max
 - 2–3 modules touched → 3–5 phases max
-- 4+ modules or 6+ phases → stop and use `AskUserQuestion`: "PRD touches 4+ modules. Split before planning?" with options: "Split the PRD" (Recommended) / "Continue anyway"
+- 4+ modules or 6+ phases → stop and ask: "PRD touches 4+ modules. Split before planning?" with options: "Split the PRD" (Recommended) / "Continue anyway". Use `AskUserQuestion` when available.
 
 Count "modules touched" by scanning the PRD's New Modules and Schema Changes sections.
 
@@ -124,7 +124,7 @@ Assign an agent tag to tasks where appropriate:
 
 ### 5. Quiz the user
 
-Present breakdown (title, user stories covered, done-when per phase). Use `AskUserQuestion`: "How's the granularity?" with options: "Looks good, proceed" (Recommended) / "Merge some phases" / "Split a phase". Iterate until approved.
+Present breakdown (title, user stories covered, done-when per phase). Ask: "How's the granularity?" with options: "Looks good, proceed" (Recommended) / "Merge some phases" / "Split a phase". Use `AskUserQuestion` when available; otherwise present as a numbered list. Iterate until approved.
 
 ### 6. Save plan
 
@@ -149,7 +149,7 @@ Then update PRD frontmatter: add `plan: .tracerkit/plans/<slug>.md` field.
 <!-- end:local -->
 <!-- if:github -->
 
-Ensure labels exist: `gh label create {{github.labels.plan}} --repo {{github.repo}} --force`, `gh label create tk:in-progress --repo {{github.repo}} --force`.
+Ensure labels exist: `gh label create {{github.labels.plan}} --force`, `gh label create tk:in-progress --force`.
 
 Create GitHub Issue — title: `[{{github.labels.plan}}] <slug>: Plan: <Feature Title>`, labels: `{{github.labels.plan}}`, `tk:in-progress`.
 
@@ -217,11 +217,11 @@ Carried forward from PRD verbatim.
 Gaps found in the PRD needing resolution. Blank if none.
 ```
 
-Print one line per phase: `Phase N — <title> (<condition summary>)`. Then use `AskUserQuestion`: "What's next?" with options: "Start implementing" (Recommended) / "Run `/tk:check <slug>`" / "Done for now".
+Print one line per phase: `Phase N — <title> (<condition summary>)`. Then ask: "What's next?" with options: "Start implementing" (Recommended) / "Run `/tk:check <slug>`" / "Done for now". Use `AskUserQuestion` when available; otherwise present as a numbered list.
 
 ## Execution guidance
 
-When implementing this plan, **always offer to create a feature branch** before writing any code. Use `AskUserQuestion`: "Create branch `feat/<slug>`?" with options: "Yes, create branch" (Recommended) / "No, stay on current branch". If accepted, create the branch from the default branch.
+When implementing this plan, **always offer to create a feature branch** before writing any code. Ask: "Create branch `feat/<slug>`?" with options: "Yes, create branch" (Recommended) / "No, stay on current branch". Use `AskUserQuestion` when available. If accepted, create the branch from the default branch.
 
 ### During implementation
 

package/skills/prd/SKILL.md

@@ -3,13 +3,13 @@ description: Create a PRD through user interview, codebase exploration, and modu
 argument-hint: <idea>
 ---
 
-**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks. GitHub: use `github.repo` from config or git remote.
+**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks.
 
 # PRD Writing
 
 Skip satisfied steps. If argument provided, skip to Step 2.
 
-**Interactive prompts**: use `AskUserQuestion` for all user-facing questions — choices, confirmations, and interview questions. This provides structured selection UI instead of plain text prompts.
+**Interactive prompts**: use `AskUserQuestion` when available for choices, confirmations, and interview questions (structured selection UI); otherwise present options as a numbered list.
 
 ## Pre-loaded context
 
@@ -36,12 +36,12 @@ If empty, go to Step 1; derive slug after gathering the idea. If provided, deriv
 
 <!-- if:local -->
 
-Output: `.tracerkit/prds/<slug>.md`. If exists, use `AskUserQuestion` with options: "Overwrite existing" / "Pick a new name".
+Output: `.tracerkit/prds/<slug>.md`. If exists, ask: "Overwrite existing" / "Pick a new name" (use `AskUserQuestion` when available).
 
 <!-- end:local -->
 <!-- if:github -->
 
-Output: GitHub Issue with label `{{github.labels.prd}}`, title `[{{github.labels.prd}}] <slug>: <Feature Title>`. If matching issue exists, use `AskUserQuestion` with options: "Update existing issue" / "Use a new slug".
+Output: GitHub Issue with label `{{github.labels.prd}}`, title `[{{github.labels.prd}}] <slug>: <Feature Title>`. If matching issue exists, ask: "Update existing issue" / "Use a new slug" (use `AskUserQuestion` when available).
 
 <!-- end:github -->
 
@@ -59,7 +59,7 @@ Map current state: data models, services, API routes, frontend, tests. Note exis
 
 ### 3. Interview
 
-One question at a time. Lead with your recommended answer (mark it `(Recommended)` and list first). Explore code instead of asking when possible. Use `AskUserQuestion` with 2–4 options for each interview question — structured choices are faster than free-text.
+One question at a time. Lead with your recommended answer (mark it `(Recommended)` and list first). Explore code instead of asking when possible. Present 2–4 options for each question — structured choices are faster than free-text. Use `AskUserQuestion` when available; otherwise present as a numbered list.
 
 | Branch           | Key questions                           | Skip when                        |
 | ---------------- | --------------------------------------- | -------------------------------- |
@@ -73,7 +73,7 @@ One question at a time. Lead with your recommended answer (mark it `(Recommended
 
 ### 3b. Gray areas
 
-Surface ambiguities, contradictions, unstated assumptions. For each gray area, use `AskUserQuestion` with proposed resolution options. Resolve all before continuing.
+Surface ambiguities, contradictions, unstated assumptions. For each gray area, present proposed resolution options (use `AskUserQuestion` when available). Resolve all before continuing.
 
 ### 4. Design modules
 
@@ -81,7 +81,7 @@ Sketch modules. Favor **deep modules** — simple interface (1-3 entry points) h
 
 Shallow signals: many small 1:1 functions, callers compose multiple calls, feature changes require interface changes.
 
-Present modules. Use `AskUserQuestion` (multiSelect) to confirm which modules need tests.
+Present modules. Confirm which need tests (multiSelect). Use `AskUserQuestion` when available; otherwise present as a checklist for the user to confirm.
 
 ### 5. Write PRD
 
@@ -101,7 +101,7 @@ status: created
 <!-- end:local -->
 <!-- if:github -->
 
-Ensure labels exist: `gh label create {{github.labels.prd}} --repo {{github.repo}} --force`, `gh label create tk:created --repo {{github.repo}} --force`.
+Ensure labels exist: `gh label create {{github.labels.prd}} --force`, `gh label create tk:created --force`.
 
 Create GitHub Issue — title: `[{{github.labels.prd}}] <slug>: <Feature Title>`, labels: `{{github.labels.prd}}`, `tk:created`.
 
@@ -136,4 +136,4 @@ PRD body structure (same for local file and issue body). Omit empty sections. No
 
 ---
 
-Then use `AskUserQuestion`: "What's next?" with options: "Run `/tk:plan <slug>`" (Recommended) / "Done for now".
+Then ask: "What's next?" with options: "Run `/tk:plan <slug>`" (Recommended) / "Done for now". Use `AskUserQuestion` when available; otherwise present as a numbered list.