tracerkit 1.18.3 → 1.19.1

package/skills/check/SKILL.md

@@ -3,8 +3,6 @@ description: Verify implementation against plan. Shows progress, finds blockers,
 argument-hint: '[slug]'
 ---
 
-**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks.
-
 # Check Implementation
 
 Check implementation against a plan. Update checks, stamp findings, transition status, and mark complete when done.
@@ -13,13 +11,7 @@ Check implementation against a plan. Update checks, stamp findings, transition s
 
 ## Pre-loaded context
 
-<!-- if:local -->
-
 - Available plans: !`ls .tracerkit/plans/*.md 2>/dev/null || echo "(none)"`
-  <!-- end:local -->
-  <!-- if:github -->
-- Available plans: list open GitHub Issues with label `{{github.labels.plan}}`
-<!-- end:github -->
 
 ## Input
 
@@ -35,24 +27,13 @@ If no argument is provided, build a summary table before asking which one to che
 | <slug>  | ...    | 3/7      |
 ```
 
-<!-- if:local -->
-
 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 `.tracerkit/plans/<slug>.md` exists, count progress (see Progress Algorithm below). Show `—` if no plan.
-   <!-- end:local -->
-   <!-- if:github -->
-
-   List open GitHub Issues with label `{{github.labels.prd}}`:
 
-4. For each PRD issue, extract `status` from labels (`tk:created`, `tk:in-progress`)
-5. Find matching plan issue with label `{{github.labels.plan}}` and same slug in title
-6. If plan issue exists, count progress from checkboxes in its body (see Progress Algorithm below). Show `—` if no plan.
-<!-- end:github -->
-
-Present each feature as an option and let the user pick which to verify.
+Present each feature as a numbered option and wait for the user's choice.
 
 ## Progress Algorithm
 
@@ -62,30 +43,12 @@ Count `- [x]` and `- [ ]` lines under each `## Phase N` heading. Per-phase: `Pha
 
 ### 1. Load the plan
 
-<!-- if:local -->
-
-Read `.tracerkit/plans/<slug>.md`. If missing, list plans and ask the user to select one.
-
-<!-- end:local -->
-<!-- if:github -->
-
-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.
-
-<!-- end:github -->
+Read `.tracerkit/plans/<slug>.md`. If missing, list plans as numbered options and wait for the user's choice.
 
 ### 2. Load the PRD
 
-<!-- if:local -->
-
 Read source PRD referenced in plan header (`> Source PRD: ...`).
 
-<!-- end:local -->
-<!-- if:github -->
-
-Read source PRD issue referenced in plan body (`> Source PRD: #<number>`).
-
-<!-- end:github -->
-
 ### 3. Fast-path: check if implementation exists
 
 If primary module file(s) from Phase 1 don't exist, skip subagent — report `0/N — not yet started`, list Phase 1 done-when items, jump to Step 5.
@@ -108,17 +71,8 @@ Collect findings into two categories:
 
 ### 3c. Update checkboxes
 
-<!-- if:local -->
-
 Using the subagent's report, update each checkbox in `.tracerkit/plans/<slug>.md` to `[x]` or `[ ]`.
 
-<!-- end:local -->
-<!-- if:github -->
-
-Using the subagent's report, update each checkbox in the plan issue body to `[x]` or `[ ]` by editing the issue.
-
-<!-- end:github -->
-
 ### 4. Determine outcome
 
 Based on checks and findings, decide the status transition:
@@ -153,17 +107,8 @@ Total: checked/total
 
 ### 6. Stamp the plan
 
-<!-- if:local -->
-
 Append a verdict block at the bottom of `.tracerkit/plans/<slug>.md`:
 
-<!-- end:local -->
-<!-- if:github -->
-
-Append a verdict block at the bottom of the plan issue body by editing the issue:
-
-<!-- end:github -->
-
 ```markdown
 ---
 
@@ -181,24 +126,9 @@ If a previous verdict block exists, replace it with the new one.
 
 If all checks pass and zero BLOCKERS:
 
-<!-- if:local -->
-
 1. Update PRD frontmatter: `status: done`, add `completed: <UTC ISO 8601>`
 2. Update plan frontmatter: `status: done`, add `completed: <UTC ISO 8601>`
 
-<!-- end:local -->
-<!-- if:github -->
-
-1. If on a feature branch with commits ahead of default:
-   a. Push branch if not pushed
-   b. Open PR with `Closes #<prd-number>, Closes #<plan-number>` (or update existing PR body)
-2. Search merged PRs matching slug: `gh pr list --search <slug> --state merged` — add comment on PRD issue linking found PRs
-3. PRD issue: add `tk:done`, remove `tk:in-progress`, update metadata `status: done` + `completed` timestamp
-4. Close PRD issue (reason: `completed`)
-5. Close plan issue (reason: `completed`)
-
-<!-- end:github -->
-
 ### 8. On `in_progress` (no blockers)
 
 Show progress summary (checked/total per phase), list the next unchecked items to implement. Keep going.

package/skills/plan/SKILL.md

@@ -3,71 +3,39 @@ description: Turn a PRD into a multi-phase implementation plan using tracer-bull
 argument-hint: '[slug]'
 ---
 
-**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks.
-
 # PRD to Plan
 
 Break a PRD into phased vertical slices (tracer bullets).
 
 **Interactive prompts**: present options as a numbered list and wait for the user's choice.
 
-<!-- if:local -->
-
 Output: `.tracerkit/plans/<slug>.md`.
 
-<!-- end:local -->
-<!-- if:github -->
-
-Output: a GitHub Issue with label `{{github.labels.plan}}`.
-
-<!-- end:github -->
-
 ## Pre-loaded context
 
-<!-- if:local -->
-
 - Available PRDs: !`ls .tracerkit/prds/*.md 2>/dev/null || echo "(none)"`
-  <!-- end:local -->
-  <!-- if:github -->
-- Available PRDs: list open GitHub Issues with label `{{github.labels.prd}}`
-<!-- end:github -->
 
 ## Input
 
 The argument (if provided) is: $ARGUMENTS
 
-Use argument as `<slug>`. If empty, list available PRDs and ask the user to select one.
+Use argument as `<slug>`. If empty, list PRDs as numbered options and wait for the user's choice.
 
 ## Workflow
 
 ### 1. Read the PRD
 
-<!-- if:local -->
+Read `.tracerkit/prds/<slug>.md`. If missing, list PRDs as numbered options and wait for the user's choice.
 
-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".
+If `.tracerkit/plans/<slug>.md` exists, present options and wait:
 
-<!-- end:local -->
-<!-- if:github -->
-
-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".
-
-<!-- end:github -->
+1. Overwrite existing (Recommended)
+2. Pick a new name
 
 ### 1b. Update PRD status
 
-<!-- if:local -->
-
 Set `status: in_progress` in `.tracerkit/prds/<slug>.md` frontmatter. Change only `status`.
 
-<!-- end:local -->
-<!-- if:github -->
-
-Update the PRD issue:
-
-- Remove `tk:created` label, add `tk:in-progress` label
-- Update the `<!-- tk:metadata -->` comment in the issue body to `status: in_progress`
-<!-- end:github -->
-
 ### 2. Explore the codebase
 
 Map architecture, patterns, integration points. Skip if codebase context exists from prior step.
@@ -112,7 +80,9 @@ Each phase: thin vertical slice through all layers (schema → service → API
 
 - 1 module touched → 2–3 phases max
 - 2–3 modules touched → 3–5 phases max
-- 4+ modules or 6+ phases → stop and ask: "PRD touches 4+ modules. Split before planning?" with options: "Split the PRD" (Recommended) / "Continue anyway".
+- 4+ modules or 6+ phases → stop and present options:
+  1. Split the PRD (Recommended)
+  2. Continue anyway
 
 Count "modules touched" by scanning the PRD's New Modules and Schema Changes sections.
 
@@ -124,11 +94,15 @@ Assign an agent tag to tasks where appropriate:
 
 ### 5. Quiz the user
 
-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.
+Present breakdown (title, user stories covered, done-when per phase). Present options and wait:
 
-### 6. Save plan
+1. Looks good, proceed (Recommended)
+2. Merge some phases
+3. Split a phase
 
-<!-- if:local -->
+Iterate until approved.
+
+### 6. Save plan
 
 Save to `.tracerkit/plans/<slug>.md` (create dir if missing).
 
@@ -144,41 +118,7 @@ status: in_progress
 > Source PRD: `.tracerkit/prds/<slug>.md`
 ```
 
-Then update PRD frontmatter: add `plan: .tracerkit/plans/<slug>.md` field.
-
-<!-- end:local -->
-<!-- if:github -->
-
-Ensure labels exist: `gh label create {{github.labels.plan}} --force`, `gh label create tk:in-progress --force`.
-
-Create GitHub Issue — title: `[{{github.labels.plan}}] <slug>: Plan: <Feature Title>`, labels: `{{github.labels.plan}}`, `tk:in-progress`.
-
-```markdown
-<!-- tk:metadata
-source_prd: #<PRD issue number>
-slug: <slug>
-status: in_progress
--->
-
-# Plan: <Feature Name>
-
-> Source PRD: #<PRD issue number>
-```
-
-<!-- end:github -->
-
-### 6b. Backlink PRD
-
-<!-- if:local -->
-
-Already linked via PRD frontmatter `plan:` field (set in step 6).
-
-<!-- end:local -->
-<!-- if:github -->
-
-Add comment on PRD issue: "Plan: #<plan-issue-number>" (creates cross-reference).
-
-<!-- end:github -->
+Then update PRD frontmatter: add `plan: .tracerkit/plans/<slug>.md` field (creates backlink).
 
 Use this structure for the plan body:
 
@@ -217,25 +157,15 @@ Carried forward from PRD verbatim.
 Gaps found in the PRD needing resolution. Blank if none.
 ```
 
-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".
-
-## Execution guidance
-
-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.
+Print one line per phase: `Phase N — <title> (<condition summary>)`. Present options and wait:
 
-### During implementation
+1. Run `/tk:build <slug>` (Recommended)
+2. Run `/tk:check <slug>`
+3. Done for now
 
-Mark each "Done when" checkbox `[x]` **immediately after verifying** the condition.
-
-Always update the local plan file (`.tracerkit/plans/<slug>.md`): change `- [ ]` → `- [x]`. This file is the working copy for both local and GitHub modes.
-
-<!-- if:github -->
-
-**Sync to GitHub at phase boundaries**: after completing all items in a phase, update the plan issue body with `gh issue edit` to reflect the local state. This avoids per-item API calls.
-
-After all phases, open a PR with body containing `Closes #<prd-issue>, Closes #<plan-issue>`.
+## Execution guidance
 
-<!-- end:github -->
+To implement this plan phase by phase, run `/tk:build <slug>`. It handles branch creation, implementation, feedback loops, checkbox marking, and commits — one phase per invocation.
 
 ## Rules
 
@@ -243,10 +173,5 @@ After all phases, open a PR with body containing `Closes #<prd-issue>, Closes #<
 - Each phase must be demoable end-to-end on its own
 - "Done when" must be a checkbox list of testable conditions, not prose
 - **Safety valve**: if a phase has >5 "Done when" items, stop and split it into smaller phases before continuing
-<!-- if:local -->
 - Never modify the source PRD content — only update frontmatter status fields
-  <!-- end:local -->
-  <!-- if:github -->
-- Never modify the source PRD content — only update metadata and labels
-<!-- end:github -->
 - Carry PRD's Out of Scope forward verbatim

package/skills/prd/SKILL.md

@@ -3,8 +3,6 @@ description: Create a PRD through user interview, codebase exploration, and modu
 argument-hint: <idea>
 ---
 
-**Config**: read `.tracerkit/config.json` (default: `local`). Follow matching `<!-- if:local/github -->` blocks.
-
 # PRD Writing
 
 Skip satisfied steps. If argument provided, skip to Step 2.
@@ -13,13 +11,7 @@ Skip satisfied steps. If argument provided, skip to Step 2.
 
 ## Pre-loaded context
 
-<!-- if:local -->
-
 - Existing PRDs: !`ls .tracerkit/prds/*.md 2>/dev/null || echo "(none)"`
-  <!-- end:local -->
-  <!-- if:github -->
-- Existing PRDs: list open GitHub Issues with label `{{github.labels.prd}}`
-<!-- end:github -->
 
 ## Input
 
@@ -34,16 +26,10 @@ If empty, go to Step 1; derive slug after gathering the idea. If provided, deriv
 5. Take the first 4 remaining words (or fewer if less exist)
 6. Join with hyphens → `<slug>`
 
-<!-- if:local -->
-
-Output: `.tracerkit/prds/<slug>.md`. If exists, ask: "Overwrite existing" / "Pick a new name".
-
-<!-- end:local -->
-<!-- if:github -->
-
-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".
+Output: `.tracerkit/prds/<slug>.md`. If file exists, present options and wait:
 
-<!-- end:github -->
+1. Overwrite existing (Recommended)
+2. Pick a new name
 
 ## Workflow
 
@@ -85,8 +71,6 @@ Present modules. Confirm which need tests.
 
 ### 5. Write PRD
 
-<!-- if:local -->
-
 Save to `.tracerkit/prds/<slug>.md` (create dir if missing).
 
 ```markdown
@@ -98,26 +82,7 @@ status: created
 # Feature Name
 ```
 
-<!-- end:local -->
-<!-- if:github -->
-
-Ensure labels exist: `gh label create {{github.labels.prd}} --force`, `gh label create tk:created --force`.
-
-Create GitHub Issue — title: `[{{github.labels.prd}}] <slug>: <Feature Title>`, labels: `{{github.labels.prd}}`, `tk:created`.
-
-```markdown
-<!-- tk:metadata
-slug: <slug>
-created: <UTC ISO 8601>
-status: created
--->
-
-# Feature Name
-```
-
-<!-- end:github -->
-
-PRD body structure (same for local file and issue body). Omit empty sections. No file paths or code snippets.
+PRD body structure. Omit empty sections. No file paths or code snippets.
 
 ```
 ## Problem Statement
@@ -136,4 +101,7 @@ PRD body structure (same for local file and issue body). Omit empty sections. No
 
 ---
 
-Then ask: "What's next?" with options: "Run `/tk:plan <slug>`" (Recommended) / "Done for now".
+Present options and wait for the user's choice:
+
+1. Run `/tk:plan <slug>` (Recommended)
+2. Done for now