tracerkit 1.3.14 → 1.4.1

package/README.md

@@ -63,19 +63,19 @@ The three-step workflow that takes a feature from idea to verified archive.
 
 Interactive interview to define a feature. Explores the codebase, asks scoping questions one at a time, designs deep modules, and writes a structured PRD.
 
-**Output:** `prds/<slug>.md`
+**Output:** `.tracerkit/prds/<slug>.md`
 
 #### `/tk:plan <slug>` — Create an implementation plan
 
 Reads a PRD and breaks it into phased **tracer-bullet vertical slices** — each phase is a thin but complete path through every layer (schema, service, API, UI, tests), demoable on its own.
 
-**Output:** `plans/<slug>.md`
+**Output:** `.tracerkit/plans/<slug>.md`
 
 #### `/tk:verify <slug>` — Verify and archive
 
-Read-only review that compares the codebase against the plan's done-when conditions. Runs tests, checks user stories, and stamps a **PASS** or **NEEDS_WORK** verdict. On PASS, automatically archives the PRD and plan to `archive/<slug>/`.
+Read-only review that compares the codebase against the plan's done-when conditions. Runs tests, checks user stories, and stamps a **PASS** or **NEEDS_WORK** verdict. On PASS, automatically archives the PRD and plan to `.tracerkit/archives/<slug>/`.
 
-**Output:** Verdict block in `plans/<slug>.md` — on PASS: `archive/<slug>/prd.md` + `archive/<slug>/plan.md`
+**Output:** Verdict block in `.tracerkit/plans/<slug>.md` — on PASS: `.tracerkit/archives/<slug>/prd.md` + `.tracerkit/archives/<slug>/plan.md`
 
 ### Helper skills
 
@@ -83,7 +83,7 @@ Useful but optional — this category will grow over time.
 
 #### `/tk:status` — Workflow dashboard
 
-Scans `prds/` and prints a table of all features grouped by status (`in_progress`, `created`, `done`), with age, latest verdict, and blocker/suggestion counts. Read-only — no files are modified.
+Scans `.tracerkit/prds/` and prints a table of all features grouped by status (`in_progress`, `created`, `done`), with age, latest verdict, and blocker/suggestion counts. Read-only — no files are modified.
 
 ## Examples
 
@@ -97,14 +97,14 @@ AI:  Starting PRD interview...
      ? Should it detect system preference or manual toggle only?
      ? Which components need theming?
      ...
-     ✓ Written prds/dark-mode-support.md
+     ✓ Written .tracerkit/prds/dark-mode-support.md
 
 You: /tk:plan dark-mode-support
 AI:  Reading PRD...
      ✓ Phase 1 — CSS variables + ThemeProvider (schema → context → tests)
      ✓ Phase 2 — Toggle component + localStorage (UI → persistence → tests)
      ✓ Phase 3 — System preference detection (media query → sync → tests)
-     Written plans/dark-mode-support.md
+     Written .tracerkit/plans/dark-mode-support.md
 
 You: # implement each phase with Claude...
 
@@ -112,7 +112,7 @@ You: /tk:verify dark-mode-support
 AI:  Verifying against plan...
      ✓ All done-when conditions met
      ✓ Tests passing
-     PASS — archived to archive/dark-mode-support/
+     PASS — archived to .tracerkit/archives/dark-mode-support/
 ```
 
 </details>
@@ -122,14 +122,14 @@ AI:  Verifying against plan...
 
 ```
 You: /tk:prd update dark mode to detect system preference
-AI:  Found existing prds/dark-mode-support.md
+AI:  Found existing .tracerkit/prds/dark-mode-support.md
      ? Start fresh or revise the existing PRD?
      ...
-     ✓ Updated prds/dark-mode-support.md
+     ✓ Updated .tracerkit/prds/dark-mode-support.md
 
 You: /tk:plan dark-mode-support
 AI:  Reading updated PRD...
-     ✓ Regenerated plans/dark-mode-support.md with new scope
+     ✓ Regenerated .tracerkit/plans/dark-mode-support.md with new scope
 ```
 
 </details>
@@ -150,7 +150,7 @@ You: /tk:verify dark-mode-support
 AI:  Verifying against plan...
      ✓ All done-when conditions met
      ✓ Tests passing
-     PASS — archived to archive/dark-mode-support/
+     PASS — archived to .tracerkit/archives/dark-mode-support/
 ```
 
 </details>
@@ -186,8 +186,23 @@ AI:  Feature Status Dashboard
 
 All commands default to the home directory. Pass a path to target a specific project.
 
-<details>
-<summary>Metadata Lifecycle</summary>
+## Configuration
+
+Artifacts are stored under `.tracerkit/` by default. To customize paths, create `.tracerkit/config.json`:
+
+```json
+{
+  "paths": {
+    "prds": ".tracerkit/prds",
+    "plans": ".tracerkit/plans",
+    "archives": ".tracerkit/archives"
+  }
+}
+```
+
+Any missing key falls back to its default. The file is optional — without it, all defaults apply. After changing config, run `tracerkit update` to regenerate skills with the new paths.
+
+## Metadata Lifecycle
 
 Each PRD carries YAML frontmatter that tracks its position in the workflow. The skills update it automatically — you never need to edit it by hand.
 
@@ -238,10 +253,7 @@ completed: 2025-06-20T09:00:00Z
 
 </details>
 
-</details>
-
-<details>
-<summary>Compared to</summary>
+## Compared to
 
 **vs. [Spec Kit](https://github.com/github/spec-kit)** (GitHub) — Thorough but heavyweight. 5 phases, Python setup, rigid phase gates. TracerKit is 3 phases, zero deps, automated verification.
 
@@ -266,8 +278,6 @@ completed: 2025-06-20T09:00:00Z
 
 </details>
 
-</details>
-
 ## Contributing
 
 1. Fork the repo and create a feature branch

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as e, r as t, t as n } from "./uninstall-vX1WH11F.js";
+import { n as e, r as t, t as n } from "./uninstall-C6vhDv_T.js";
 import { resolve as r } from "node:path";
 import { homedir as i } from "node:os";
 //#region src/cli.ts
@@ -9,7 +9,7 @@ var a = [
 	"Commands:",
 	"  init [path]       Install skills to ~/.claude/skills/ (or [path] if given)",
 	"  update [path]     Refresh unchanged files from latest version, skip modified",
-	"  uninstall [path]  Remove TracerKit skill directories, keep prds/ and plans/",
+	"  uninstall [path]  Remove TracerKit skill directories, keep .tracerkit/ artifacts",
 	"",
 	"Options:",
 	"  --force           Overwrite modified files during update",
@@ -24,7 +24,7 @@ function o(e) {
 }
 function s(r) {
 	if (r.includes("--help") || r.includes("-h")) return a;
-	if (r.includes("--version") || r.includes("-v")) return ["tracerkit/1.3.14"];
+	if (r.includes("--version") || r.includes("-v")) return ["tracerkit/1.4.1"];
 	let i = r[0], s = r.slice(1);
 	switch (i) {
 		case "init": return t(o(s));

package/dist/index.js

@@ -1,2 +1,2 @@
-import { i as e, n as t, r as n, t as r } from "./uninstall-vX1WH11F.js";
+import { i as e, n as t, r as n, t as r } from "./uninstall-C6vhDv_T.js";
 export { e as SKILL_NAMES, n as init, r as uninstall, t as update };

package/dist/uninstall-C6vhDv_T.js

@@ -0,0 +1,116 @@
+import { existsSync as e, mkdirSync as t, readFileSync as n, readdirSync as r, rmSync as i, writeFileSync as a } from "node:fs";
+import { dirname as o, join as s } from "node:path";
+import { createHash as c } from "node:crypto";
+import { fileURLToPath as l } from "node:url";
+//#region src/config.ts
+var u = {
+	prds: ".tracerkit/prds",
+	plans: ".tracerkit/plans",
+	archives: ".tracerkit/archives"
+};
+function d(t) {
+	let r = s(t, ".tracerkit", "config.json");
+	if (!e(r)) return { paths: { ...u } };
+	let i, a;
+	try {
+		i = n(r, "utf8"), a = JSON.parse(i);
+	} catch {
+		throw Error("Invalid .tracerkit/config.json — expected valid JSON");
+	}
+	let o = typeof a.paths == "object" && a.paths !== null ? a.paths : {};
+	return { paths: {
+		prds: typeof o.prds == "string" ? o.prds : u.prds,
+		plans: typeof o.plans == "string" ? o.plans : u.plans,
+		archives: typeof o.archives == "string" ? o.archives : u.archives
+	} };
+}
+//#endregion
+//#region src/templates.ts
+var f = [
+	"tk:prd",
+	"tk:plan",
+	"tk:verify",
+	"tk:status"
+], p = s(o(l(import.meta.url)), "..", "templates");
+function m(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(...m(s(e, r.name), n)) : i.push(n);
+	}
+	return i.sort();
+}
+function h(e, t) {
+	return e.replaceAll("{{paths.prds}}", t.paths.prds).replaceAll("{{paths.plans}}", t.paths.plans).replaceAll("{{paths.archives}}", t.paths.archives);
+}
+function g(e, r, i) {
+	let c = i ?? m(p);
+	for (let i of c) {
+		let c = s(p, i), l = s(e, i);
+		t(o(l), { recursive: !0 }), a(l, h(n(c, "utf8"), r));
+	}
+	return { copied: c };
+}
+function _(e) {
+	return c("sha256").update(e).digest("hex");
+}
+function v(t, r) {
+	let i = m(p), a = [], o = [], c = [];
+	for (let l of i) {
+		let i = s(t, l);
+		if (!e(i)) c.push(l);
+		else {
+			let e = h(n(s(p, l), "utf8"), r);
+			_(Buffer.from(e)) === _(n(i)) ? a.push(l) : o.push(l);
+		}
+	}
+	return {
+		unchanged: a,
+		modified: o,
+		missing: c
+	};
+}
+//#endregion
+//#region src/commands/init.ts
+function y(t) {
+	for (let n of f) if (e(s(t, ".claude", "skills", n))) throw Error(`.claude/skills/${n}/ already exists — aborting`);
+	let { copied: n } = g(t, d(t));
+	return n.map((e) => `✓ ${e}`);
+}
+//#endregion
+//#region src/commands/update.ts
+function b(t, n) {
+	if (!f.some((n) => e(s(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — run `tracerkit init` first");
+	let r = d(t), { unchanged: i, modified: a, missing: o } = v(t, r), c = [], l = n?.force ?? !1, u = [
+		...i,
+		...o,
+		...l ? a : []
+	];
+	if (u.length > 0) {
+		g(t, r, u);
+		for (let e of i) c.push(`✓ ${e}`);
+		for (let e of o) c.push(`✓ ${e} (added)`);
+		if (l) for (let e of a) c.push(`✓ ${e} (replaced)`);
+	}
+	if (!l && a.length > 0) {
+		for (let e of a) c.push(`⚠ ${e} (skipped — modified)`);
+		c.push("", "Run `tracerkit update --force` to replace modified files with latest versions.");
+	}
+	return c;
+}
+//#endregion
+//#region src/commands/uninstall.ts
+function x(t) {
+	if (!f.some((n) => e(s(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — nothing to uninstall");
+	let n = [];
+	for (let r of f) {
+		let a = s(t, ".claude", "skills", r);
+		e(a) && (i(a, {
+			recursive: !0,
+			force: !0
+		}), n.push(`✗ .claude/skills/${r}/ removed`));
+	}
+	return n;
+}
+//#endregion
+export { f as i, b as n, y as r, x as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracerkit",
-  "version": "1.3.14",
+  "version": "1.4.1",
   "description": "Spec-driven workflow for Claude Code: replace ad-hoc prompts with PRD → plan → verify.",
   "license": "MIT",
   "author": {

package/templates/.claude/skills/tk:plan/SKILL.md

@@ -1,15 +1,15 @@
 ---
-description: Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved to plans/. Use after /tk:prd.
+description: Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved to {{paths.plans}}/. Use after /tk:prd.
 argument-hint: '[slug]'
 ---
 
 # PRD to Plan
 
-Break a PRD into phased vertical slices (tracer bullets). Output: `plans/<slug>.md`.
+Break a PRD into phased vertical slices (tracer bullets). Output: `{{paths.plans}}/<slug>.md`.
 
 ## Pre-loaded context
 
-- Available PRDs: !`ls prds/ 2>/dev/null || echo "no prds/ directory found"`
+- Available PRDs: !`ls {{paths.prds}}/ 2>/dev/null || echo "no {{paths.prds}}/ directory found"`
 
 ## Input
 
@@ -21,13 +21,13 @@ Use the argument as `<slug>` if given. If no argument is provided, list availabl
 
 ### 1. Read the PRD
 
-Read `prds/<slug>.md`. If it does not exist, list available PRDs and ask.
+Read `{{paths.prds}}/<slug>.md`. If it does not exist, list available PRDs and ask.
 
-If `plans/<slug>.md` already exists, tell the user and ask whether to overwrite or pick a new name.
+If `{{paths.plans}}/<slug>.md` already exists, tell the user and ask whether to overwrite or pick a new name.
 
 ### 1b. Update PRD status
 
-Update the YAML frontmatter in `prds/<slug>.md` to `status: in_progress`. Change only the `status` field — do not touch any other frontmatter fields or the markdown content below the closing `---`.
+Update the YAML frontmatter in `{{paths.prds}}/<slug>.md` to `status: in_progress`. Change only the `status` field — do not touch any other frontmatter fields or the markdown content below the closing `---`.
 
 If the PRD has no frontmatter, skip this step silently.
 
@@ -87,12 +87,12 @@ Ask: Does the granularity feel right? Should any phases merge or split? Iterate
 
 ### 6. Save plan
 
-Save to `plans/<slug>.md` (create `plans/` if missing).
+Save to `{{paths.plans}}/<slug>.md` (create `{{paths.plans}}/` if missing).
 
 ```markdown
 # Plan: <Feature Name>
 
-> Source PRD: `prds/<slug>.md`
+> Source PRD: `{{paths.prds}}/<slug>.md`
 
 ## Architectural Decisions
 
@@ -141,4 +141,4 @@ Print saved path and one line per phase: `Phase N — <title> (<condition summar
 
 - PRD not found — list available PRDs and ask
 - PRD missing sections — note gaps inline and continue
-- `plans/` missing — create it
+- `{{paths.plans}}/` missing — create it

package/templates/.claude/skills/tk:prd/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: Create a PRD through user interview, codebase exploration, and module design, saved to prds/. Use when starting a new feature or change.
+description: Create a PRD through user interview, codebase exploration, and module design, saved to {{paths.prds}}/. Use when starting a new feature or change.
 argument-hint: <idea>
 ---
 
@@ -13,9 +13,9 @@ The argument is: $ARGUMENTS
 
 If the argument is empty, go straight to Step 1 (gather problem description). After gathering the idea, derive the slug from the idea.
 
-If the argument is provided, convert it to a kebab-case slug (lowercase, spaces and underscores replaced with hyphens). This is `<slug>`. The output file is `prds/<slug>.md`.
+If the argument is provided, convert it to a kebab-case slug (lowercase, spaces and underscores replaced with hyphens). This is `<slug>`. The output file is `{{paths.prds}}/<slug>.md`.
 
-If `prds/<slug>.md` already exists, tell the user and ask whether to overwrite or pick a new name.
+If `{{paths.prds}}/<slug>.md` already exists, tell the user and ask whether to overwrite or pick a new name.
 
 ## Workflow
 
@@ -51,7 +51,7 @@ Present modules to user. Confirm which need tests.
 
 ### 5. Write PRD
 
-Save to `prds/<slug>.md` (create `prds/` if missing).
+Save to `{{paths.prds}}/<slug>.md` (create `{{paths.prds}}/` if missing).
 
 ```markdown
 ---
@@ -118,5 +118,5 @@ Tell the user: file created, one-line summary, next step is `/tk:plan <slug>`.
 
 ## Error Handling
 
-- `prds/` missing — create it
+- `{{paths.prds}}/` missing — create it
 - Scope larger than expected — surface and re-scope with user before continuing

package/templates/.claude/skills/tk:status/SKILL.md

@@ -10,11 +10,11 @@ Scan all PRDs and display a status overview of every feature in the workflow.
 
 ### 1. Scan PRDs
 
-List all `.md` files in `prds/`. If the directory is missing or empty, print "No features found — run `/tk:prd` to start one." and stop.
+List all `.md` files in `{{paths.prds}}/`. If the directory is missing or empty, print "No features found — run `/tk:prd` to start one." and stop.
 
 ### 2. Parse each PRD
 
-For each file `prds/<slug>.md`:
+For each file `{{paths.prds}}/<slug>.md`:
 
 1. Read YAML frontmatter (between opening and closing `---` delimiters)
 2. Extract fields: `created`, `status`, `completed`
@@ -22,7 +22,7 @@ For each file `prds/<slug>.md`:
 
 ### 3. Read verdict data
 
-For each slug, check if `plans/<slug>.md` exists. If it does, find the last `## Verdict` block and extract:
+For each slug, check if `{{paths.plans}}/<slug>.md` exists. If it does, find the last `## Verdict` block and extract:
 
 - **Result**: PASS or NEEDS_WORK
 - **BLOCKERS**: count

package/templates/.claude/skills/tk:verify/SKILL.md

@@ -9,7 +9,7 @@ Compare current implementation against a plan, stamp a verdict, and archive on P
 
 ## Pre-loaded context
 
-- Available plans: !`ls plans/ 2>/dev/null || echo "no plans/ directory found"`
+- Available plans: !`ls {{paths.plans}}/ 2>/dev/null || echo "no {{paths.plans}}/ directory found"`
 
 ## Input
 
@@ -21,7 +21,7 @@ Use the argument as `<slug>` if given. If no argument is provided, list availabl
 
 ### 1. Load the plan
 
-Read `plans/<slug>.md`. If it does not exist, list available plans and ask.
+Read `{{paths.plans}}/<slug>.md`. If it does not exist, list available plans and ask.
 
 ### 2. Load the PRD
 
@@ -64,7 +64,7 @@ Print the verdict report:
 
 ### 6. Stamp the plan
 
-Append a verdict block at the bottom of `plans/<slug>.md`:
+Append a verdict block at the bottom of `{{paths.plans}}/<slug>.md`:
 
 ```markdown
 ---
@@ -83,7 +83,7 @@ If a previous verdict block exists, replace it with the new one.
 
 If the verdict is **PASS**:
 
-**First**, update the YAML frontmatter in `prds/<slug>.md`:
+**First**, update the YAML frontmatter in `{{paths.prds}}/<slug>.md`:
 
 - Set `status: done`
 - Add `completed: <current UTC timestamp, ISO 8601, e.g. 2025-06-15T14:30:00Z>`
@@ -92,10 +92,10 @@ If the verdict is **PASS**:
 
 **Then**, automatically archive:
 
-1. Create `archive/<slug>/` directory (and `archive/` if missing)
-2. Move `prds/<slug>.md` → `archive/<slug>/prd.md`
-3. Move `plans/<slug>.md` → `archive/<slug>/plan.md`
-4. Append closing timestamp to `archive/<slug>/plan.md`:
+1. Create `{{paths.archives}}/<slug>/` directory (and `{{paths.archives}}/` if missing)
+2. Move `{{paths.prds}}/<slug>.md` → `{{paths.archives}}/<slug>/prd.md`
+3. Move `{{paths.plans}}/<slug>.md` → `{{paths.archives}}/<slug>/plan.md`
+4. Append closing timestamp to `{{paths.archives}}/<slug>/plan.md`:
 
 ```markdown
 ---
@@ -106,9 +106,9 @@ If the verdict is **PASS**:
 - **Closed**: YYYY-MM-DD HH:MM (UTC)
 ```
 
-5. Tell the user: archived to `archive/<slug>/`, one-line summary of the feature.
+5. Tell the user: archived to `{{paths.archives}}/<slug>/`, one-line summary of the feature.
 
-If `archive/<slug>/` already exists, warn and ask whether to overwrite.
+If `{{paths.archives}}/<slug>/` already exists, warn and ask whether to overwrite.
 
 ### 8. On NEEDS_WORK
 
@@ -126,5 +126,5 @@ Tell the user: fix the listed blockers, then re-run `/tk:verify <slug>`.
 
 - Plan not found — list available plans and ask
 - PRD referenced in plan not found — warn and continue with plan only
-- `plans/` missing — tell user to run `/tk:plan` first
-- `archive/<slug>/` already exists — warn and ask whether to overwrite
+- `{{paths.plans}}/` missing — tell user to run `/tk:plan` first
+- `{{paths.archives}}/<slug>/` already exists — warn and ask whether to overwrite

package/dist/uninstall-vX1WH11F.js

@@ -1,86 +0,0 @@
-import { existsSync as e, mkdirSync as t, readFileSync as n, readdirSync as r, rmSync as i, writeFileSync as a } from "node:fs";
-import { dirname as o, join as s } from "node:path";
-import { createHash as c } from "node:crypto";
-import { fileURLToPath as l } from "node:url";
-//#region src/templates.ts
-var u = [
-	"tk:prd",
-	"tk:plan",
-	"tk:verify",
-	"tk:status"
-], d = s(o(l(import.meta.url)), "..", "templates");
-function f(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(...f(s(e, r.name), n)) : i.push(n);
-	}
-	return i.sort();
-}
-function p(e, r) {
-	let i = r ?? f(d);
-	for (let r of i) {
-		let i = s(d, r), c = s(e, r);
-		t(o(c), { recursive: !0 }), a(c, n(i));
-	}
-	return { copied: i };
-}
-function m(e) {
-	return c("sha256").update(e).digest("hex");
-}
-function h(t) {
-	let r = f(d), i = [], a = [], o = [];
-	for (let c of r) {
-		let r = s(t, c);
-		e(r) ? m(n(s(d, c))) === m(n(r)) ? i.push(c) : a.push(c) : o.push(c);
-	}
-	return {
-		unchanged: i,
-		modified: a,
-		missing: o
-	};
-}
-//#endregion
-//#region src/commands/init.ts
-function g(t) {
-	for (let n of u) if (e(s(t, ".claude", "skills", n))) throw Error(`.claude/skills/${n}/ already exists — aborting`);
-	let { copied: n } = p(t);
-	return n.map((e) => `✓ ${e}`);
-}
-//#endregion
-//#region src/commands/update.ts
-function _(t, n) {
-	if (!u.some((n) => e(s(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — run `tracerkit init` first");
-	let { unchanged: r, modified: i, missing: a } = h(t), o = [], c = n?.force ?? !1, l = [
-		...r,
-		...a,
-		...c ? i : []
-	];
-	if (l.length > 0) {
-		p(t, l);
-		for (let e of r) o.push(`✓ ${e}`);
-		for (let e of a) o.push(`✓ ${e} (added)`);
-		if (c) for (let e of i) o.push(`✓ ${e} (replaced)`);
-	}
-	if (!c && i.length > 0) {
-		for (let e of i) o.push(`⚠ ${e} (skipped — modified)`);
-		o.push("", "Run `tracerkit update --force` to replace modified files with latest versions.");
-	}
-	return o;
-}
-//#endregion
-//#region src/commands/uninstall.ts
-function v(t) {
-	if (!u.some((n) => e(s(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — nothing to uninstall");
-	let n = [];
-	for (let r of u) {
-		let a = s(t, ".claude", "skills", r);
-		e(a) && (i(a, {
-			recursive: !0,
-			force: !0
-		}), n.push(`✗ .claude/skills/${r}/ removed`));
-	}
-	return n;
-}
-//#endregion
-export { u as i, _ as n, g as r, v as t };