Session Workflow Skill

Session Start Checklist

Task Progress:
- [ ] Step 1: Verify workspace
- [ ] Step 2: Check git status
- [ ] Step 3: Review TASKS.md priorities
- [ ] Step 4: Check claude-mem status
- [ ] Step 5: Validate API keys & services
- [ ] Step 6: Verify dev server (if needed)

Step 1: Verify Workspace

bash
1# Confirm correct workspace
2pwd
3# Expected: /Users/charleymm/Projects/leo-participation-translator
4
5# Verify it's the right project
6ls CLAUDE.md PLAN.md TASKS.md

Step 2: Check Git Status

bash
1git status
2git fetch origin main
3git log HEAD..origin/main --oneline  # Check if behind

Step 3: Review Priorities

Read TASKS.md to identify current priorities and in-progress tasks.

Step 4: Check Claude-Mem

bash
1curl -s http://127.0.0.1:37777/api/readiness
2# Expected: {"status":"ready","mcpReady":true}

Step 5: Validate API Keys & Services

Run these checks to verify all external dependencies are healthy:

bash
1# --- GCP Authentication ---
2gcloud auth application-default print-access-token > /dev/null 2>&1 \
3  && echo "✅ GCP auth valid" || echo "❌ GCP auth expired — run: gcloud auth login --update-adc"
4
5# --- Exa.ai API Key ---
6EXA_KEY=$(grep "EXA_API_KEY" app/.env.local | cut -d'=' -f2)
7EXA_STATUS=$(curl -s -o /dev/null -w "%{http_code}" -X POST "https://api.exa.ai/search" \
8  -H "Content-Type: application/json" -H "x-api-key: $EXA_KEY" \
9  -d '{"query":"test","numResults":1}')
10[ "$EXA_STATUS" = "200" ] && echo "✅ Exa.ai key valid" || echo "❌ Exa.ai key INVALID ($EXA_STATUS) — rotate at dashboard.exa.ai"
11
12# --- Tavily API Key ---
13TAVILY_KEY=$(grep "TAVILY_API_KEY" app/.env.local | cut -d'=' -f2)
14TAVILY_STATUS=$(curl -s -o /dev/null -w "%{http_code}" -X POST "https://api.tavily.com/search" \
15  -H "Content-Type: application/json" \
16  -d "{\"api_key\":\"$TAVILY_KEY\",\"query\":\"test\",\"max_results\":1}")
17[ "$TAVILY_STATUS" = "200" ] && echo "✅ Tavily key valid" || echo "❌ Tavily key INVALID ($TAVILY_STATUS) — check app.tavily.com"
18
19# --- Anthropic API Key ---
20ANTHROPIC_KEY=$(grep "ANTHROPIC_API_KEY" app/.env.local | cut -d'=' -f2)
21ANTHROPIC_STATUS=$(curl -s -o /dev/null -w "%{http_code}" "https://api.anthropic.com/v1/models" \
22  -H "x-api-key: $ANTHROPIC_KEY" -H "anthropic-version: 2023-06-01")
23[ "$ANTHROPIC_STATUS" = "200" ] && echo "✅ Anthropic key valid" || echo "❌ Anthropic key INVALID ($ANTHROPIC_STATUS)"
24
25# --- Cloud Run (production) ---
26PROD_STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
27  "https://participation-translator-897334523591.us-central1.run.app/login")
28[ "$PROD_STATUS" = "200" ] && echo "✅ Cloud Run healthy" || echo "❌ Cloud Run issue ($PROD_STATUS)"

Step 6: Verify Dev Server (if needed)

bash
1cd app && npx next dev --port 3005
2# Verify: curl -s -o /dev/null -w "%{http_code}" http://localhost:3005/api/stats

Session End Checklist

Task Progress:
- [ ] Step 1: Update TASKS.md
- [ ] Step 2: Create session log
- [ ] Step 3: Commit changes
- [ ] Step 4: Push to remote
- [ ] Step 5: Create handoff

Step 1: Update TASKS.md

Mark completed tasks, update progress percentages.

Step 2: Create Session Log

Create sessions/SESSION_{DATE}_{VERSION}.md:

markdown
1# Session Summary: Participation Translator vX.X.X
2
3**Date:** YYYY-MM-DD
4**Duration:** X hours
5
6## What Was Done
7
8- [Key accomplishment 1]
9- [Key accomplishment 2]
10
11## Files Changed
12
13- `file1.ts` - Description
14- `file2.md` - Description
15
16## Next Steps
17
181. [Priority task 1]
192. [Priority task 2]

Step 3: Commit Changes

bash
1git add -A
2git commit -m "feat(vX.X.X): brief description of changes"

Step 4: Push to Remote

bash
1# Archive remote first if it has diverged
2git fetch origin main
3git log HEAD..origin/main --oneline
4# If empty, safe to push
5git push origin main

Step 5: Create Handoff

Provide handoff summary in conversation:

## Participation Translator Handoff

**Session End**: {datetime}
**Version**: {version}

### What Was Done
- [Key items]

### Current State
- Git: Clean/Dirty
- Phase: 0/1/2/etc

### Next Steps
1. [Priority 1]
2. [Priority 2]

### Quick Commands
npm run dev
npm test

Quick Reference Commands

Author: Charley Scholz, JLAI Co-authored: Claude Opus 4.6, Cursor (IDE) Last Updated: 2026-02-13