Add 'what the content must cover' brief text area; screenshots stay optional

app.py

@@ -220,7 +220,7 @@ def _collect_keywords(primary_kw, secondary_kw) -> dict:
 
 def run_pipeline(topic, hf_token, yt_api_key, llm_model, vlm_model,
                  w_llm, w_whisper, lead, max_shots, primary_kw, secondary_kw,
-                 progress=gr.Progress()):
+                 content_brief="", progress=gr.Progress()):
     """Generator yielding (status_md, ranking_df, transcript, docx_file)."""
     log: list[str] = []
 
@@ -278,8 +278,11 @@ def run_pipeline(topic, hf_token, yt_api_key, llm_model, vlm_model,
         kw_note = f" • primary: '{keywords['primary']}'" if keywords["primary"] else ""
         if keywords["secondary"]:
             kw_note += f" • secondary: {', '.join(keywords['secondary'])}"
+        if (content_brief or "").strip():
+            kw_note += " • honoring your content brief"
         yield status(f"🤖 Generating tutorial with `{llm_model}`{kw_note}…"), ranking, gr.update(value=transcript), gr.update()
-        tut = tutorial_mod.generate_tutorial(transcript, hf_token.strip(), llm_model, keywords)
+        tut = tutorial_mod.generate_tutorial(transcript, hf_token.strip(), llm_model,
+                                             keywords, brief=content_brief)
         if keywords["primary"]:
             n = tutorial_mod.count_keyword(tut, keywords["primary"])
             yield (status(f"🔑 Primary keyword '{keywords['primary']}' appears {n}× in the post."),
@@ -345,6 +348,18 @@ def build_ui():
                 vlm_model = gr.Dropdown(VLM_CHOICES, value=VLM_CHOICES[0],
                                         label="Vision model (captions)", allow_custom_value=True)
 
+        content_brief = gr.Textbox(
+            label="What the content must cover (optional)",
+            lines=4,
+            placeholder=("List the points, steps, or questions the tutorial must address — "
+                         "one per line or comma-separated.\n"
+                         "e.g. How to create a pivot table\nHow to refresh data\n"
+                         "Common pivot table errors"),
+            info=("Required coverage for the tutorial writer. Leave blank to just follow "
+                  "the video. Screenshots stay optional — if none are suitable the post is "
+                  "produced without them."),
+        )
+
         with gr.Accordion("SEO / AEO keywords (optional)", open=False):
             gr.Markdown(
                 "The **primary keyword** is used naturally ~3× in the body and placed in "
@@ -382,7 +397,8 @@ def build_ui():
         run_btn.click(
             run_pipeline,
             inputs=[topic, hf_token, yt_api_key, llm_model, vlm_model,
-                    w_llm, w_whisper, lead, max_shots, primary_kw, secondary_kw],
+                    w_llm, w_whisper, lead, max_shots, primary_kw, secondary_kw,
+                    content_brief],
             outputs=[status_md, ranking_df, transcript_box, docx_file],
         )
     return demo