tracerkit 1.3.1 → 1.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +69 -78
- package/dist/bin.js +4 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,8 +3,10 @@
|
|
|
3
3
|
# TracerKit
|
|
4
4
|
|
|
5
5
|
[](https://github.com/helderberto/tracerkit/actions/workflows/ci.yml)
|
|
6
|
+
[](https://www.npmjs.com/package/tracerkit)
|
|
7
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
8
|
|
|
7
|
-
|
|
9
|
+
Spec-driven workflow for Claude Code: from idea to product requirements to executable plan.
|
|
8
10
|
|
|
9
11
|
**Zero runtime dependencies** — pure Markdown skills, no build step.
|
|
10
12
|
|
|
@@ -32,14 +34,15 @@ Open Claude Code in any project and start using:
|
|
|
32
34
|
|
|
33
35
|
### 3. CLI Reference
|
|
34
36
|
|
|
35
|
-
| Command
|
|
36
|
-
|
|
|
37
|
-
| `tracerkit init`
|
|
38
|
-
| `tracerkit init <path>`
|
|
39
|
-
| `tracerkit update`
|
|
40
|
-
| `tracerkit update --force`
|
|
41
|
-
| `tracerkit
|
|
42
|
-
| `tracerkit
|
|
37
|
+
| Command | Description |
|
|
38
|
+
| ------------------------------ | ---------------------------------------------- |
|
|
39
|
+
| `tracerkit init` | Install skills to `~/.claude/skills/` |
|
|
40
|
+
| `tracerkit init <path>` | Install skills to a specific project directory |
|
|
41
|
+
| `tracerkit update` | Refresh to latest version, skip modified files |
|
|
42
|
+
| `tracerkit update --force` | Replace modified files with latest versions |
|
|
43
|
+
| `tracerkit update --overwrite` | Alias for `--force` (avoids npx flag conflict) |
|
|
44
|
+
| `tracerkit uninstall` | Remove TracerKit skills, keep user artifacts |
|
|
45
|
+
| `tracerkit --version` | Print version |
|
|
43
46
|
|
|
44
47
|
All commands default to the home directory. Pass a path or use `--global` explicitly to target `~/`.
|
|
45
48
|
|
|
@@ -175,17 +178,29 @@ The term comes from [The Pragmatic Programmer](https://pragprog.com/titles/tpp20
|
|
|
175
178
|
<details>
|
|
176
179
|
<summary>New feature from scratch</summary>
|
|
177
180
|
|
|
178
|
-
```
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
181
|
+
```
|
|
182
|
+
You: /tk:prd add dark mode support
|
|
183
|
+
AI: Starting PRD interview...
|
|
184
|
+
? What problem does this solve for users?
|
|
185
|
+
? Should it detect system preference or manual toggle only?
|
|
186
|
+
? Which components need theming?
|
|
187
|
+
...
|
|
188
|
+
✓ Written prds/dark-mode-support.md
|
|
189
|
+
|
|
190
|
+
You: /tk:plan dark-mode-support
|
|
191
|
+
AI: Reading PRD...
|
|
192
|
+
✓ Phase 1 — CSS variables + ThemeProvider (schema → context → tests)
|
|
193
|
+
✓ Phase 2 — Toggle component + localStorage (UI → persistence → tests)
|
|
194
|
+
✓ Phase 3 — System preference detection (media query → sync → tests)
|
|
195
|
+
Written plans/dark-mode-support.md
|
|
196
|
+
|
|
197
|
+
You: # implement each phase with Claude...
|
|
198
|
+
|
|
199
|
+
You: /tk:verify dark-mode-support
|
|
200
|
+
AI: Verifying against plan...
|
|
201
|
+
✓ All done-when conditions met
|
|
202
|
+
✓ Tests passing
|
|
203
|
+
PASS — archived to archive/dark-mode-support/
|
|
189
204
|
```
|
|
190
205
|
|
|
191
206
|
</details>
|
|
@@ -193,15 +208,16 @@ The term comes from [The Pragmatic Programmer](https://pragprog.com/titles/tpp20
|
|
|
193
208
|
<details>
|
|
194
209
|
<summary>Iterating on an accepted PRD</summary>
|
|
195
210
|
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
211
|
+
```
|
|
212
|
+
You: /tk:prd update dark mode to detect system preference
|
|
213
|
+
AI: Found existing prds/dark-mode-support.md
|
|
214
|
+
? Start fresh or revise the existing PRD?
|
|
215
|
+
...
|
|
216
|
+
✓ Updated prds/dark-mode-support.md
|
|
217
|
+
|
|
218
|
+
You: /tk:plan dark-mode-support
|
|
219
|
+
AI: Reading updated PRD...
|
|
220
|
+
✓ Regenerated plans/dark-mode-support.md with new scope
|
|
205
221
|
```
|
|
206
222
|
|
|
207
223
|
</details>
|
|
@@ -209,62 +225,37 @@ PRDs are living documents — refine them any time before or during implementati
|
|
|
209
225
|
<details>
|
|
210
226
|
<summary>Verify → fix → re-verify loop</summary>
|
|
211
227
|
|
|
212
|
-
```
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
#
|
|
228
|
+
```
|
|
229
|
+
You: /tk:verify dark-mode-support
|
|
230
|
+
AI: Verifying against plan...
|
|
231
|
+
✗ Missing toggle persistence in localStorage
|
|
232
|
+
✗ 2 failing tests in ThemeProvider.test.ts
|
|
233
|
+
NEEDS_WORK — 2 blockers found
|
|
234
|
+
|
|
235
|
+
You: # fix the blockers...
|
|
236
|
+
|
|
237
|
+
You: /tk:verify dark-mode-support
|
|
238
|
+
AI: Verifying against plan...
|
|
239
|
+
✓ All done-when conditions met
|
|
240
|
+
✓ Tests passing
|
|
241
|
+
PASS — archived to archive/dark-mode-support/
|
|
220
242
|
```
|
|
221
243
|
|
|
222
244
|
</details>
|
|
223
245
|
|
|
224
246
|
<details>
|
|
225
|
-
<summary>
|
|
247
|
+
<summary>Check workflow status</summary>
|
|
226
248
|
|
|
227
249
|
```
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
|
238
|
-
prds/<slug>.md
|
|
239
|
-
|
|
|
240
|
-
v
|
|
241
|
-
+----------+----------+
|
|
242
|
-
| /tk:plan <slug> |
|
|
243
|
-
| Vertical Slices |
|
|
244
|
-
+----------+----------+
|
|
245
|
-
|
|
|
246
|
-
plans/<slug>.md
|
|
247
|
-
|
|
|
248
|
-
v
|
|
249
|
-
+----------+----------+
|
|
250
|
-
| Implement phases |
|
|
251
|
-
| (you + Claude) |
|
|
252
|
-
+----------+----------+
|
|
253
|
-
|
|
|
254
|
-
v
|
|
255
|
-
+----------+----------+
|
|
256
|
-
| /tk:verify <slug> |
|
|
257
|
-
| Review + archive |
|
|
258
|
-
+----------+----------+
|
|
259
|
-
|
|
|
260
|
-
+--------+--------+
|
|
261
|
-
| |
|
|
262
|
-
NEEDS_WORK PASS
|
|
263
|
-
| |
|
|
264
|
-
v v
|
|
265
|
-
Fix blockers Auto-archived
|
|
266
|
-
then re-run to archive/
|
|
267
|
-
/tk:verify
|
|
250
|
+
You: /tk:status
|
|
251
|
+
AI: Feature Status Dashboard
|
|
252
|
+
┌──────────────────────┬─────────────┬─────┐
|
|
253
|
+
│ Feature │ Status │ Age │
|
|
254
|
+
├──────────────────────┼─────────────┼─────┤
|
|
255
|
+
│ dark-mode-support │ in_progress │ 3d │
|
|
256
|
+
│ api-rate-limiting │ created │ 1d │
|
|
257
|
+
│ user-avatars │ done │ 7d │
|
|
258
|
+
└──────────────────────┴─────────────┴─────┘
|
|
268
259
|
```
|
|
269
260
|
|
|
270
261
|
</details>
|
package/dist/bin.js
CHANGED
|
@@ -13,6 +13,7 @@ var a = [
|
|
|
13
13
|
"",
|
|
14
14
|
"Options:",
|
|
15
15
|
" --force Replace modified files with latest versions",
|
|
16
|
+
" --overwrite Alias for --force (avoids npx flag conflict)",
|
|
16
17
|
" --global Target home directory instead of current directory",
|
|
17
18
|
" --version, -v Print version"
|
|
18
19
|
];
|
|
@@ -22,13 +23,13 @@ function o(e) {
|
|
|
22
23
|
return t ? i() : n ? r(n) : process.cwd();
|
|
23
24
|
}
|
|
24
25
|
function s(r) {
|
|
25
|
-
if (r.includes("--version") || r.includes("-v")) return ["tracerkit/1.3.
|
|
26
|
+
if (r.includes("--version") || r.includes("-v")) return ["tracerkit/1.3.3"];
|
|
26
27
|
let i = r[0], s = r.slice(1);
|
|
27
28
|
switch (i) {
|
|
28
29
|
case "init": return t(o(s));
|
|
29
30
|
case "update": {
|
|
30
|
-
let t = s.includes("--force"), n = e(o(s.filter((e) => e !== "--force")), { force: t });
|
|
31
|
-
return n.push("", "Updated to tracerkit/1.3.
|
|
31
|
+
let t = s.includes("--force") || s.includes("--overwrite"), n = e(o(s.filter((e) => e !== "--force" && e !== "--overwrite")), { force: t });
|
|
32
|
+
return n.push("", "Updated to tracerkit/1.3.3"), n.push("If using Claude Code, restart your session to load changes."), n;
|
|
32
33
|
}
|
|
33
34
|
case "uninstall": return n(o(s));
|
|
34
35
|
default: return a;
|