thoughtbox:session-review

Thoughtbox Session Review

Sessions are write-once without review. This skill turns completed sessions into reusable knowledge by identifying what worked, what didn't, and what to carry forward.

Workflow

Phase 1: Retrieve and Measure

Find the session and get structural metrics:

// thoughtbox_execute — find the session
async () => {
  // By ID:
  const session = await tb.session.get("session-uuid");
  // Or find latest:
  const list = await tb.session.list({ limit: 1 });
  return list;
}

// Get structural metrics
async () => {
  const analysis = await tb.session.analyze("session-uuid");
  return analysis;
  // Returns: linearityScore, revisionRate, maxDepth, thoughtDensity,
  //          critiqueRequests, hasConvergence, isComplete
}

Interpret the metrics:

Metric	High value means	Look for
revisionRate > 0.15	Many course corrections	Anti-patterns — what kept going wrong?
linearityScore < 0.7	Heavy branching	Exploration strategies — were branches productive?
hasConvergence = true	Branches resolved	Decision patterns — how was the choice made?
isComplete = false	Session abandoned	Why? Context loss? Stuck? Deprioritized?

Phase 2: Identify Key Moments

Retrieve the full session and scan for signal thoughts:

async () => {
  const session = await tb.session.get("session-uuid");
  return session.thoughts;
}

Scan for these moment types:

• Pivots — reasoning direction changed. Look for: "actually", "wait", "on second thought", significant topic shift
• Decisions — uncertainty resolved. Look for: "choosing", "decided", "going with", comparison conclusions
• Insights — synthesis occurred. Look for: "this means", "the pattern is", "I see now", connections between ideas
• Revisions — corrections made. Check isRevision: true field
• Branch points — exploration diverged. Check branchFromThought field