build-study-plan

build-study-plan

When to Use

Invoke this skill when initializing a new learner profile (/jp-init) or when the learner requests a plan reset. It produces the long-term weekly schedule that all other skills reference.

Inputs

Parameter	Type	Required	Description
goal	string	yes	Learning goal (e.g., "JLPT N4", "travel communication")
level	string	yes	Starting JLPT level: "N5", "N4", "N3"
daily_minutes	integer	yes	Available study time per day in minutes
focus_topics	string[]	yes	Preferred topic areas (e.g., ["greetings", "travel", "food"])

Outputs

An array of 24 week objects with the following structure:

Field	Type	Description
week_index	integer	1–24
focus_area	string	Primary skill focus for this week
target_vocab_count	integer	New vocabulary items to cover
target_grammar_count	integer	Grammar patterns to introduce
target_listening_count	integer	Listening drills to complete
target_speaking_count	integer	Speaking tasks to complete

Logic

Phase Allocation

The 24 weeks are divided into three phases:

Weeks 1–8 (Foundation): Emphasize vocabulary acquisition and listening comprehension.

• focus_area: "vocab+listening"
• Higher target_vocab_count (5–8/week), lower target_speaking_count (1–2/week)
• Build listening tolerance before production pressure

Weeks 9–16 (Structure): Shift to grammar drilling and shadowing.

• focus_area: "grammar+shadowing"
• Introduce 2–3 new grammar patterns per week
• Shadowing exercises derived from listening items
• Reduce new vocab to 3–5/week (consolidation mode)

Weeks 17–24 (Production): Emphasize speaking fluency and comprehensive review.

• focus_area: "speaking+review"
• target_speaking_count increases to 3–4/week
• Weekly cumulative reviews using build-weekly-review
• Recycle vocabulary from weeks 1–8 in speaking contexts

Time Scaling

All counts are scaled proportionally to daily_minutes:

• 15 min/day → baseline counts × 0.5
• 30 min/day → baseline counts × 1.0
• 45 min/day → baseline counts × 1.5
• 60+ min/day → baseline counts × 2.0

Topic Integration

focus_topics influence which items are selected each week. For example, a learner focused on "travel" will see travel-themed listening and speaking items in weeks 9–16 rather than generic ones.

Example

Input:

{
  "goal": "Travel communication in Japan",
  "level": "N5",
  "daily_minutes": 30,
  "focus_topics": ["greetings", "travel", "food"]
}

Output (first 3 weeks):

[
  { "week_index": 1, "focus_area": "vocab+listening", "target_vocab_count": 7, "target_grammar_count": 1, "target_listening_count": 3, "target_speaking_count": 1 },
  { "week_index": 2, "focus_area": "vocab+listening", "target_vocab_count": 7, "target_grammar_count": 1, "target_listening_count": 3, "target_speaking_count": 1 },
  { "week_index": 9, "focus_area": "grammar+shadowing", "target_vocab_count": 4, "target_grammar_count": 3, "target_listening_count": 2, "target_speaking_count": 2 }
]