claude-code-ultimate-guide/quiz/templates/question-template.yaml
Florian BRUNIAUX bc07651cdf refactor: restructure repo into thematic directories v3.1.0
Major repository reorganization for improved navigation:

New directory structure:
- guide/ - Core documentation (ultimate-guide, cheatsheet, adoption)
- tools/ - Interactive utilities (audit, onboarding, mobile-access)
- machine-readable/ - LLM/AI consumption (reference.yaml, llms.txt)
- exports/ - Generated outputs (PDFs)

Changes:
- Move 10 files to thematic directories with cleaner names
- Create README.md index for each new directory
- Update 150+ internal links across all documentation
- Add "Repository Structure" section to main README
- Remove redundant npm install command from README header
- Remove unverified cost estimate from prerequisites
- Fix broken anchor link (#-quick-start-15-minutes)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 15:30:02 +01:00

56 lines
2.4 KiB
YAML

# Question Template for Claude Code Knowledge Quiz
#
# Use this template to contribute new questions to the quiz.
# Submit as a PR to: https://github.com/FlorianBruniaux/claude-code-ultimate-guide
#
# Guidelines:
# - Test practical understanding, not memorization
# - Make distractors plausible but clearly distinguishable
# - Explanations should teach, not just state the correct answer
# - Reference accurate sections from the guide
#
# Difficulty levels:
# - junior: Basic commands, installation, simple concepts
# - senior: Context management, configuration patterns, agent design
# - power: Advanced orchestration, Trinity pattern, optimization
#
# Profile visibility:
# - junior: Questions for new users (Day 1)
# - senior: Questions for experienced developers (Week 1-2)
# - power: Questions for advanced users (Month 1+)
# - pm: Conceptual questions for non-technical stakeholders
category: "Category Name" # One of: Quick Start, Core Concepts, Memory & Settings, Agents, Skills, Commands, Hooks, MCP Servers, Advanced Patterns, Reference
category_id: 1 # 1-10 matching category
questions:
- id: "xx-001" # Category prefix + unique number (qs=Quick Start, cc=Core Concepts, ms=Memory Settings, ag=Agents, sk=Skills, cm=Commands, hk=Hooks, mcp=MCP, ap=Advanced, rf=Reference)
difficulty: "junior" # junior | senior | power
profiles: ["junior", "senior", "power", "pm"] # Who sees this question
question: "What is the recommended action when context usage reaches 70%?"
options:
a: "Continue working normally"
b: "Use /compact to compress context"
c: "Use /clear to reset completely"
d: "Exit and restart Claude Code"
correct: "b" # a | b | c | d
explanation: |
At 70% context usage (orange zone), you should use /compact to summarize
the conversation and free up space while preserving key context.
/clear is a more drastic option that completely resets context, which
is typically only needed at 90%+ usage (red/critical zone).
The context zones are:
- 0-50%: Green (work freely)
- 50-70%: Yellow (be selective)
- 70-90%: Orange (/compact now)
- 90%+: Red (/clear required)
doc_reference:
file: "guide/ultimate-guide.md"
section: "2.2 Context Management"
anchor: "#22-context-management"
# Add more questions following this format...
# - id: "xx-002"
# ...