ultrawork-quiz

Ultrawork Quiz Command

Overview

Test knowledge gained during ultrawork sessions. Quiz focuses on learnings and discoveries from codebase exploration, design decisions, and technical patterns, NOT mechanical facts the user already knows.

Session ID Handling

The session_id is provided by the hook via systemMessage as CLAUDE_SESSION_ID. You MUST pass it to scripts via --session flag.

Options

Option	Default	Description
--count N	5	Number of quiz questions
--session ID	current	Session to quiz on (uses CLAUDE_SESSION_ID if omitted)

Quiz Data Sources

Priority Order

1. exploration/*.md (High priority)

   • Tech stack discoveries
   • Architecture patterns
   • Naming conventions
   • Framework/library usage

2. docs/plans/*.md (High priority)

   • Design rationale
   • Approach comparisons
   • Decision reasoning
   • Trade-off analysis

3. tasks/*.json criteria (Medium priority)

   • Verification methods
   • Test commands
   • Success patterns

4. evidence_log (Low priority)

   • Tools/commands actually used
   • Test execution patterns

What to Include

✅ Focus on learnings:

• "What scripting runtime was discovered?" (Bun)
• "Why was approach X chosen over Y?" (Design rationale)
• "What naming convention is used for components?" (Pattern)
• "Which framework does this project use?" (Tech stack)

❌ Exclude mechanical facts:

• Session goal (user already knows)
• Task names/completion status (not a learning)
• "Was file X modified?" (not discovery)

Workflow

Phase 1: Parse Arguments

# Parse --count and --session from user input
# Default count: 5
# Default session: CLAUDE_SESSION_ID

Phase 2: Read Session Data

# Get session metadata
bun "${CLAUDE_PLUGIN_ROOT}/src/scripts/session-get.js" --session ${SESSION_ID} --field working_dir

# Get session directory
SESSION_DIR=~/.claude/ultrawork/sessions/${SESSION_ID}

Phase 3: Collect Quiz Content