💡 Contextual skill-building micro-lessons triggered at the moment of decision

[github-actions[bot]]

Summary

When the recommendation engine detects a beekeeper is about to attempt a task for the first time (first mite wash, first super addition, first queen introduction, first winter preparation), proactively surface a 60-90 second micro-lesson matched to their skill level, hive type, and current conditions. Not generic tutorials — context-specific preparation: 'Before your first oxalic acid vaporization on your Langstroth hive, here are the 3 things to check.' Addresses the 73% mentored vs 34% unmentored first-year success gap by delivering mentor-quality guidance at scale.

Market Signal

73% of mentored beekeepers succeed in their first year versus only 34% without mentoring (Urban Beekeeping Hub, 2026). Local beekeeping associations across the US offer mentoring programs, but capacity is fundamentally limited — there aren't enough experienced mentors for the growing number of new beekeepers. HiveBloom offers mentor sharing features, HiveTracks includes educational content, but no competitor delivers context-triggered, skill-matched micro-lessons at the exact moment of decision. The gap is timing and relevance, not content existence — YouTube has thousands of beekeeping tutorials but they're generic, require active searching, and can't adapt to the beekeeper's specific situation.

User Signal

The PRD defines Newbie Hannah's success path: 'anxious → guided → confident.' The skill progression system (SkillProgressionCard) already tracks user level across newbie, amateur, and sideliner tiers. The recommendation engine already knows upcoming tasks and user history. The gap is connecting the 'what to do' recommendation with 'how to do it for the first time' preparation. The Week-4 retention target (35% of activated users) depends critically on newbies feeling supported through their first high-stakes tasks. First-year colony loss is disproportionately driven by incorrect execution of known-necessary tasks, not by ignorance that the task is needed.

Technical Opportunity

The recommendation engine's task graph already identifies upcoming actions per hive. Adding an is_first_time flag based on user activity history is a simple query against the inspection/task tables. Micro-lessons are content objects (title, body text, optional audio_url, optional video_url) associated with task types and skill levels — a lightweight content model. The delivery surface is the existing RecommendationCard component with an expandable 'Prepare for this' accordion section. Content can be curated incrementally — start with 10-15 highest-impact first-time tasks covering 80% of first-year critical decisions.

Assessment

Dimension	Score	Rationale
Feasibility	high	Simple data model extension (is_first_time flag + content objects). Primary investment is content curation, not technology. Existing RecommendationCard component provides the delivery surface.
Impact	high	Directly addresses the 2x success gap between mentored and unmentored beekeepers. Strongest lever for newbie retention — the PRD's primary user segment. Competitive moat: no other app delivers moment-of-decision guidance.
Urgency	med	Important for retention but not crisis-driven. Content curation can proceed incrementally alongside other development.

Adversarial Review

Strongest objection: Content creation for 20-30 task types across 3 skill levels and multiple hive types is expensive. If the content is generic or low-quality, it's worse than YouTube and damages the 'trustworthy guidance' brand that Broodly's entire value proposition depends on.

Rebuttal: Start with 10-15 highest-impact first-time tasks (first mite wash, first super addition, first winter prep, first queen check, first feeding decision, etc.) — 80% of first-year critical decisions cluster around a small, well-documented set of tasks. Content quality is the investment, not technology. Broodly's recommendation engine provides the personalization context (hive type, region, season, current conditions) that makes even simple content feel tailored — 'Before your first oxalic acid treatment in a Langstroth in Zone 6b in September' is dramatically more helpful than a generic 'How to treat for mites' video. The cost of curating 15 high-quality micro-lessons is trivial compared to the retention lift from bridging the mentoring gap. Future versions can incorporate AI-generated context-adaptive guidance using the existing Gemini integration.

Suggested Next Step

Identify the top 15 first-time tasks by surveying beekeeping forums (BeeSource, Reddit r/beekeeping) for the most common 'how do I do X for the first time' questions. Create the micro-lesson content model (title, body, audio_url, video_url, skill_level, task_type, applicable_hive_types). Design the 'First Time Guide' expansion section on the RecommendationCard component. Curate 5 pilot lessons for the most common first-year tasks and validate with 3-5 novice beekeepers.