bryce-labs

bryce-labs-toolkit

A collection of reusable Claude Code skills, tools, and templates for AI-assisted development workflows.

Why This Exists

Claude Code writes detailed JSONL session transcripts for every interaction — messages, tool calls, token usage, decisions. These files accumulate in ~/.claude/projects/ but nobody reads them. This toolkit's session analysis skills make that data actionable: post-session QA, cost tracking, pattern mining, and lesson extraction.

Beyond session analysis, the toolkit includes skills for branch cleanup, story mining, and a spec-driven development plugin.

What's Included

Plugins

• spec-workflow — Spec-driven development with automated review loops (Specification → Planning → Implementation → Review)

Skills

Session Analysis Suite

• session-reviewer — Post-session QA: extracts all file writes from the most recent session and checks them against project invariants and universal safety rules. Reports CRITICAL/WARNING/INFO findings with a SAFE/NEEDS REVIEW/BLOCKED verdict.
• cost-tracker — Token usage and cost analysis across sessions. Produces per-session, per-project, and per-model breakdowns with efficiency metrics (cache hit rate, tokens per turn).
• transcript-miner — Pattern extraction across session history. Four modes: prompt pattern analysis, config evolution tracking, decision archaeology, and recurring mistake detection.

Other Skills

• cleanup — Post-merge git branch cleanup with safety checks, auto-detected base branch, and squash-merge support
• lessons-extractor — Extract lessons learned from Claude Code session logs into organized markdown and JSONL files
• story-miner — Mine Claude Code session history for publishable development stories

Tools

• parse-transcripts — Parse Claude Code JSONL session transcripts (CLI + importable Node.js module)
• skills-sync — Install and update skills to target projects (cross-platform wrappers included)
• lint-skills — Lint skills for Windows-unsafe patterns
• spec-workflow-reset — Reset spec-workflow artifacts
• story-miner-reset — Reset story-miner output artifacts
• lessons-extractor-reset — Reset lessons-extractor output artifacts
• spec-workflow-dev-sync — Sync plugin edits to Claude Code cache

Slash Commands

Command	Skill	What It Does
/review-session	session-reviewer	QA the most recent session's file writes
/cost-report	cost-tracker	Analyze token costs across last 20 sessions
/mine-sessions	transcript-miner	Extract patterns from session history

Quick Start

# Clone the repo
git clone https://github.com/BryceEWatson/bryce-labs-toolkit.git
cd bryce-labs-toolkit

# List available skills
./tools/skills-sync --list

# Install session analysis skills to your project
./tools/skills-sync --project /path/to/your-project --skill session-reviewer
./tools/skills-sync --project /path/to/your-project --skill cost-tracker
./tools/skills-sync --project /path/to/your-project --skill transcript-miner

# Test the parser on your sessions
node tools/parse-transcripts.js --list
node tools/parse-transcripts.js --recent 5 --mode summary

# Run the test suite
node tests/test-parser.js

# Use slash commands in Claude Code
# /review-session
# /cost-report
# /mine-sessions decisions

On Windows (CMD/PowerShell):

tools\skills-sync.cmd --list
tools\parse-transcripts.cmd --list

How Session Storage Works

All session types (CLI, VS Code, Desktop, Cowork) write JSONL transcripts to:

~/.claude/projects/<encoded-project-path>/sessions/<uuid>.jsonl   (newer)
~/.claude/projects/<encoded-project-path>/<uuid>.jsonl             (older)

The path encoding replaces / with - (e.g., /home/user/myapp → -home-user-myapp). On Windows, C:\Users\Bryce\Projects\foo becomes c--Users-Bryce-Projects-foo.

On Windows, the base may be %APPDATA%/Claude/ instead of ~/.claude/.

Important: The directories local-agent-mode-sessions/ and claude-code-sessions/ contain session registry files for the Desktop sidebar — they do NOT contain JSONL transcripts.

Install Plugins

Plugins are installed via the Claude Code marketplace:

# Add the marketplace source (one-time)
/plugin marketplace add BryceEWatson/bryce-labs-toolkit

# Install a plugin
/plugin install spec-workflow@bryce-labs

Install Skills

Using skills-sync (Recommended)

# Install a single skill
./tools/skills-sync --project /path/to/your-project --skill lessons-extractor