tracerkit 1.9.5 → 1.9.6

package/README.md

@@ -23,15 +23,20 @@ Without specs, every AI session starts from scratch. Vague prompts, duplicated c
 
 TracerKit takes a different approach: **tracer-bullet vertical slices**. Each phase cuts through every layer (schema → service → API → UI → tests), so every phase is demoable on its own. Integration problems surface early, context stays focused, and AI assistants get small, well-scoped phases instead of sprawling layers.
 
+**Deterministic CLI, intelligent skills.** The CLI produces structured, repeatable output — feature tables, progress counts, archive operations — while the skills layer AI reasoning on top. The foundation is deterministic, so every session starts from the same ground truth. AI adds the judgment: interviewing you for scope, designing modules, verifying implementation against specs.
+
 ## Get Started
 
 ### Install
 
 ```bash
-npx tracerkit init
+npm install -g tracerkit
+tracerkit init
 ```
 
-Skills are installed globally to `~/.claude/skills/`, available in every project. Safe to re-run — adds missing skills without overwriting ones you've modified.
+The global install is by design — skills call `tracerkit brief`, `tracerkit progress`, and `tracerkit archive` directly to get deterministic output before the AI acts on it. Having the CLI in your PATH keeps this seamless.
+
+Skills are installed to `~/.claude/skills/`, available in every project. Safe to re-run — adds missing skills without overwriting ones you've modified.
 
 ### Workflow
 
@@ -81,7 +86,7 @@ npx tracerkit uninstall .         # remove project-scoped skills
 
 ## Skills
 
-TracerKit ships three skills that take a feature from idea to verified archive.
+TracerKit ships skills that take a feature from idea to verified archive.
 
 ### `/tk:prd <idea>`: Write a PRD
 

package/package.json

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

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

@@ -8,30 +8,22 @@ Get a quick overview of all active features, their progress, and what to focus o
 
 ## Pre-loaded context
 
-- Briefing: !`npx tracerkit brief 2>/dev/null || echo "no {{paths.prds}}/ directory found"`
+- Briefing: !`tracerkit brief 2>&1`
 
 ## Workflow
 
 ### 1. Present the briefing
 
-Display the output above as-is. The table includes:
+Display the output above as-is. Features with `status: done` are excluded (already archived).
 
-- **Feature**: slug (PRD filename without `.md`)
-- **Status**: from PRD frontmatter (`created`, `in_progress`) — `unknown` if no frontmatter
-- **Age**: time since `created` date
-- **Progress**: checked/total from plan checkboxes, or `—` if no plan
-- **Next**: first unchecked item from the plan, or `—`
-
-Features with `status: done` are excluded (already archived).
-
-### 2. Focus recommendation
+### 3. Focus recommendation
 
 The **Focus** line at the bottom suggests which feature to work on:
 
 - If exactly 1 feature is `in_progress`, it's auto-selected
 - Otherwise, the oldest feature by `created` date is selected
 
-### 3. Offer next steps
+### 4. Offer next steps
 
 Ask the user what they'd like to do:
 

package/templates/.claude/skills/tk: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>/dev/null || echo "no {{paths.plans}}/ directory found"`
+- Available plans: !`ls {{paths.plans}}/ 2>&1`
 
 ## Input
 
@@ -27,7 +27,7 @@ If no argument is provided, scan `{{paths.prds}}/` and `{{paths.plans}}/` and sh
 
 - **Feature**: slug (filename without `.md`)
 - **Status**: from PRD frontmatter (`created`, `in_progress`, `done`) — `unknown` if no frontmatter
-- **Progress**: run `npx tracerkit progress <slug>` for each feature with a plan — use the Total line (e.g. "3/7"). Show `—` if no plan.
+- **Progress**: run `tracerkit progress <slug>` for each feature with a plan — use the Total line (e.g. "3/7"). Show `—` if no plan.
 
 After the table, ask which feature to verify.
 
@@ -75,7 +75,7 @@ Based on checks and findings, decide the status transition:
 
 ### 5. Report to user
 
-Run `npx tracerkit progress <slug>` to get exact per-phase progress, then print the verdict report:
+Run `tracerkit progress <slug>` to get exact per-phase progress, then print the verdict report:
 
 ```
 ## Verification: <slug>
@@ -114,7 +114,7 @@ If a previous verdict block exists, replace it with the new one.
 If all checks pass and zero BLOCKERS, run:
 
 ```
-npx tracerkit archive <slug>
+tracerkit archive <slug>
 ```
 
 This handles: PRD frontmatter update (`status: done`, `completed` timestamp), file moves to `{{paths.archives}}/<slug>/`, and archived block on the plan.

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

@@ -9,7 +9,7 @@ Break a PRD into phased vertical slices (tracer bullets). Output: `{{paths.plans
 
 ## Pre-loaded context
 
-- Available PRDs: !`ls {{paths.prds}}/ 2>/dev/null || echo "no {{paths.prds}}/ directory found"`
+- Available PRDs: !`ls {{paths.prds}}/ 2>&1`
 
 ## Input
 

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

@@ -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>/dev/null || echo "none"`
+- Existing PRDs: !`ls {{paths.prds}}/ 2>&1`
 
 ## Input