# 🌿 Lumabit Flora Lesson Generation Specification
Cape Peninsula & Table Mountain National Park

## 🎯 Purpose
Generate structured JSON lessons for individual plant species found around Cape Town and Table Mountain National Park, following the Lumabit learning schema.

Each lesson should help learners recognise the plant in the wild, understand where and when they are likely to encounter it, and notice key identifying features, using clear, friendly language suitable for general South African learners.

---

## INPUT
- Flora species: {step_data}
  (Includes common name and scientific name)

---

## 📁 Output Specification

{{
  "bits": [...],
  "lesson": {{
    "title": "Common name",
    "scientific_name": "Scientific name",
    "aliases": ["Local or alternate name 1", "Alternate name 2"],
    "intro": "...",
    "body": "Markdown-formatted content with short paragraphs, ending in a ### Data sheet section.",
    "facts": ["One or two short, interesting or contextual facts."],
    "questions_and_answers": [...],
    "illustrations": ["One short text prompt for illustration."]
  }}
}}

Top-level output must be a JSON object, not a list.

---

## 🧱 Schema Details

### 1️⃣ bits
Include 2–3 short, action-based learning statements describing what the learner will gain.

Example:
- I can recognise this plant.
- I know where this plant grows.

Format:
```json
[
  {{"title": "I can recognise the [Bird Name].", "description": "Identify its shape and colours.", "order": 1}},
  {{"title": "I can describe where the [Bird Name] lives.", "description": "Understand its typical habitat.", "order": 2}}
]
```

---

### 2️⃣ lesson.intro
One sentence only. A visual or situational hook grounded in place, season, or appearance.

---

### 3️⃣ lesson.body
Write 2–3 short paragraphs in plain English.

Cover:
- Identification (growth form, flowers, leaves)
- Habitat & place
- Seasonality or adaptation (optional)

Avoid jargon and heavy taxonomy.

---

### 4️⃣ Data sheet
Append a ### Data sheet section using only verifiable fields.

Allowed fields (all optional):
- Growth form
- Height
- Leaves
- Flowers
- Habitat
- Altitude
- Distribution
- Flowering season
- Fire response
- Pollinators
- Endemism
- Status
- Uses

Never guess or include unknowns.

---

### 5️⃣ facts
1–2 interesting, contextual facts. Avoid restating the body.

---

### 6️⃣ questions_and_answers
Exactly 3 multiple-choice questions:
1. Identification
2. Habitat/location
3. Distinctive feature

Each with 4 options and one correct answer.

Format:
```json
{{
  "question": "Question goes here?",
  "options": [
    {{"text": "Answer 1", "correct": true/false}},
    {{"text": "Answer 2", "correct": true/false}},
    {{"text": "Answer 3", "correct": true/false}},
    {{"text": "Answer 4", "correct": true/false}}
  ]
}}
```

---

### 7️⃣ illustrations
One short descriptive prompt showing the whole plant in its typical setting.

---

## 🧠 Writing Style Guide
Friendly, factual, locally grounded. Short sentences. Metric units. No speculation.

---

## ⚙️ Generation Instructions
Use reliable sources only. Include data sheet fields only when verifiable. Validate JSON.

---

## ✅ Quality Checklist
- At least 2 bits
- Common name should stand alone (not include the word 'Step', unless it is part of the plant name)
- One-sentence intro
- 2–3 body paragraphs
- Optional, verifiable data sheet
- 1–2 facts
- Exactly 3 questions, with 4 options each
- One illustration
- Valid JSON