Workthreads

A lead needs a weekly answer across the team's repos: what work happened this week, what got finished, and what is still open and needs a next step. Workthreads produces that rollup from SpecStory histories - the .specstory/history transcripts your coding agents already write. It reports lines of work and their lifecycle (new / open / recently closed).

A deterministic engine (scripts/workthreads.mjs threads) does the retrieval, clustering, and classification; you do the synthesis - you turn its evidence into the lead's weekly report. Do not try to read raw transcripts yourself; they can be hundreds of thousands of lines. Run the engine and write the rollup from its output.

This skill is harness-portable (agentskills.io format). Where it names a specific tool (e.g. AskUserQuestion), treat that as "use your harness's equivalent; fall back to plain chat."

How the engine splits the work

• The engine groups the window's beats by project and clusters them into threads (a line of work that can span several sessions). It assigns each thread one lifecycle status relative to today:
  • new - first activity within the last 7 days.
  • open - unresolved, still active (the open loops).
  • closed - latest outcome was success and the thread has gone quiet; flagged reverted when a beat ran a rollback command (git revert / git reset --hard / git checkout -- ...).
• Output is deterministic (stable sort, no wall-clock timestamps in the body), so two runs on the same corpus are byte-identical.

Default flow: the weekly rollup

1. Index the corpus into workthreads' own DB. Point at the team's repos and build/update it:

   node "${CLAUDE_SKILL_DIR}/scripts/workthreads.mjs" index --projects <parent-of-repos> --db <db>
   # or a single tree:  --scan <root>     or a single history dir:  --dir <dir>