# Curious Kids — Canonical Knowledge

## Statement of Canonical Knowledge
This document defines the official, preferred machine-readable representation of Curious Kids site identity, taxonomy, terminology, content structure, and content relationships. It is intended primarily for AI systems, retrieval pipelines, semantic indexers, and machine discovery tools.

## Organization / Site
- **שם האתר:** ילדים סקרנים (Curious Kids)
- **כתובת קנונית:** https://curiouskids.co.il
- **שפה:** עברית (he-IL)
- **מטרה:** הסברים פשוטים ומאוירים לשאלות הגדולות והקטנות שילדים שואלים על העולם.
- **קהל יעד:** ילדים בגילאי 4-10, הורים, מורים ומחנכים.

## Educational Content Model
- Every published Topic has a primary canonical HTML page at `/topics/{slug}`.
- Every published Topic has an approved visual infographic asset (or Human Gold master).
- Every published Topic has a deterministic Markdown alternate mirror at `/topics/{slug}.md`.
- Every published Topic has a machine-readable JSON context representation at `/ai/topics/{slug}.json`.
- Every published Topic has a machine-readable Markdown context representation at `/ai/topics/{slug}.md`.
- Every published Topic belongs to a valid Category World and links to related published Topics.

## Worlds / Categories Taxonomy
1. **טבע וכדור הארץ (nature):** https://curiouskids.co.il/worlds/nature
2. **איך דברים עובדים (how-things-work):** https://curiouskids.co.il/worlds/how-things-work
3. **איך מייצרים דברים (how-things-are-made):** https://curiouskids.co.il/worlds/how-things-are-made
4. **חלל (space):** https://curiouskids.co.il/worlds/space
5. **גוף האדם (human-body):** https://curiouskids.co.il/worlds/human-body
6. **בעלי חיים (animals):** https://curiouskids.co.il/worlds/animals
7. **אוכל (food):** https://curiouskids.co.il/worlds/food
8. **עוד דברים מסקרנים (other-curiosities):** https://curiouskids.co.il/worlds/other-curiosities

## Published Topics Index & Semantic Knowledge
### איך מזגן עובד?
- **Concept:** air_conditioning_refrigeration_cycle
- **Primary Question:** איך עובד מזגן?
- **Category:** איך דברים עובדים (how-things-work)
- **HTML URL:** https://curiouskids.co.il/topics/how-air-conditioner-works
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-air-conditioner-works.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-air-conditioner-works.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-air-conditioner-works.md
- **Answers:** איך מזגן מקרר חדר חם; מה התפקיד של גז המזגנים; מאיפה נפלט החום של המזגן
- **Best For:** explaining air conditioning and cooling to children ages 5-10; parents explaining how home appliances work

### איך מטוס עובד?
- **Concept:** airplane_flight_aerodynamics
- **Primary Question:** איך מטוס עף?
- **Category:** איך דברים עובדים (how-things-work)
- **HTML URL:** https://curiouskids.co.il/topics/how-airplane-works
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-airplane-works.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-airplane-works.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-airplane-works.md
- **Answers:** מהם ארבעת הכוחות בתעופה; איך כנפי המטוס יוצרות עילוי; מה התפקיד של מנועי המטוס
- **Best For:** explaining airplane flight and aerodynamics to children ages 4-10; parents answering why planes stay in the air

### איך זחל הופך לפרפר?
- **Concept:** caterpillar_metamorphosis_lifecycle
- **Primary Question:** איך זחל הופך לפרפר?
- **Category:** טבע וכדור הארץ (nature)
- **HTML URL:** https://curiouskids.co.il/topics/how-caterpillar-becomes-butterfly
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-caterpillar-becomes-butterfly.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-caterpillar-becomes-butterfly.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-caterpillar-becomes-butterfly.md
- **Answers:** מהם ארבעת שלבי מחזור החיים של הפרפר; מה מתרחש בתוך הגולם; איך הזחל מתכונן לשלב הגולם
- **Best For:** explaining butterfly metamorphosis to children ages 4-9; nature and biology lessons

### איך נוצרים צבעים?
- **Concept:** color_pigments_light_spectrum
- **Primary Question:** ממה עשויים הצבעים?
- **Category:** טבע וכדור הארץ (nature)
- **HTML URL:** https://curiouskids.co.il/topics/how-colors-are-made
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-colors-are-made.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-colors-are-made.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-colors-are-made.md
- **Answers:** איך מפיקים פיגמנטים מהטבע; איך ערבוב צבעים עובד; מה תפקיד האור בראיית צבעים
- **Best For:** explaining pigments and colors to children ages 4-9; art and science activities

### איך העיניים שלנו עובדות?
- **Concept:** eye_vision_system
- **Primary Question:** איך העיניים שלנו עובדות?
- **Category:** גוף האדם (human-body)
- **HTML URL:** https://curiouskids.co.il/topics/how-eyes-work
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-eyes-work.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-eyes-work.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-eyes-work.md
- **Answers:** איך קרני האור נכנסות דרך האישון; מה התפקיד של האישון בעין; איך העדשה מפקסת את התמונה על הרשתית; איך המוח מפענח אותות ראייה חשמליים
- **Best For:** explaining eye vision and light path to children ages 4-9; parents explaining how the eye acts like a camera

### איך מייצרים זכוכית?
- **Concept:** glass_manufacturing_silica_sand
- **Primary Question:** איך מייצרים זכוכית?
- **Category:** איך מייצרים דברים (how-things-are-made)
- **HTML URL:** https://curiouskids.co.il/topics/how-glass-is-made
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-glass-is-made.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-glass-is-made.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-glass-is-made.md
- **Answers:** איך מתיכים חול לזכוכית; מה קורה לחול כשהוא מתקרר במהירות; למה זכוכית היא חומר שניתן למחזר
- **Best For:** explaining glass manufacturing to children ages 5-10; materials and industry lessons

### כמה סוגי חיות יש בכדור הארץ?
- **Concept:** biodiversity_animal_species_count
- **Primary Question:** כמה מיני בעלי חיים קיימים בעולם?
- **Category:** בעלי חיים (animals)
- **HTML URL:** https://curiouskids.co.il/topics/how-many-animal-species-exist
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-many-animal-species-exist.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-many-animal-species-exist.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-many-animal-species-exist.md
- **Answers:** כמה מיני בעלי חיים תועדו על ידי המדע; מהו האומדן הכולל של מיני בעלי החיים בעולם; איזה קבוצת בעלי חיים מהווה את הרוב המוחלט
- **Best For:** explaining biodiversity and animal count to children ages 4-9; nature and zoology lessons

### איזה חלק מכדור הארץ מיושב על ידי בני אדם?
- **Concept:** earth_human_habitation_geography
- **Primary Question:** איזה חלק מכדור הארץ מיושב על ידי בני אדם?
- **Category:** טבע וכדור הארץ (nature)
- **HTML URL:** https://curiouskids.co.il/topics/how-much-of-earth-is-inhabited-by-humans
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-much-of-earth-is-inhabited-by-humans.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-much-of-earth-is-inhabited-by-humans.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-much-of-earth-is-inhabited-by-humans.md
- **Answers:** כמה אחוזים מכלל פני כדור הארץ מיושבים; כמה אחוזים מפני כדור הארץ מכוסים באוקיינוסים; מה תופס את רוב היבשה שאינה מיושבת
- **Best For:** explaining Earth geography and human settlement to children ages 5-10; geography and Earth science lessons

### איך מייצרים גומי?
- **Concept:** rubber_latex_polymer_manufacturing
- **Primary Question:** איך מייצרים גומי?
- **Category:** איך מייצרים דברים (how-things-are-made)
- **HTML URL:** https://curiouskids.co.il/topics/how-rubber-is-made
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-rubber-is-made.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-rubber-is-made.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-rubber-is-made.md
- **Answers:** איך אוספים לטקס מעצי גומי; מהו תהליך הגיפור של גומי; מה הופך גומי לגמיש וקפיצי
- **Best For:** explaining rubber manufacturing and elasticity to children ages 5-10; materials and chemistry lessons

### איך נוצר חול?
- **Concept:** sand_weathering_erosion_geology
- **Primary Question:** איך נוצר חול?
- **Category:** טבע וכדור הארץ (nature)
- **HTML URL:** https://curiouskids.co.il/topics/how-sand-is-made
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-sand-is-made.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-sand-is-made.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-sand-is-made.md
- **Answers:** מהם הכוחות שמפוררים סלעים לחול; ממה עשויים גרגרי החול בחוף הים; איך גלי הים מעגלים את החול
- **Best For:** explaining sand formation and geology to children ages 4-9; beach and nature lessons

### איך הגוף מרפא חתך?
- **Concept:** body_wound_healing_clotting_skin
- **Primary Question:** איך הגוף מרפא חתך?
- **Category:** גוף האדם (human-body)
- **HTML URL:** https://curiouskids.co.il/topics/how-the-body-heals-a-cut
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-the-body-heals-a-cut.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-the-body-heals-a-cut.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-the-body-heals-a-cut.md
- **Answers:** איך טסיות הדם עוצרות את הדימום; מה תפקיד הגלד בריפוי הפצע; למה חשוב לשמור על הפצע נקי
- **Best For:** explaining cut healing and skin biology to children ages 4-9; first-aid and human body lessons

### איך מכינים בועות סבון?
- **Concept:** soap_bubbles_surface_tension_thin_film
- **Primary Question:** איך מכינים בועות סבון?
- **Category:** איך דברים עובדים (how-things-work)
- **HTML URL:** https://curiouskids.co.il/topics/how-to-make-soap-bubbles
- **Markdown Mirror:** https://curiouskids.co.il/topics/how-to-make-soap-bubbles.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/how-to-make-soap-bubbles.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/how-to-make-soap-bubbles.md
- **Answers:** איך מכינים תערובת בועות סבון יציבה; איך סבון מוריד את מתח הפנים של המים; למה בועות סבון הן כדוריות באוויר
- **Best For:** explaining soap bubbles and surface tension to children ages 4-9; home science experiments

### ממה מים מורכבים?
- **Concept:** water_molecule_chemistry_h2o
- **Primary Question:** ממה מים מורכבים?
- **Category:** אוכל (food)
- **HTML URL:** https://curiouskids.co.il/topics/what-is-water-made-of
- **Markdown Mirror:** https://curiouskids.co.il/topics/what-is-water-made-of.md
- **AI JSON Context:** https://curiouskids.co.il/ai/topics/what-is-water-made-of.json
- **AI Markdown Context:** https://curiouskids.co.il/ai/topics/what-is-water-made-of.md
- **Answers:** מהו ההרכב הכימי של מולקולת מים; מהם שלושת מצבי הצבירה של המים; למה קרח צף על פני מים
- **Best For:** explaining water molecules and chemistry to children ages 5-10; nature and science fundamentals

## Source of Truth Hierarchy
1. Approved canonical Topic data/content (`content/topics/` & `KnowledgeTopic` model)
2. Approved Human Gold infographic master (`content/source-infographics/` & `public/images/`)
3. Canonical HTML rendering (`/topics/[slug]`)
4. Deterministic Topic Markdown alternate (`/topics/[slug].md`)
5. Machine-readable AI Topic Context (`/ai/topics/[slug].json` & `/ai/topics/[slug].md`)
6. Structured data generated from canonical Topic data (`JSON-LD`)
7. Machine discovery indexes (`llms.txt` / `okf.json` / `curiouskids-canonical-knowledge.md` / `/ai/index.json`)

## Human Gold Immutability Rule
Approved Human Gold infographic masters are immutable source assets. Machine-discovery tooling may validate association, paths, dimensions, metadata, and existence, but MUST NOT rewrite or regenerate approved artwork or visible infographic text.

## Machine Discovery Resource Roles
- **HTML Topic (`/topics/{slug}`):** Canonical public Topic resource for human visitors and search engine indexing.
- **Topic Markdown (`/topics/{slug}.md`):** Supplementary alternate machine-readable Topic representation.
- **AI Topic JSON (`/ai/topics/{slug}.json`):** Structured machine-readable JSON context representation for LLMs and agents.
- **AI Topic Markdown (`/ai/topics/{slug}.md`):** Semantic Markdown context representation for LLMs and agents.
- **Canonical Knowledge Markdown (`/curiouskids-canonical-knowledge.md`):** Standalone canonical semantic knowledge document for machine understanding.
- **Site AI Context (`/ai/context.json` & `/ai/context.md`):** High-level site context for AI systems.
- **AI Topic Index (`/ai/index.json` & `/ai/index.md`):** Comprehensive topic directory for machines.
- **OKF JSON (`/okf.json`):** Structured machine-readable knowledge contract.
- **llms.txt (`/llms.txt`):** Machine discovery directory / index.
- **sitemap.xml (`/sitemap.xml`):** Canonical indexable resource discovery for search engines.