/start-14-4.en

description: "Lesson command"
chapter: "courses/aiagent/lesson03-core/module14-article-writing/chapter.yaml"
category: "lesson"
duration: "~40 min"
prerequisites: ["start-14-3"]
level: "intermediate"
tags: ["article", "illustration"]
nonInteractiveMode: deferred

🎓 Lesson 14-4: Illustration Planning and Generation - nanobanana + PlantUML

📍 What You'll Do

Welcome to **Lesson 14-4: Illustration Planning and Generation - nanobanana + PlantUML**!

| Item | Details | |------|---------| | Goal | Detect illustration markers in the article and auto-generate illustrations with nanobanana and PlantUML | | Duration | ~40 min | | Skills Used | nanobanana, diagram-generator | | Prerequisites | Gemini API key configured, Lesson 14-3 (draft) complete | | Course Page | Refer to [Module 14: Article Writing](https://ai-agent.camp/en/course/module-14) in parallel |

**Session flow:** 1. Check illustration markers (`<!-- illustration: ... -->`) in the draft 2. For type=diagram markers → generate diagrams with PlantUML 3. For type=image markers → generate images with nanobanana 4. Embed the generated images in Markdown

By the end of this session, an article draft with illustrations will be complete.

> **💡 Hint**: If the AI response stops midway, type "please continue" or "it stopped" to resume. Responses may pause depending on the tool, but this is not a malfunction.

---

🎯 Readiness Check

First, let's confirm everything is ready.

**AskQuestion settings:**

{
  "title": "🎯 Pre-Session Check",
  "questions": [{
    "id": "readiness",
    "prompt": "Are you ready?",
    "options": [
      {"id": "ready", "label": "Ready! Let's start"},
      {"id": "check_prereq", "label": "I want to check the prerequisites"},
      {"id": "view_html", "label": "I want to see the course page first"},
      {"id": "different_lesson", "label": "I want to go to a different lesson"}
    ]
  }]
}

(ready → Proceed to Step 1) (check_prereq → Run prerequisite check) (view_html → Show course page path) (different_lesson → Display module list)

---

🚀 Step 1: Check Illustration Markers in the Draft

In Codex, you typically select from choices in chat to choose the marker detection method.

**AskQuestion settings example:**

{
  "title": "🚀 Step 1: Check Illustration Markers",
  "questions": [{
    "id": "marker_method",
    "prompt": "How would you like to detect illustration markers?",
    "options": [
      {"id": "auto_detect", "label": "Auto-detect markers"},
      {"id": "manual_specify", "label": "Manually specify illustration locations"}
    ]
  }]
}

**If "Auto-detect markers":** Input:

Read output/article-14-3-draft-final.md and
extract all illustration markers (<!-- illustration: ... -->).

List the following for each marker:
1. Line number
2. Type (image / diagram)
3. Description text
4. Surrounding context (which section it belongs to)

If markers are missing, suggest locations where they should be added.

**If "Manually specify illustration locations":**

Display the contents of output/article-14-3-draft-final.md.
Specify where you want to insert illustrations, and markers will be added.

**Expected result**: All illustration markers in the draft are listed, and a generation plan is established.

---

🚀 Step 2: Generate Diagrams with PlantUML (type=diagram)

In Codex, you typically select from choices in chat: "Continue / Review examples / Skip".

**AskQuestion settings example:**

{
  "title": "🚀 Step 2: Generate Diagrams with PlantUML",
  "questions": [{
    "id": "step_action",
    "prompt": "What would you like to do with this step?",
    "options": [
      {"id": "practice", "label": "Continue"},
      {"id": "review", "label": "Just review examples"},
      {"id": "skip", "label": "Skip (if no diagram markers)"}
    ]
  }]
}

**Post-selection instructions (example)**: Input:

Use the diagram-generator skill to generate diagrams for the following illustration markers.

Target marker:
<!-- illustration: type=diagram, description="Work efficiency improvement flow chart" -->

Generation conditions:
- Format: PlantUML → PNG image
- Style: Simple, easy-to-read color scheme
- Output: output/images/article-14-4-diagram-1.png

Execution command:
uv run python tools/generate_diagram.py --type flowchart --topic "Work efficiency improvement flow" --output output/images/article-14-4-diagram-1.png

Generate images for all diagram markers.

**Expected result**: PlantUML-based diagram images are generated in output/images/.

---

🚀 Step 3: Generate Images with nanobanana (type=image)

In Codex, you typically select from choices in chat: "Continue / Review examples / Skip".

**AskQuestion settings example:**

{
  "title": "🚀 Step 3: Generate Images with nanobanana",
  "questions": [{
    "id": "step_action",
    "prompt": "What would you like to do with this step?",
    "options": [
      {"id": "practice", "label": "Continue"},
      {"id": "review", "label": "Just review examples"},
      {"id": "skip", "label": "Skip (if no image markers)"}
    ]
  }]
}

**Post-selection instructions (example)**: Input:

Use the nanobanana skill to generate images for the following illustration markers.

Target marker:
<!-- illustration: type=image, description="Business professional working with AI tools" -->

Generation conditions:
- Style: Modern, clean illustration style
- Size: Aspect ratio suitable for article illustrations (16:9 or 4:3)
- Output: output/images/article-14-4-image-1.png

Execution command:
uv run python tools/nanobanana.py --prompt "Business professional working with AI tools, modern illustration style" --output output/images/article-14-4-image-1.png

Generate images for all image markers.

**Expected result**: Illustration images generated with nanobanana are saved in output/images/.

---

🚀 Step 4: Embed Generated Images in Markdown

In Codex, you typically select from choices in chat: "Cont