tracerkit 1.10.2 → 1.11.0

package/README.md

@@ -28,12 +28,36 @@ The workflow is three skills: **define** (`/tk:prd`), **plan** (`/tk:plan`), **v
 ### Install
 
 ```bash
-$ npm install -g tracerkit
-$ tracerkit init
+npm install -g tracerkit
+tracerkit init
 ```
 
 Skills are installed to `~/.claude/skills/`, available in every project. Safe to re-run — adds missing skills without overwriting ones you've modified.
 
+<details>
+<summary>Per-project install (team members get skills via git)</summary>
+
+```bash
+tracerkit init .              # install to .claude/skills/ in current dir
+tracerkit update .            # update project-scoped skills
+tracerkit uninstall .         # remove project-scoped skills
+```
+
+</details>
+
+<details>
+<summary>Claude Code plugin (alternative)</summary>
+
+Inside Claude Code, run:
+
+```
+/plugin install tk@claude-plugins-official
+```
+
+Run `/reload-plugins` if needed. Skills are available immediately — no build step, no config.
+
+</details>
+
 ### Workflow
 
 ```
@@ -67,19 +91,6 @@ AI:  | Feature           | Status      | Age | Progress | Next
 
 See [Examples](docs/examples.md) for full walkthroughs.
 
-<details>
-<summary>Per-project usage</summary>
-
-To scope skills to a single project (team members get them via git):
-
-```bash
-$ tracerkit init .              # install to .claude/skills/ in current dir
-$ tracerkit update .            # update project-scoped skills
-$ tracerkit uninstall .         # remove project-scoped skills
-```
-
-</details>
-
 ## Skills
 
 TracerKit ships skills that take a feature from idea to verified archive.

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as e, i as t, n, r, s as i, t as a } from "./uninstall-Bgs58wa2.js";
+import { a as e, i as t, n, r, s as i, t as a } from "./uninstall-BhTMOfMb.js";
 import { readFileSync as o } from "node:fs";
 import { dirname as s, resolve as c } from "node:path";
 import { fileURLToPath as l } 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 } from "./uninstall-Bgs58wa2.js";
+import { c as e, i as t, n, o as r, r as i, t as a } from "./uninstall-BhTMOfMb.js";
 export { t as COMMANDS, r as DEPRECATED_SKILLS, e as SKILL_NAMES, n as init, a as uninstall, i as update };

package/dist/{uninstall-Bgs58wa2.js → uninstall-BhTMOfMb.js}

@@ -53,7 +53,7 @@ var f = [
 		args: "[path]",
 		desc: "Remove TracerKit skill directories, keep .tracerkit/ artifacts"
 	}
-], _ = s(o(l(import.meta.url)), "..", "templates");
+], _ = s(o(l(import.meta.url)), "..", "skills");
 function v(e, t = "") {
 	let n = r(e, { withFileTypes: !0 }), i = [];
 	for (let r of n) {
@@ -62,28 +62,35 @@ function v(e, t = "") {
 	}
 	return i.sort();
 }
-function y(e, t) {
-	return e.replaceAll("{{paths.prds}}", t.paths.prds).replaceAll("{{paths.plans}}", t.paths.plans).replaceAll("{{paths.archives}}", t.paths.archives);
+function y(e) {
+	return `.claude/skills/tk:${e}`;
 }
-function b(e, r, i) {
-	let c = i ?? v(_);
+function b(e) {
+	return e.slice(18);
+}
+function x(e, t) {
+	let n = e;
+	return t.paths.prds !== u.prds && (n = n.replaceAll(u.prds, t.paths.prds)), t.paths.plans !== u.plans && (n = n.replaceAll(u.plans, t.paths.plans)), t.paths.archives !== u.archives && (n = n.replaceAll(u.archives, t.paths.archives)), n;
+}
+function S(e, r, i) {
+	let c = i ?? v(_).map(y);
 	for (let i of c) {
-		let c = s(_, i), l = s(e, i);
-		t(o(l), { recursive: !0 }), a(l, y(n(c, "utf8"), r));
+		let c = s(_, b(i)), l = s(e, i);
+		t(o(l), { recursive: !0 }), a(l, x(n(c, "utf8"), r));
 	}
 	return { copied: c };
 }
-function x(e) {
+function C(e) {
 	return c("sha256").update(e).digest("hex");
 }
-function S(t, r) {
-	let i = v(_), a = [], o = [], c = [];
+function w(t, r) {
+	let i = v(_).map(y), a = [], o = [], c = [];
 	for (let l of i) {
 		let i = s(t, l);
 		if (!e(i)) c.push(l);
 		else {
-			let e = y(n(s(_, l), "utf8"), r);
-			x(Buffer.from(e)) === x(n(i)) ? a.push(l) : o.push(l);
+			let e = x(n(s(_, b(l)), "utf8"), r);
+			C(Buffer.from(e)) === C(n(i)) ? a.push(l) : o.push(l);
 		}
 	}
 	return {
@@ -94,9 +101,9 @@ function S(t, r) {
 }
 //#endregion
 //#region src/commands/update.ts
-function C(t, n) {
+function T(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: a, modified: o, missing: c } = S(t, r), l = [];
+	let r = d(t), { unchanged: a, modified: o, missing: c } = w(t, r), l = [];
 	for (let n of p) {
 		let r = s(t, ".claude", "skills", n);
 		e(r) && (i(r, {
@@ -110,7 +117,7 @@ function C(t, n) {
 		...u ? o : []
 	];
 	if (m.length > 0) {
-		b(t, r, m);
+		S(t, r, m);
 		for (let e of a) l.push(`✓ ${e}`);
 		for (let e of c) l.push(`✓ ${e} (added)`);
 		if (u) for (let e of o) l.push(`✓ ${e} (replaced)`);
@@ -123,14 +130,14 @@ function C(t, n) {
 }
 //#endregion
 //#region src/commands/init.ts
-function w(t) {
-	if (f.some((n) => e(s(t, ".claude", "skills", n)))) return C(t);
-	let { copied: n } = b(t, d(t));
+function E(t) {
+	if (f.some((n) => e(s(t, ".claude", "skills", n)))) return T(t);
+	let { copied: n } = S(t, d(t));
 	return n.map((e) => `✓ ${e}`);
 }
 //#endregion
 //#region src/commands/uninstall.ts
-function T(t) {
+function D(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) {
@@ -143,4 +150,4 @@ function T(t) {
 	return n;
 }
 //#endregion
-export { h as a, f as c, g as i, w as n, p as o, C as r, m as s, T as t };
+export { h as a, f as c, g as i, E as n, p as o, T as r, m as s, D as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracerkit",
-  "version": "1.10.2",
+  "version": "1.11.0",
   "description": "Spec-driven workflow for Claude Code: replace ad-hoc prompts with PRD → plan → verify.",
   "license": "MIT",
   "author": {
@@ -33,7 +33,7 @@
   ],
   "files": [
     "dist",
-    "templates"
+    "skills"
   ],
   "engines": {
     "node": ">=22.0.0",
@@ -50,6 +50,7 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "typecheck": "tsc --noEmit",
+    "version": "node -e \"const f='.claude-plugin/plugin.json';const p=JSON.parse(require('fs').readFileSync(f,'utf8'));p.version=require('./package.json').version;require('fs').writeFileSync(f,JSON.stringify(p,null,2)+'\\n')\"",
     "prepare": "husky || true && npm run build",
     "release": "semantic-release"
   },

package/{templates/.claude/skills/tk:brief → skills/brief}/SKILL.md

@@ -8,7 +8,7 @@ Get a quick overview of all active features, their progress, and what to focus o
 
 ## Pre-loaded context
 
-- Available PRDs: !`ls {{paths.prds}}/ 2>&1`
+- Available PRDs: !`ls .tracerkit/prds/ 2>&1`
 
 ## Algorithm
 
@@ -16,7 +16,7 @@ Follow these steps exactly to build the briefing table:
 
 ### 1. Discover features
 
-For each `.md` file in `{{paths.prds}}/`:
+For each `.md` file in `.tracerkit/prds/`:
 
 1. Read the file
 2. Parse YAML frontmatter (the block between `---` fences at the top)
@@ -26,7 +26,7 @@ For each `.md` file in `{{paths.prds}}/`:
 
 ### 2. Count progress from plans
 
-For each slug, check if `{{paths.plans}}/<slug>.md` exists. If it does:
+For each slug, check if `.tracerkit/plans/<slug>.md` exists. If it does:
 
 1. Read the plan file
 2. Find every `## Phase N` heading (regex: `^## Phase \d+`)
@@ -74,6 +74,6 @@ Append below the table:
 
 Ask the user what they'd like to do:
 
-- Continue the focused feature (read its plan at `{{paths.plans}}/<slug>.md`)
+- Continue the focused feature (read its plan at `.tracerkit/plans/<slug>.md`)
 - Start a new feature with `/tk:prd`
 - Check progress on a feature with `/tk:check <slug>`

package/{templates/.claude/skills/tk:check → skills/check}/SKILL.md

@@ -9,7 +9,7 @@ Check implementation against a plan. Update checks, stamp findings, transition s
 
 ## Pre-loaded context
 
-- Available plans: !`ls {{paths.plans}}/ 2>&1`
+- Available plans: !`ls .tracerkit/plans/ 2>&1`
 
 ## Input
 
@@ -25,11 +25,11 @@ If no argument is provided, build a summary table before asking which one to che
 | <slug>  | ...    | 3/7      |
 ```
 
-For each `.md` file in `{{paths.prds}}/`:
+For each `.md` file in `.tracerkit/prds/`:
 
 1. Read the file, parse YAML frontmatter (block between `---` fences)
 2. Extract `status` — use `unknown` if missing
-3. If `{{paths.plans}}/<slug>.md` exists, count progress (see Progress Algorithm below). Show `—` if no plan.
+3. If `.tracerkit/plans/<slug>.md` exists, count progress (see Progress Algorithm below). Show `—` if no plan.
 
 After the table, ask which feature to verify.
 
@@ -48,7 +48,7 @@ To count progress for a plan file:
 
 ### 1. Load the plan
 
-Read `{{paths.plans}}/<slug>.md`. If it does not exist, list available plans and ask.
+Read `.tracerkit/plans/<slug>.md`. If it does not exist, list available plans and ask.
 
 ### 2. Load the PRD
 
@@ -76,7 +76,7 @@ Collect findings into two categories:
 
 ### 3c. Update checkboxes
 
-Using the subagent's report, update each checkbox in `{{paths.plans}}/<slug>.md` to `[x]` or `[ ]`.
+Using the subagent's report, update each checkbox in `.tracerkit/plans/<slug>.md` to `[x]` or `[ ]`.
 
 ### 4. Determine outcome
 
@@ -112,7 +112,7 @@ Total: checked/total
 
 ### 6. Stamp the plan
 
-Append a verdict block at the bottom of `{{paths.plans}}/<slug>.md`:
+Append a verdict block at the bottom of `.tracerkit/plans/<slug>.md`:
 
 ```markdown
 ---
@@ -131,19 +131,19 @@ If a previous verdict block exists, replace it with the new one.
 
 If all checks pass and zero BLOCKERS, perform these steps in order:
 
-1. Create directory `{{paths.archives}}/<slug>/`
-2. If `{{paths.prds}}/<slug>.md` exists:
+1. Create directory `.tracerkit/archives/<slug>/`
+2. If `.tracerkit/prds/<slug>.md` exists:
    - Read the PRD file
    - In the YAML frontmatter (between `---` fences), find the `status:` line and replace its value with `done`. If no `status:` line exists, add `status: done` as a new line inside the frontmatter block.
    - Add a `completed: <current UTC ISO 8601 timestamp>` line inside the frontmatter block (e.g. `completed: 2025-06-15T14:30:00Z`)
-   - Write the updated content to `{{paths.archives}}/<slug>/prd.md`
-3. Read `{{paths.plans}}/<slug>.md`
+   - Write the updated content to `.tracerkit/archives/<slug>/prd.md`
+3. Read `.tracerkit/plans/<slug>.md`
    - Append to the end: `\n## Archived\n\nArchived on YYYY-MM-DD.\n`
-   - Write the result to `{{paths.archives}}/<slug>/plan.md`
-4. Delete `{{paths.prds}}/<slug>.md` (if it exists)
-5. Delete `{{paths.plans}}/<slug>.md`
+   - Write the result to `.tracerkit/archives/<slug>/plan.md`
+4. Delete `.tracerkit/prds/<slug>.md` (if it exists)
+5. Delete `.tracerkit/plans/<slug>.md`
 
-Tell the user: archived to `{{paths.archives}}/<slug>/`, one-line summary of the feature.
+Tell the user: archived to `.tracerkit/archives/<slug>/`, one-line summary of the feature.
 
 ### 8. On `in_progress` (no blockers)
 
@@ -164,5 +164,5 @@ List the blockers to fix, then re-run `/tk:check <slug>`.
 
 - Plan not found — list available plans and ask
 - PRD referenced in plan not found — warn and continue with plan checks only
-- `{{paths.plans}}/` missing — tell user to run `/tk:plan` first
-- `{{paths.archives}}/<slug>/` already exists — warn and ask whether to remove it first
+- `.tracerkit/plans/` missing — tell user to run `/tk:plan` first
+- `.tracerkit/archives/<slug>/` already exists — warn and ask whether to remove it first

package/{templates/.claude/skills/tk:plan → skills/plan}/SKILL.md

@@ -1,15 +1,15 @@
 ---
-description: Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved to {{paths.plans}}/. Use after /tk:prd.
+description: Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved to .tracerkit/plans/. Use after /tk:prd.
 argument-hint: '[slug]'
 ---
 
 # PRD to Plan
 
-Break a PRD into phased vertical slices (tracer bullets). Output: `{{paths.plans}}/<slug>.md`.
+Break a PRD into phased vertical slices (tracer bullets). Output: `.tracerkit/plans/<slug>.md`.
 
 ## Pre-loaded context
 
-- Available PRDs: !`ls {{paths.prds}}/ 2>&1`
+- Available PRDs: !`ls .tracerkit/prds/ 2>&1`
 
 ## Input
 
@@ -21,13 +21,13 @@ Use the argument as `<slug>` if given. If no argument is provided, list availabl
 
 ### 1. Read the PRD
 
-Read `{{paths.prds}}/<slug>.md`. If it does not exist, list available PRDs and ask.
+Read `.tracerkit/prds/<slug>.md`. If it does not exist, list available PRDs and ask.
 
-If `{{paths.plans}}/<slug>.md` already exists, tell the user and ask whether to overwrite or pick a new name.
+If `.tracerkit/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 `{{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 `---`.
+Update the YAML frontmatter in `.tracerkit/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.
 
@@ -97,12 +97,12 @@ Ask: Does the granularity feel right? Should any phases merge or split? Iterate
 
 ### 6. Save plan
 
-Save to `{{paths.plans}}/<slug>.md` (create `{{paths.plans}}/` if missing).
+Save to `.tracerkit/plans/<slug>.md` (create `.tracerkit/plans/` if missing).
 
 ```markdown
 # Plan: <Feature Name>
 
-> Source PRD: `{{paths.prds}}/<slug>.md`
+> Source PRD: `.tracerkit/prds/<slug>.md`
 
 ## Architectural Decisions
 
@@ -153,4 +153,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
-- `{{paths.plans}}/` missing — create it
+- `.tracerkit/plans/` missing — create it

package/{templates/.claude/skills/tk:prd → skills/prd}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: Create a PRD through user interview, codebase exploration, and module design, saved to {{paths.prds}}/. Use when starting a new feature or change.
+description: Create a PRD through user interview, codebase exploration, and module design, saved to .tracerkit/prds/. Use when starting a new feature or change.
 argument-hint: <idea>
 ---
 
@@ -9,7 +9,7 @@ Skip steps already satisfied. If user provided a description via arguments, skip
 
 ## Pre-loaded context
 
-- Existing PRDs: !`ls {{paths.prds}}/ 2>&1`
+- Existing PRDs: !`ls .tracerkit/prds/ 2>&1`
 
 ## Input
 
@@ -25,9 +25,9 @@ If the argument is provided, derive a slug using this exact algorithm:
 4. Take the first 4 remaining words (or fewer if less exist)
 5. Join with hyphens → `<slug>`
 
-The output file is `{{paths.prds}}/<slug>.md`.
+The output file is `.tracerkit/prds/<slug>.md`.
 
-If `{{paths.prds}}/<slug>.md` already exists, tell the user and ask whether to overwrite or pick a new name.
+If `.tracerkit/prds/<slug>.md` already exists, tell the user and ask whether to overwrite or pick a new name.
 
 ## Workflow
 
@@ -84,7 +84,7 @@ Present modules to user. Confirm which need tests.
 
 ### 5. Write PRD
 
-Save to `{{paths.prds}}/<slug>.md` (create `{{paths.prds}}/` if missing).
+Save to `.tracerkit/prds/<slug>.md` (create `.tracerkit/prds/` if missing).
 
 ```markdown
 ---
@@ -161,5 +161,5 @@ Tell the user: file created, one-line summary. Then ask: "Run `/tk:plan <slug>`
 
 ## Error Handling
 
-- `{{paths.prds}}/` missing — create it
+- `.tracerkit/prds/` missing — create it
 - Scope larger than expected — surface and re-scope with user before continuing