claude-code-ultimate-guide/quiz

Claude Code Knowledge Quiz

Test your understanding of Claude Code with interactive multiple-choice questions.

Quick Start

# Navigate to quiz directory
cd quiz

# Install dependencies
npm install

# Run the quiz
npm start

# Or run directly
node src/index.js

Features

• 4 User Profiles: Junior, Senior, Power User, Product Manager
• 10 Topic Categories: From Quick Start to Advanced Patterns
• 159 Curated Questions: Practical knowledge, not trivia
• Immediate Feedback: Learn from mistakes with explanations
• Documentation Links: Direct references to guide sections
• Score Tracking: See strengths and weak areas
• Session Persistence: History saved to ~/.claude-quiz/
• Cross-Platform: Works on macOS, Linux, and Windows

Usage

Interactive Mode (Recommended)

npm start

You'll be prompted to:

1. Select your profile (Junior/Senior/Power User/PM)
2. Choose topics (all or specific sections)
3. Answer questions with A/B/C/D

Command Line Options

node src/index.js [options]

Options:
  -p, --profile <type>   Pre-select profile (junior|senior|power|pm)
  -t, --topics <list>    Quiz specific sections (1-10, comma-separated)
  -c, --count <n>        Limit number of questions (1-50)
  -d, --dynamic          Enable dynamic question generation via claude -p
  -h, --help             Show help message
  -v, --version          Show version

Examples

# Interactive mode
npm start

# Senior profile, default topics
node src/index.js -p senior

# Power user, specific topics (Agents, Hooks, MCP)
node src/index.js -p power -t 4,7,8

# Quick 10-question quiz
node src/index.js -c 10

# Junior profile with dynamic generation
node src/index.js -p junior -d

Example Session

Here's what a typical quiz session looks like:

============================================================
   CLAUDE CODE KNOWLEDGE QUIZ
   Master Claude Code: The Complete Guide
============================================================

? Select your profile: Senior Developer (40 min to mastery)
? Select topics to quiz: Custom selection...
? Select topics (space to toggle, enter to confirm):
  ◉ [2] Core Concepts
  ◉ [4] Agents
  ◉ [7] Hooks

------------------------------------------------------------
Starting quiz: 20 questions for senior profile
------------------------------------------------------------

------------------------------------------------------------
Question 1/20 [Core Concepts]

At what context percentage should you use /compact?

  A) 0-50%
  B) 50-70%
  C) 70-90%
  D) Only at 100%

? Your answer: C

✓ CORRECT!

Progress: █░░░░░░░░░░░░░░░░░░░ 1/20 | Score: 1/1 (100%)

------------------------------------------------------------
Question 2/20 [Hooks]

What exit code should a PreToolUse hook return to BLOCK an operation?

  A) 0
  B) 1
  C) 2
  D) -1

? Your answer: A

✗ INCORRECT. The correct answer is C) 2

Explanation:
Exit code 2 blocks the operation. Exit code 0 allows it to proceed.
Other exit codes are treated as errors and logged but don't block.

See: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/blob/main/guide/ultimate-guide.md#72-creating-hooks
     (Line 4164)

Progress: ██░░░░░░░░░░░░░░░░░░ 2/20 | Score: 1/2 (50%)
? Continue to next question? Yes

... (more questions) ...

============================================================
   QUIZ COMPLETE
============================================================

Overall Score: 16/20 (80%)

By Category:
  Core Concepts       6/7  (86%)  [████████░░]
  Agents              5/7  (71%)  [███████░░░]
  Hooks               5/6  (83%)  [████████░░]

Weak Areas (< 75%):
  - Agents: Review section 4 in the guide

Recommended Reading:
  4. guide/ultimate-guide.md#4-agents

Time: 9 minutes 2 seconds

------------------------------------------------------------
? What would you like to do? (Use arrow keys)
❯ Retry wrong questions only
  New quiz (different questions)
  Exit

Profiles

Profile	Questions	Focus Areas
Junior Developer	15	Sections 1-3, 6 (essentials)
Senior Developer	20	Sections 2-4, 7, 9 (architecture, automation)
Power User	25	All sections
Product Manager	10	Sections 1-3 (conceptual overview)

Topics

#	Topic	Key Concepts
1	Quick Start & Installation	Installation, first workflow, essential commands
2	Core Concepts	Context management, Plan Mode, interaction loop
3	Memory & Settings	CLAUDE.md, .claude/ folder, permissions
4	Agents	Custom agents, specialization, orchestration
5	Skills	Reusable knowledge, skill composition
6	Commands	Slash commands, custom commands
7	Hooks	Event system, security hooks, exit codes
8	MCP Servers	Context7, Serena, Sequential, plugins
9	Advanced Patterns	The Trinity, CI/CD, composition
10	Reference	Shortcuts, troubleshooting, daily workflow

Quiz Flow

┌─────────────────────────────────────────────┐
│          CLAUDE CODE KNOWLEDGE QUIZ         │
└─────────────────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────┐
│  Select Profile (Junior/Senior/Power/PM)    │
└─────────────────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────┐
│  Select Topics (All or Specific 1-10)       │
└─────────────────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────┐
│  Question 1/20 [Category]                   │
│                                             │
│  What is the recommended action when...?    │
│                                             │
│    A) Option A                              │
│    B) Option B                              │
│    C) Option C                              │
│    D) Option D                              │
└─────────────────────────────────────────────┘
                     │
            ┌────────┴────────┐
            ▼                 ▼
     ┌──────────┐      ┌──────────────────┐
     │ CORRECT! │      │ INCORRECT        │
     │          │      │ Correct: C       │
     │          │      │ Explanation...   │
     │          │      │ See: guide#...   │
     └──────────┘      └──────────────────┘
            │                 │
            └────────┬────────┘
                     ▼
              (Next Question)
                     │
                     ▼
┌─────────────────────────────────────────────┐
│           QUIZ COMPLETE                     │
│                                             │
│  Overall Score: 16/20 (80%)                 │
│                                             │
│  By Category:                               │
│    Core Concepts:  6/7  (86%)  [████████░░] │
│    Agents:         5/7  (71%)  [███████░░░] │
│    Hooks:          5/6  (83%)  [████████░░] │
│                                             │
│  Weak Areas: Agents (review section 4)      │
└─────────────────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────┐
│  [R] Retry wrong questions only             │
│  [N] New quiz (different questions)         │
│  [E] Exit                                   │
└─────────────────────────────────────────────┘

Session Persistence

Quiz sessions are automatically saved to ~/.claude-quiz/:

~/.claude-quiz/
  sessions/
    2026-01-12_143052.json   # Individual session data
    2026-01-12_150623.json
  stats.json                  # Aggregate statistics

Session Data Includes:

• Profile and topics selected
• Questions answered (correct/incorrect/skipped)
• Time taken
• Category breakdown
• Wrong questions with correct answers

Dynamic Question Generation

When the --dynamic flag is enabled and the Claude CLI is installed, the quiz can generate additional questions on-the-fly using claude -p:

node src/index.js -d

This requires:

• Claude CLI installed (npm install -g @anthropic-ai/claude-code)
• Active API key configured

Dynamic questions supplement the static pool when:

• Static pool is exhausted for selected topics
• User requests fresh questions
• Variety is needed for repeated quizzes

Contributing Questions

We welcome question contributions! See templates/question-template.yaml for the format.

Quality Guidelines

Good questions test:

• Practical application ("When should you...")
• Decision-making ("Which approach is best for...")
• Understanding ("Why does Claude...")
• Troubleshooting ("What would you do if...")

Avoid:

• Trivia ("What is the exact command syntax...")
• Pure memorization ("List all keyboard shortcuts...")
• Version-specific details that may change

Submitting Questions

1. Fork the repository
2. Add questions to the appropriate questions/XX-category.yaml file
3. Follow the template format exactly
4. Ensure doc_reference points to valid sections
5. Submit a PR with description of added questions

Troubleshooting

"No questions available"

• Check that selected topics have questions in questions/ directory
• Verify YAML files are valid (use a YAML validator)
• Try selecting different topics or "All topics"

"Cannot find module 'yaml'"

cd quiz
npm install

Quiz hangs on input

• Ensure you're running in an interactive terminal
• Try pressing Enter if stuck
• Use Ctrl+C to exit and restart

License

Same as parent repository: CC BY-SA 4.0

---

Part of: claude-code-ultimate-guide