synthesize

Process pending transcripts, classify insights, and route them to the right layer: project .brain/ docs, personal ~/brain/atoms/, and optional team vault.

Batch limit: process at most 20 sessions per run. If the queue is larger, process the first 20, then report how many remain.

Steps

1. Read config and pending queue

cat ~/.claude/brain/config.json
cat ~/.claude/brain/pending.json

If pending.json is missing or empty, say "No pending sessions." and stop.

If the queue has more than 20 items: "Queue has N sessions — processing first 20. Run /synthesize again for the remainder." Take only the first 20 paths as the working set.

2. For each transcript path in the queue

a. Extract transcript metadata:

python3 -c "
import sys; sys.path.insert(0, '${CLAUDE_PLUGIN_ROOT}/bin')
import synthesize, json
sid, slug, msgs, date = synthesize.parse_transcript('<transcript_path>')
idx = synthesize.read_sessions_index('<transcript_path>')
print(json.dumps({
  'session_id': sid,
  'project_name': synthesize.project_name_from_slug(slug, idx.get('projectPath', '')),
  'project_path': idx.get('projectPath', ''),
  'user_messages': msgs,
  'session_date': date.isoformat(),
  'message_count': idx.get('messageCount', '?'),
  'first_prompt': idx.get('firstPrompt', ''),
  'git_branch': idx.get('gitBranch', '')
}))
"

b. Check idempotency — skip if already processed:

grep -rl "<!-- session:<session_id> -->" ~/brain/_sessions/ 2>/dev/null

If found, skip this transcript.

c. Read Polaris context (if vault configured):

cat ~/brain/Polaris/top-of-mind.md 2>/dev/null

d. Synthesize — produce a Knowledge JSON object based on user_messages, first_prompt, project_name, git_branch, and top-of-mind content:

{
  "summary": "1-2 sentence summary of what happened",
  "outcome": "done | in_progress | blocked",
  "suggested_next": "what to do next",
  "primary_theme": "building | debugging | researching | planning | configuring",
  "knowledge": [
    {
      "destination": "project | personal | team",
      "format": "decision | gotcha | pattern | insight",
      "title": "Short title (5-10 words)",
      "content": "Detailed explanation with context and rationale"
    }
  ]
}