Add JLPT N3 curriculum requirements and implementation guide

[alanfwilliams]

Summary

This PR introduces a comprehensive requirements document for extending the JLPT course curriculum from N4 (day 660) through N3 readiness (day 960). The document serves as a specification for implementing 300 new curriculum days organized into 6 new phases, along with supporting features for vocabulary, grammar, kanji, and reading comprehension.

Key Changes

• Curriculum expansion: Defines 6 new phases (15–20) spanning days 661–960, with specific content targets:

  • Phase 15: N4 Review (30 days)
  • Phase 16: N3 Vocabulary (~1,500 words across 80 days)
  • Phase 17: N3 Verbs & Adjectives (50 days)
  • Phase 18: N3 Grammar (~120 patterns across 75 days)
  • Phase 19: N3 Kanji (~170 new kanji across 35 days)
  • Phase 20: N3 Test Prep (30 days)

• New lesson features:

  • Introduces "reading" type for paragraph-level comprehension lessons
  • Defines passage field structure with Japanese/English text and comprehension questions
  • Specifies furigana toggle functionality for reading passages

• Exercise system enhancements:

  • Documents 4 new exercise types: reading, conjugation, pair_match, fill_blank
  • Recommends increasing exercise cap from 5 to 6–8 per lesson for N3 content

• Content organization:

  • Vocabulary grouped by 10 topic clusters (daily life, emotions, work, nature, health, media, education, travel, abstract concepts, adverbs/conjunctions)
  • Grammar patterns organized into 9 thematic groups (conditionals, cause/reason, contrast, extent, hearsay, time, intention, obligation, listing, formal expressions)
  • Kanji grouped by semantic themes with guidance on handling multiple readings

• Data integrity guidelines:

  • Establishes strict content authoring rules (3-element vocab arrays, 2-element char arrays, non-empty meanings, etc.)
  • References and prevents recurrence of bugs found in existing curriculum (days 85, 86–97, 173, 253–308)

• Implementation roadmap:

  • Specifies file changes needed in curriculum.js, lib.js, index.html, tests.html, and documentation
  • Provides 11-step implementation order from phase constants through final testing

Notable Implementation Details

• The document maintains backward compatibility with existing N5/N4 content (no changes to days 1–660)
• SRS system requires no structural changes; existing SM-2 implementation scales to 960 days
• UI components (overview calendar, progress bar) auto-scale without modification
• Comprehensive test coverage plan includes regression protection for all 92 existing tests plus new N3-specific test modules

https://claude.ai/code/session_0163k3rusvAMQfxAr6dnkfSX