Write Concept

Process

1. Understand

• Clarify: country, subject, grade, concept scope

• Ask user if anything is unclear

2. Research (new concepts only)

• Skip if curriculum info provided (e.g., from bulk-generate-concepts)

• Otherwise: WebSearch "[country] [subject] curriculum [grade]"

• Find official curriculum documents

• Extract: concept scope, learning objectives, difficulty progression

3. Read rules

• docs/concept-rules.md

• content/schema.ts

4. Write/edit concept file

• Location: content/subjects/{subject}/official/{id}.md

• Follow concept-rules.md for all field requirements

• Always update: version (increment) and version_notes (describe changes)

• Prerequisites: Check content/subjects/{subject}/official/ for existing concept IDs

5. Update translations

• Update ALL files: packages/frontend/public/locales/*/subjects/{subject}.json

• Key: concepts.{concept-id} with name and description

6. Validate

bun run check:concepts {subject}/{concept-id}

Red Flags

• "I'll skip curriculum research" → You won't know what to put in fields

• "I'll add examples to help the AI" → CARDINAL RULE violation

• "Problem types look similar but different" → Not distinct enough