Skip to content

Add Real-World Project: Outline→Blog Post Generator #268

Description

@abderrahim-lectures

Add a new Real-World Projects lesson: Build an Outline→Blog Post Generator (backlog idea #14 — "Agent that turns a rough outline into a polished blog post draft").

Scope

  • docs/projects/blog-post-generator/index.md — new lesson matching the house skeleton (see docs/projects/resume-tailor-agent/index.md or docs/projects/agentic-code-reviewer/index.md as the closest siblings in structure: same free-tier LLM setup, same file-in/file-out CLI shape).
  • examples/blog-post-generator/ — a real, runnable CLI built on a free-tier LLM: takes a rough outline (Markdown bullets or plain text) and expands it into a polished blog post draft, one section at a time (or in one pass with a carefully designed prompt). Includes a generate.py, a sample outline, a notebook.ipynb, and a README.md.
  • Registration: src/data/projects.ts, docs/projects/index.mdx, src/pages/index.tsx (English only — no i18n changes).
  • Colab/Kaggle/Binder badges in "Where to run this", pointed at this PR's branch (to be updated to main once merged) — the notebook reads a bundled sample outline from the repo and asks for the API key interactively with getpass.

Framing note

The lesson should frame the honest use of this tool: the model expands your outline into prose (you control structure and ideas; it handles the writing), and the output is a draft to be edited in your voice — not a finished post to publish untouched. Avoid framing it as "generate an entire article with zero effort."

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:capstoneCapstone project content, examples, or architectureprojectBacklog: a candidate Real-World Project ideatopic:ai-agentsAI agents & LLM tooling projectstype:content

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions