Storytime

A continuity system for LLM–harness collaboration. Builds technical specifications through structured persona conversations — and carries session state across compactions, sessions, and time.

$ claude install-plugin ~/workspace/storytime

or per-session: claude --plugin-dir ~/workspace/storytime

How It Works

Describe a problem. Storytime surveys your codebase, assembles a team of domain-expert personas, and runs a structured conversation that produces a plan — grounded in your actual code, with citations, decisions, and visual aids. Underneath the spec workflow is a consolidation loop that preserves continuity across compactions and sessions.

0 Survey
1 Assemble
2 Icebreaker
3 Breakout
Pause
4 Converge
5 Review

Phases collapse when empty. Not every run uses every gear. See a full walkthrough →

/storytime "our public API has no rate limiting and we're getting abuse"

Storytime surveys your code, finds the Express middleware chain has no
throttling layer. Assembles @owner [anchor], @systems [lattice],
@critic [forge], @operator [tide]. They investigate, and produce:

  specs/.storytime/sessions/rate-limiting/001/
  ├── survey.md          Codebase context + fingerprint
  ├── team.md            Persona definitions
  ├── icebreaker.md      Status quo discussion
  ├── breakout-algo.md   Token bucket vs sliding window
  ├── breakout-store.md  Redis vs in-memory for counters
  └── plan.md            ASCII slide deck + implementation steps

Key Concepts

Consolidation
The core loop. Context → consolidation events → document structure → continuity. Six scales: phase, commit, nap, shift, session, compact. The spec workflow is one surface on this loop. /storytime-remember stages remembrance before /compact.
Personas
Domain-expert lenses with non-human codenames (anchor, lattice, kestrel). Default core: OWNER, OPERATOR, CRITIC ×2. One driver per leg — supporters stay silent unless useful AND non-distortive. @role is a lens directive, not just a skill trigger.
Remembrance
A workday-shaped wakeup document + consolidation prompt, staged before /compact and loaded as the first action post-compact. Carries session state across context boundaries. Written at pauses and pre-compact.
Decisions & Callouts
Append-only, numbered per topic (RATE-001), pinned to commits, stored in per-topic threads (not a separate file). Cross-topic references use Callout-> / Callout<- sigil lines — forward authoritative, reverse is lint-cached.
Episodes & Threads
Sessions are chapters. _thread.md is the continuity ledger — decisions, consolidation log, open questions. Park mid-session and resume with full context.
Dreams
Optional, ancillary, disablable. Per-commit side artifacts capturing hunches, noticed-but-not-said observations, and daydream design material. Not on the critical path — just accumulated hunch value over time.

All 19 Skills

Core Workflow

SkillDescription
/storytimeFull workflow: survey, team, icebreaker, breakouts, plan
/storytime-surveyStandalone codebase survey with artifact inventory
/storytime-breakoutFocused investigation with one driver + silent supporters
/storytime-convergeMerge breakout results into a unified plan
/storytime-buildoutImplement the plan with persona-driven pair programming
/storytime-retroRetrospective: plan vs what was built + evaluation scorecard

Team & QA

SkillDescription
/storytime-cohortHire, fire, bench, promote, evolve personas
/storytime-qaFormal queries to personas about past decisions (context-loaded)
/storytime-echoOne-shot spawning-pool voice test (ephemeral, no state)
/storytime-pr-qaTeam handles PR review comments

Continuity & Control

SkillDescription
/storytime-rememberStage remembrance for /compact (wakeup document + prompt)
/storytime-lintMechanical + reasoning-tier validation against process rules
/storytime-bootstrapInitialize .storytime/ in a repo
/storytime-consolidateOrganize, archive, roll up documents
/storytime-absorbTeam reads and interprets existing docs
/storytime-exportConvert to ADRs, issues, Kiro specs
/storytime-statusDashboard: cohort, threads, decisions, tutorial progress
/storytime-undoRevert: phase, episode, thread, or file

When To Use It

Feature Design

"We need rate limiting on the API"

Architecture Decisions

"Should we split this service?"

Bug Investigation

"Webhooks are silently failing"

Refactoring

"The auth middleware needs a rewrite"

Onboarding

"How did this system get here?"

Post-Implementation

"Did the plan match what we built?"