| name | build-study-plan |
| description | Generate a personalized 24-week Japanese study plan structure based on the learner's goal, level, daily time budget, and topic preferences. |
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 }
]