tracerkit 1.9.3 → 1.9.5
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 +20 -23
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,13 +6,14 @@
|
|
|
6
6
|
|
|
7
7
|
[](https://github.com/helderberto/tracerkit/actions/workflows/ci.yml)
|
|
8
8
|
[](https://www.npmjs.com/package/tracerkit)
|
|
9
|
+
[](https://www.npmjs.com/package/tracerkit)
|
|
9
10
|
[](https://opensource.org/licenses/MIT)
|
|
10
11
|
|
|
11
|
-
Replace ad-hoc AI prompts with a repeatable spec-driven workflow: from idea to verified, archived
|
|
12
|
+
Replace ad-hoc AI prompts with a repeatable spec-driven workflow: from idea to verified, archived spec.
|
|
12
13
|
|
|
13
14
|
Named after the tracer-bullet technique from _The Pragmatic Programmer_: **Tracer** + **Kit**.
|
|
14
15
|
|
|
15
|
-
**
|
|
16
|
+
**Markdown skills, one CLI.** No build step, no project dependencies.
|
|
16
17
|
|
|
17
18
|
</div>
|
|
18
19
|
|
|
@@ -30,26 +31,11 @@ TracerKit takes a different approach: **tracer-bullet vertical slices**. Each ph
|
|
|
30
31
|
npx tracerkit init
|
|
31
32
|
```
|
|
32
33
|
|
|
33
|
-
Skills are installed globally to `~/.claude/skills/`, available in every project.
|
|
34
|
+
Skills are installed globally to `~/.claude/skills/`, available in every project. Safe to re-run — adds missing skills without overwriting ones you've modified.
|
|
34
35
|
|
|
35
36
|
### Workflow
|
|
36
37
|
|
|
37
38
|
```
|
|
38
|
-
You: /tk:brief
|
|
39
|
-
AI: | Feature | Status | Age | Progress | Next |
|
|
40
|
-
|-------------------|-------------|-----|----------|------------------------------|
|
|
41
|
-
| dark-mode-support | in_progress | 3d | 3/7 | Toggle component renders ... |
|
|
42
|
-
|
|
43
|
-
**Focus → dark-mode-support**
|
|
44
|
-
|
|
45
|
-
You: # continue working on dark-mode-support...
|
|
46
|
-
|
|
47
|
-
You: /tk:check dark-mode-support
|
|
48
|
-
AI: Status: done | Total: 7/7
|
|
49
|
-
Archived to .tracerkit/archives/dark-mode-support/
|
|
50
|
-
|
|
51
|
-
---
|
|
52
|
-
|
|
53
39
|
You: /tk:prd add dark mode support
|
|
54
40
|
AI: Written .tracerkit/prds/dark-mode-support.md
|
|
55
41
|
Run `/tk:plan dark-mode-support` next?
|
|
@@ -67,6 +53,17 @@ AI: Status: done | Total: 5/5
|
|
|
67
53
|
Archived to .tracerkit/archives/dark-mode-support/
|
|
68
54
|
```
|
|
69
55
|
|
|
56
|
+
Use `/tk:brief` at the start of any session to see active features and pick up where you left off:
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
You: /tk:brief
|
|
60
|
+
AI: | Feature | Status | Age | Progress | Next |
|
|
61
|
+
|-------------------|-------------|-----|----------|------------------------------|
|
|
62
|
+
| dark-mode-support | in_progress | 3d | 3/7 | Toggle component renders ... |
|
|
63
|
+
|
|
64
|
+
**Focus → dark-mode-support**
|
|
65
|
+
```
|
|
66
|
+
|
|
70
67
|
See [Examples](docs/examples.md) for full walkthroughs.
|
|
71
68
|
|
|
72
69
|
<details>
|
|
@@ -86,27 +83,27 @@ npx tracerkit uninstall . # remove project-scoped skills
|
|
|
86
83
|
|
|
87
84
|
TracerKit ships three skills that take a feature from idea to verified archive.
|
|
88
85
|
|
|
89
|
-
|
|
86
|
+
### `/tk:prd <idea>`: Write a PRD
|
|
90
87
|
|
|
91
88
|
Interactive interview that explores your codebase, asks scoping questions one at a time, designs deep modules, and writes a structured PRD.
|
|
92
89
|
|
|
93
90
|
**Output:** `.tracerkit/prds/<slug>.md`
|
|
94
91
|
|
|
95
|
-
|
|
92
|
+
### `/tk:plan <slug>`: Create an implementation plan
|
|
96
93
|
|
|
97
94
|
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.
|
|
98
95
|
|
|
99
96
|
**Output:** `.tracerkit/plans/<slug>.md`
|
|
100
97
|
|
|
101
|
-
|
|
98
|
+
### `/tk:brief`: Session briefing
|
|
102
99
|
|
|
103
100
|
Shows active features, their progress, and suggested focus. Use at the start of a session to orient.
|
|
104
101
|
|
|
105
102
|
**Output:** Feature dashboard in the terminal — no files written.
|
|
106
103
|
|
|
107
|
-
|
|
104
|
+
### `/tk:check [slug]`: Verify and archive
|
|
108
105
|
|
|
109
|
-
|
|
106
|
+
Verifies the codebase against the plan's done-when checkboxes. Runs tests, validates user stories, updates phase progress, and transitions the PRD status. On `done`, archives the PRD and plan to `.tracerkit/archives/<slug>/` automatically.
|
|
110
107
|
|
|
111
108
|
Without arguments, shows a feature dashboard with status and progress before asking which feature to check.
|
|
112
109
|
|