tracerkit

Category: Tools & Productivity | Uploader: helderberto | Downloads: 0 | Version: v1.0（Latest）

Session briefing — shows active features, progress, and suggested focus. Use at the start of a session to orient.

Changelog: Source: GitHub https://github.com/helderberto/tracerkit

Directory Structure

Current level: tree/main/templates/.claude/skills/tk:brief/

📄 SKILL.md 2.3 KB

SKILL.md

---
description: Session briefing — shows active features, progress, and suggested focus. Use at the start of a session to orient.
---

# Session Briefing

Get a quick overview of all active features, their progress, and what to focus on next.

## Pre-loaded context

- Available PRDs: !`ls {{paths.prds}}/ 2>&1`

## Algorithm

Follow these steps exactly to build the briefing table:

### 1. Discover features

For each `.md` file in `{{paths.prds}}/`:

1. Read the file
2. Parse YAML frontmatter (the block between `---` fences at the top)
3. Extract `status` and `created` fields
4. Skip files where `status: done`
5. The slug is the filename without `.md`

### 2. Count progress from plans

For each slug, check if `{{paths.plans}}/<slug>.md` exists. If it does:

1. Read the plan file
2. Find every `## Phase N` heading (regex: `^## Phase \d+`)
3. Within each phase section (until the next `## ` heading), count:
   - Checked items: lines matching `^- \[x\] ` (case-insensitive)
   - Unchecked items: lines matching `^- \[ \] `
4. Sum checked and total across all phases → `checked/total`
5. Find the first unchecked item (`^- \[ \] (.+)`) in the entire plan — that's the "Next" value. Strip any trailing `[tag]` markers.

If no plan exists, progress is `—` and next is `—`.

### 3. Build the table

Sort features by `created` date ascending (no-date entries last). Calculate age from `created`:

- < 7 days → `Nd` (e.g. `3d`)
- < 30 days → `Nw` (e.g. `2w`)
- 30+ days → `Nmo` (e.g. `1mo`)

Output this exact table format:

```
| Feature | Status | Age | Progress | Next |
|---------|--------|-----|----------|------|
| <slug>  | <status> | <age> | <checked>/<total> | <next item> |
```

If no features found, output: `No features found — run /tk:prd to start one.`

### 4. Determine focus

Apply these rules in order:

1. Exactly 1 feature with `status: in_progress` → auto-select it
2. Multiple `in_progress` features → select the oldest by `created`
3. Zero `in_progress` features → select the oldest overall

Append below the table:

```
**Focus → <slug>**
```

### 5. Offer next steps

Ask the user what they'd like to do:

- Continue the focused feature (read its plan at `{{paths.plans}}/<slug>.md`)
- Start a new feature with `/tk:prd`
- Check progress on a feature with `/tk:check <slug>`

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

tracerkit

Directory Structure

SKILL.md

Report

Notice