Skip to content

Commit 0461542

Browse files
committed
docs(generators): improve prompts for diverse tech topic generation
Enhance the tech context summarization and topic selection prompts to: - Emphasize diversity in emerging tech topics - Strengthen thematic novelty requirements - Improve clarity in avoiding topic duplication - Streamline instructions for non-technical audience focus
1 parent 8e8413c commit 0461542

1 file changed

Lines changed: 21 additions & 20 deletions

File tree

generators/general-post.ts

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -59,16 +59,18 @@ Always prioritize:
5959
6060
Your goal is to help identify potential blog topics that will resonate with people who are interested in technology's impact on their lives but don't necessarily understand the deep technical details.`;
6161

62-
const techContextSummarizePrompt = `I will provide you with a compilation of recent tech news, trends, and discussions from various online sources.
62+
const techContextSummarizePrompt = `
63+
I will provide you with a compilation of recent tech news, trends, and discussions from various online sources.
6364
6465
Based on your role as a "Tech Translator for Everyone," process this information to achieve the following:
6566
6667
1. **Overall Tech Snapshot (for a layperson):** In 3-5 bullet points, provide a high-level summary of what's buzzing in the tech world *from the perspective of how it might affect or interest an average person*.
6768
68-
2. **Identify Emerging "Wow" or "Why Should I Care?" Topics:**
69-
* List 3-5 key developments, trends, or innovations from the text that have strong potential to capture the interest of a non-technical reader.
69+
2. **Identify a DIVERSE Range of Emerging "Wow" or "Why Should I Care?" Topics:**
70+
* List 3-5 key developments, trends, or innovations from the text that have strong potential to capture the interest of a non-technical reader. **Aim for variety in the types of technologies or impact areas highlighted.**
7071
* For each, briefly explain **what it is** (in very simple terms) and **why an average person might find it interesting, exciting, useful, or concerning.**
71-
* Group similar developments if they point to a larger, relatable trend.
72+
* If possible, try to identify at least one topic from a less obvious or less mainstream tech area mentioned in the context.
73+
* Group similar developments if they point to a larger, relatable trend, but ensure the overall list of trends is diverse.
7274
7375
3. **Spotlight on Impact:**
7476
* Highlight any specific events, products, or controversies mentioned that have clear real-world implications or have sparked public discussion beyond the tech community.
@@ -77,7 +79,7 @@ Based on your role as a "Tech Translator for Everyone," process this information
7779
Important Reminders for this Specific Task:
7880
* The output should be clean, structured, and directly usable for brainstorming blog topics for a general audience.
7981
* Do not add any extra information not present in the input.
80-
* Stick to the actual content and context provided, but *interpret and frame it* through the lens you've been given (Tech Translator for Everyone).
82+
* Stick to the actual content and context provided, but *interpret and frame it* through the lens you've been given (Tech Translator for Everyone). **Emphasize breadth and diversity in the identified topics.**
8183
8284
Here is the tech context:
8385
@@ -143,32 +145,31 @@ Core Principles for Topic Selection:
143145
You are NOT trying to impress tech experts. You ARE trying to make technology accessible and fascinating for everyone.`;
144146

145147
const topicSelectionPrompt = `
146-
Your task is to propose **ONE compelling blog topic** based on the provided tech context. This topic must be highly engaging for a **general, non-technical audience** – people who are curious about technology but don't have a deep technical background.
148+
Your task is to propose **ONE compelling blog topic** based on the provided tech context. This topic must be highly engaging for a **general, non-technical audience** – people who are curious about technology but don't have a deep technical background. **Crucially, the chosen topic must be thematically distinct from recently generated topics.**
147149
148150
**LATEST TECH INSIGHTS (Summarized for a general audience):**
149-
${summarizedTechContext}
151+
${summarizedTechContext}
150152
151-
**EXISTING BLOG POST TITLES (to avoid duplication):**
152-
${existingTopicsContext}
153+
**EXISTING BLOG POST TITLES (to avoid duplication of general themes):**
154+
${existingTopicsContext}
153155
154156
**BLOG CATEGORY FOCUS (Optional Guide):**
155-
${categoryCountsText}
157+
${categoryCountsText}
156158
157159
**TOPIC SELECTION GUIDELINES (for a NON-TECHNICAL audience):**
158160
159-
1. **Broad Appeal & Curiosity:**
161+
1. **Thematic Novelty & Broad Appeal:**
162+
* **PRIORITY 1: The topic MUST explore a technology area, angle, or theme that is significantly different from the 'EXISTING BLOG POST TITLES'. For example, if recent topics heavily featured 'old gadgets' or 'AI vulnerabilities', actively seek a different theme.**
160163
* Choose a topic that answers a question an average person might have, explains a common tech interaction, or reveals a surprising aspect of how tech impacts daily life, work, or society.
161164
* Think: "What would make someone click and read, even if they don't consider themselves 'into tech'?"
162165
163166
2. **Simple & Intriguing Framing:**
164167
* The topic title should be catchy, use plain language, and clearly hint at the value or interest for the reader.
165168
* Avoid technical jargon or overly niche concepts in the title.
166-
* *Examples of good angles:* "The Secret Tech That Powers Your Food Delivery," "Is Your Smart Speaker *Really* Listening? What You Need to Know," "Could This AI Write Your Next Email? The Future of [X]", "What Happens When Self-Driving Cars Make Mistakes?"
167169
168-
3. **Fresh & Distinctive (for this audience):**
169-
* The topic should feel fresh and not like something they've read a hundred times in overly technical terms.
170-
* It must not substantially overlap with the *intent* and *angle* of existing posts listed above, especially if those posts are already aimed at a general audience.
171-
* **Actively seek out diverse areas of technology. If the tech summary seems heavily weighted towards certain fields, try to find compelling general-audience angles in other less-covered tech domains if possible.**
170+
3. **Fresh & Distinctive (Beyond Recent Topics):**
171+
* The topic should feel fresh.
172+
* It must not substantially overlap with the *intent* and *angle* of 'EXISTING BLOG POST TITLES', especially if those posts are already aimed at a general audience.
172173
173174
4. **Focus on "What it Means for ME/US":**
174175
* Prioritize topics that clearly explain the benefits, drawbacks, interesting uses, or societal implications of a technology.
@@ -182,13 +183,13 @@ ${categoryCountsText}
182183
* Avoid deep technical dives, engineering strategies, or code-level discussions.
183184
184185
6. **Strategic Category Selection:**
185-
* **Review the 'BLOG CATEGORY FOCUS'. If a compelling, audience-appropriate topic aligns with an underrepresented category, prioritize it.** While audience appeal is paramount, actively try to diversify category distribution when a strong topic allows.
186-
* **If multiple strong topic ideas emerge, lean towards one that helps balance out the category counts, especially if it avoids heavily saturated categories like AI & Machine Learning or Cybersecurity, unless the angle is exceptionally novel for a general reader.**
186+
* Review the 'BLOG CATEGORY FOCUS'. If a compelling, audience-appropriate topic aligns with an underrepresented category (and meets the thematic novelty requirement), prioritize it.
187+
* If multiple strong topic ideas emerge, lean towards one that helps balance out the category counts and strongly differs from recent topics.
187188
188189
**Please provide the information for the following fields:**
189-
- **TOPIC_TITLE:** Your Chosen Topic Title Here (Catchy, clear, and for a general audience)
190+
- **TOPIC_TITLE:** Your Chosen Topic Title Here (Catchy, clear, for a general audience, and thematically novel)
190191
- **HOOK_DESCRIPTION:** 1-2 concise sentences that would make a non-technical person want to read this post. Explain what it's about and *why it's interesting or relevant to them*.
191-
- **POTENTIAL_SEARCH_QUERIES:** 3-5 simple, natural language search phrases an average person (not a tech expert) might type into Google if they were curious about this subject. (e.g., "how does facial recognition work," "is AI safe," "what's new with smart homes").
192+
- **POTENTIAL_SEARCH_QUERIES:** 3-5 simple, natural language search phrases an average person (not a tech expert) might type into Google if they were curious about this subject.
192193
193194
**The output will be structured as JSON according to the defined schema.**
194195
`;

0 commit comments

Comments
 (0)