tracerkit 1.17.2 → 1.17.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/package.json +1 -1
- package/skills/check/SKILL.md +4 -4
- package/skills/plan/SKILL.md +8 -8
- package/skills/prd/SKILL.md +7 -7
package/package.json
CHANGED
package/skills/check/SKILL.md
CHANGED
|
@@ -9,7 +9,7 @@ argument-hint: '[slug]'
|
|
|
9
9
|
|
|
10
10
|
Check implementation against a plan. Update checks, stamp findings, transition status, and mark complete when done.
|
|
11
11
|
|
|
12
|
-
**Interactive prompts**:
|
|
12
|
+
**Interactive prompts**: present options as a numbered list and wait for the user's choice.
|
|
13
13
|
|
|
14
14
|
## Pre-loaded context
|
|
15
15
|
|
|
@@ -52,7 +52,7 @@ For each `.md` file in `.tracerkit/prds/`:
|
|
|
52
52
|
6. If plan issue exists, count progress from checkboxes in its body (see Progress Algorithm below). Show `—` if no plan.
|
|
53
53
|
<!-- end:github -->
|
|
54
54
|
|
|
55
|
-
Present each feature as an option and let the user pick which to verify.
|
|
55
|
+
Present each feature as an option and let the user pick which to verify.
|
|
56
56
|
|
|
57
57
|
## Progress Algorithm
|
|
58
58
|
|
|
@@ -64,12 +64,12 @@ Count `- [x]` and `- [ ]` lines under each `## Phase N` heading. Per-phase: `Pha
|
|
|
64
64
|
|
|
65
65
|
<!-- if:local -->
|
|
66
66
|
|
|
67
|
-
Read `.tracerkit/plans/<slug>.md`. If missing, list plans and ask the user to select one
|
|
67
|
+
Read `.tracerkit/plans/<slug>.md`. If missing, list plans and ask the user to select one.
|
|
68
68
|
|
|
69
69
|
<!-- end:local -->
|
|
70
70
|
<!-- if:github -->
|
|
71
71
|
|
|
72
|
-
Find plan issue: open issue with label `{{github.labels.plan}}`, title matching `[{{github.labels.plan}}] <slug>:`. If missing, list plans and ask the user to select one
|
|
72
|
+
Find plan issue: open issue with label `{{github.labels.plan}}`, title matching `[{{github.labels.plan}}] <slug>:`. If missing, list plans and ask the user to select one.
|
|
73
73
|
|
|
74
74
|
<!-- end:github -->
|
|
75
75
|
|
package/skills/plan/SKILL.md
CHANGED
|
@@ -9,7 +9,7 @@ argument-hint: '[slug]'
|
|
|
9
9
|
|
|
10
10
|
Break a PRD into phased vertical slices (tracer bullets).
|
|
11
11
|
|
|
12
|
-
**Interactive prompts**:
|
|
12
|
+
**Interactive prompts**: present options as a numbered list and wait for the user's choice.
|
|
13
13
|
|
|
14
14
|
<!-- if:local -->
|
|
15
15
|
|
|
@@ -36,7 +36,7 @@ Output: a GitHub Issue with label `{{github.labels.plan}}`.
|
|
|
36
36
|
|
|
37
37
|
The argument (if provided) is: $ARGUMENTS
|
|
38
38
|
|
|
39
|
-
Use argument as `<slug>`. If empty, list available PRDs and ask the user to select one
|
|
39
|
+
Use argument as `<slug>`. If empty, list available PRDs and ask the user to select one.
|
|
40
40
|
|
|
41
41
|
## Workflow
|
|
42
42
|
|
|
@@ -44,12 +44,12 @@ Use argument as `<slug>`. If empty, list available PRDs and ask the user to sele
|
|
|
44
44
|
|
|
45
45
|
<!-- if:local -->
|
|
46
46
|
|
|
47
|
-
Read `.tracerkit/prds/<slug>.md`. If missing, list PRDs and ask the user to select one. If `.tracerkit/plans/<slug>.md` exists, ask: "Overwrite existing" / "Pick a new name".
|
|
47
|
+
Read `.tracerkit/prds/<slug>.md`. If missing, list PRDs and ask the user to select one. If `.tracerkit/plans/<slug>.md` exists, ask: "Overwrite existing" / "Pick a new name".
|
|
48
48
|
|
|
49
49
|
<!-- end:local -->
|
|
50
50
|
<!-- if:github -->
|
|
51
51
|
|
|
52
|
-
Find PRD issue: open issue with label `{{github.labels.prd}}`, title matching `[{{github.labels.prd}}] <slug>:`. If missing, list PRDs and ask the user to select one. If plan issue with label `{{github.labels.plan}}` and matching title exists, ask: "Update existing plan" / "Use a new name".
|
|
52
|
+
Find PRD issue: open issue with label `{{github.labels.prd}}`, title matching `[{{github.labels.prd}}] <slug>:`. If missing, list PRDs and ask the user to select one. If plan issue with label `{{github.labels.plan}}` and matching title exists, ask: "Update existing plan" / "Use a new name".
|
|
53
53
|
|
|
54
54
|
<!-- end:github -->
|
|
55
55
|
|
|
@@ -112,7 +112,7 @@ Each phase: thin vertical slice through all layers (schema → service → API
|
|
|
112
112
|
|
|
113
113
|
- 1 module touched → 2–3 phases max
|
|
114
114
|
- 2–3 modules touched → 3–5 phases max
|
|
115
|
-
- 4+ modules or 6+ phases → stop and ask: "PRD touches 4+ modules. Split before planning?" with options: "Split the PRD" (Recommended) / "Continue anyway".
|
|
115
|
+
- 4+ modules or 6+ phases → stop and ask: "PRD touches 4+ modules. Split before planning?" with options: "Split the PRD" (Recommended) / "Continue anyway".
|
|
116
116
|
|
|
117
117
|
Count "modules touched" by scanning the PRD's New Modules and Schema Changes sections.
|
|
118
118
|
|
|
@@ -124,7 +124,7 @@ Assign an agent tag to tasks where appropriate:
|
|
|
124
124
|
|
|
125
125
|
### 5. Quiz the user
|
|
126
126
|
|
|
127
|
-
Present breakdown (title, user stories covered, done-when per phase). Ask: "How's the granularity?" with options: "Looks good, proceed" (Recommended) / "Merge some phases" / "Split a phase".
|
|
127
|
+
Present breakdown (title, user stories covered, done-when per phase). Ask: "How's the granularity?" with options: "Looks good, proceed" (Recommended) / "Merge some phases" / "Split a phase". Iterate until approved.
|
|
128
128
|
|
|
129
129
|
### 6. Save plan
|
|
130
130
|
|
|
@@ -217,11 +217,11 @@ Carried forward from PRD verbatim.
|
|
|
217
217
|
Gaps found in the PRD needing resolution. Blank if none.
|
|
218
218
|
```
|
|
219
219
|
|
|
220
|
-
Print one line per phase: `Phase N — <title> (<condition summary>)`. Then ask: "What's next?" with options: "Start implementing" (Recommended) / "Run `/tk:check <slug>`" / "Done for now".
|
|
220
|
+
Print one line per phase: `Phase N — <title> (<condition summary>)`. Then ask: "What's next?" with options: "Start implementing" (Recommended) / "Run `/tk:check <slug>`" / "Done for now".
|
|
221
221
|
|
|
222
222
|
## Execution guidance
|
|
223
223
|
|
|
224
|
-
When implementing this plan, **always offer to create a feature branch** before writing any code. Ask: "Create branch `feat/<slug>`?" with options: "Yes, create branch" (Recommended) / "No, stay on current branch".
|
|
224
|
+
When implementing this plan, **always offer to create a feature branch** before writing any code. Ask: "Create branch `feat/<slug>`?" with options: "Yes, create branch" (Recommended) / "No, stay on current branch". If accepted, create the branch from the default branch.
|
|
225
225
|
|
|
226
226
|
### During implementation
|
|
227
227
|
|
package/skills/prd/SKILL.md
CHANGED
|
@@ -9,7 +9,7 @@ argument-hint: <idea>
|
|
|
9
9
|
|
|
10
10
|
Skip satisfied steps. If argument provided, skip to Step 2.
|
|
11
11
|
|
|
12
|
-
**Interactive prompts**:
|
|
12
|
+
**Interactive prompts**: present options as a numbered list and wait for the user's choice.
|
|
13
13
|
|
|
14
14
|
## Pre-loaded context
|
|
15
15
|
|
|
@@ -36,12 +36,12 @@ If empty, go to Step 1; derive slug after gathering the idea. If provided, deriv
|
|
|
36
36
|
|
|
37
37
|
<!-- if:local -->
|
|
38
38
|
|
|
39
|
-
Output: `.tracerkit/prds/<slug>.md`. If exists, ask: "Overwrite existing" / "Pick a new name"
|
|
39
|
+
Output: `.tracerkit/prds/<slug>.md`. If exists, ask: "Overwrite existing" / "Pick a new name".
|
|
40
40
|
|
|
41
41
|
<!-- end:local -->
|
|
42
42
|
<!-- if:github -->
|
|
43
43
|
|
|
44
|
-
Output: GitHub Issue with label `{{github.labels.prd}}`, title `[{{github.labels.prd}}] <slug>: <Feature Title>`. If matching issue exists, ask: "Update existing issue" / "Use a new slug"
|
|
44
|
+
Output: GitHub Issue with label `{{github.labels.prd}}`, title `[{{github.labels.prd}}] <slug>: <Feature Title>`. If matching issue exists, ask: "Update existing issue" / "Use a new slug".
|
|
45
45
|
|
|
46
46
|
<!-- end:github -->
|
|
47
47
|
|
|
@@ -59,7 +59,7 @@ Map current state: data models, services, API routes, frontend, tests. Note exis
|
|
|
59
59
|
|
|
60
60
|
### 3. Interview
|
|
61
61
|
|
|
62
|
-
One question at a time. Lead with your recommended answer (mark it `(Recommended)` and list first). Explore code instead of asking when possible. Present 2–4 options for each question — structured choices are faster than free-text.
|
|
62
|
+
One question at a time. Lead with your recommended answer (mark it `(Recommended)` and list first). Explore code instead of asking when possible. Present 2–4 options for each question — structured choices are faster than free-text.
|
|
63
63
|
|
|
64
64
|
| Branch | Key questions | Skip when |
|
|
65
65
|
| ---------------- | --------------------------------------- | -------------------------------- |
|
|
@@ -73,7 +73,7 @@ One question at a time. Lead with your recommended answer (mark it `(Recommended
|
|
|
73
73
|
|
|
74
74
|
### 3b. Gray areas
|
|
75
75
|
|
|
76
|
-
Surface ambiguities, contradictions, unstated assumptions. For each gray area, present proposed resolution options
|
|
76
|
+
Surface ambiguities, contradictions, unstated assumptions. For each gray area, present proposed resolution options. Resolve all before continuing.
|
|
77
77
|
|
|
78
78
|
### 4. Design modules
|
|
79
79
|
|
|
@@ -81,7 +81,7 @@ Sketch modules. Favor **deep modules** — simple interface (1-3 entry points) h
|
|
|
81
81
|
|
|
82
82
|
Shallow signals: many small 1:1 functions, callers compose multiple calls, feature changes require interface changes.
|
|
83
83
|
|
|
84
|
-
Present modules. Confirm which need tests
|
|
84
|
+
Present modules. Confirm which need tests.
|
|
85
85
|
|
|
86
86
|
### 5. Write PRD
|
|
87
87
|
|
|
@@ -136,4 +136,4 @@ PRD body structure (same for local file and issue body). Omit empty sections. No
|
|
|
136
136
|
|
|
137
137
|
---
|
|
138
138
|
|
|
139
|
-
Then ask: "What's next?" with options: "Run `/tk:plan <slug>`" (Recommended) / "Done for now".
|
|
139
|
+
Then ask: "What's next?" with options: "Run `/tk:plan <slug>`" (Recommended) / "Done for now".
|