fraim-framework 2.0.67 → 2.0.68

package/dist/registry/workflows/customer-development/strategic-brainstorming.md

@@ -1,146 +0,0 @@
-# Strategic Brainstorming Workflow
-
-## INTENT
-To help Product Managers brainstorm and validate their customer development strategy through deep thinking, assumption challenging, and market research to identify the right customer segments and validation questions.
-
-## PRINCIPLES
-- **Assumption Challenging**: Question PM's assumptions and explore alternatives
-- **Deep Research**: Use market research to validate/invalidate assumptions
-- **Strategic Thinking**: Help PM think through customer segments and priorities
-- **Actionable Output**: Provide clear recommendations for customer interviews
-
-## WORKFLOW TRIGGER
-**PM explicitly starts this workflow**:
-- "Starting Strategic Brainstorming"
-- "I need to brainstorm our customer development strategy"
-- "Following the strategic brainstorming workflow"
-
-## AI AGENT PROCESS
-
-### Step 1: Deep Context Gathering
-**AI Agent First Actions**:
-1. **Read Business Context**
-   - Read through `docs/business/` folder for company vision, strategy, and market positioning
-   - Review existing business documents and market analysis
-   - Understand current product positioning and competitive landscape
-
-2. **Read Customer Insights**
-   - Review `docs/customer-insights/` folder for existing customer research
-   - Analyze previous customer interviews and feedback
-   - Identify patterns in customer pain points and needs
-
-3. **Analyze Codebase Context**
-   - Review current product features and capabilities
-   - Understand technical architecture and constraints
-   - Identify areas where customer feedback could inform development
-
-**PM provides unstructured input**:
-- Raw thoughts about current product state
-- Initial assumptions and hypotheses
-- Unstructured priorities and concerns
-- Any existing customer insights
-- Competitive concerns or opportunities
-
-**AI Agent Response**:
-- Acknowledge the brainstorming session with deep context understanding
-- Reference specific insights from business docs and customer research
-- Ask probing questions informed by existing knowledge
-- Identify key assumptions to explore based on current context
-
-### Step 2: Assumption Challenging & Exploration
-**AI Agent Brainstorming Process**:
-1. **Challenge Assumptions**
-   - "What makes you think [assumption] is true?"
-   - "Have you considered alternative perspectives?"
-   - "What evidence do you have for this assumption?"
-
-2. **Explore Alternatives**
-   - Suggest different customer segments
-   - Propose alternative problem definitions
-   - Consider different solution approaches
-
-3. **Identify Gaps**
-   - What assumptions need validation?
-   - What customer segments are missing?
-   - What competitive threats exist?
-
-### Step 3: Market Research & Validation
-**AI Agent Research Process**:
-1. **Market Research**
-   - Research industry trends and customer pain points
-   - Analyze competitive landscape
-   - Identify potential customer personas
-
-2. **Assumption Validation**
-   - Find evidence for/against assumptions
-   - Identify similar companies and their approaches
-   - Research customer segment characteristics
-
-3. **Opportunity Analysis**
-   - Identify market gaps
-   - Assess segment attractiveness
-   - Evaluate competitive positioning
-
-### Step 4: Strategic Recommendations
-**AI Agent Output**:
-- **Customer Segment Prioritization**: Ranked list of segments to interview
-- **Assumption Validation Map**: Key assumptions mapped to validation questions
-- **Interview Sequence**: Recommended order and rationale
-- **Risk Mitigation**: Potential risks and mitigation strategies
-
-### Step 5: Document Creation
-**AI Agent Final Action**:
-- Create strategic recommendations document in `docs/customer-insights/`
-- Use intuitive naming based on context (e.g., `ashley-market-niche-strategy.md`)
-- Include all research findings and recommendations
-- Provide actionable next steps for PM
-- Save document for future reference and team sharing
-
-## OUTPUT TEMPLATE
-
-### Strategic Recommendations Document
-**Template**: Retrieve via `get_fraim_file({ path: "templates/customer-development/strategic-recommendations-template.md" })`
-**File Location**: `docs/customer-development/[contextual-name].md` (e.g., `ashley-market-niche-strategy.md`)
-
-**Process**:
-1. Use the strategic recommendations template
-2. Fill in all sections with research findings and recommendations
-3. Save with contextual naming based on strategic focus
-4. Include specific customer names and companies when available
-5. Reference existing business documents and customer insights
-
-## EXAMPLES
-
-### Good: Strategic Brainstorming Session
-```
-PM: "Starting Strategic Brainstorming. We're building Ashley, an AI executive assistant. I think enterprise execs want AI to handle calendar conflicts automatically, but I'm not sure if that's right."
-
-AI Agent: "Perfect! I've reviewed your business docs and customer insights. I can see from your WhyAshley document that you're positioning Ashley as 'Your Agent for Time, Priorities, and Human Potential' and targeting enterprise executives. I also noticed from your existing customer interviews with Ronil, Sanjoy, and Olga that calendar conflict resolution came up as a key pain point across all three customers.
-
-However, I'm curious about your 'automatic' assumption. From your existing customer insights, I see that trust and delegation control were major themes - Ronil mentioned 'Don't have trust in tech to read email - need to have hands in it' and Sanjoy was concerned about 'Disturb during highly important meetings'. What makes you think they want it 'automatic' vs 'suggested'?"
-
-PM: "Good point. I guess I'm assuming automatic because that's what would save them the most time."
-
-AI Agent: "That's a reasonable assumption, but based on your existing customer feedback, there's a clear pattern of wanting control and oversight. Ronil mentioned wanting to 'observe for 2 weeks, then take action' and Olga talked about how good EAs 'enforce workback plans based on business priorities' rather than just doing what they're asked. What if we validated this by asking about their current delegation patterns and comfort levels with AI autonomy?"
-
-[Brainstorming continues with deep context...]
-
-AI Agent Output: Strategic recommendations document informed by existing business context and customer insights
-```
-
-### Bad: Surface-Level Brainstorming
-```
-PM: "We're building Ashley, an AI executive assistant. Who should we interview?"
-
-AI Agent: "You should interview enterprise executives."
-
-PM: "Okay, thanks."
-
-Result: No deep thinking, no assumption validation, no strategic recommendations
-```
-
-## SUCCESS METRICS
-- **Assumption Validation**: 80% of key assumptions have clear validation questions
-- **Customer Segment Clarity**: Clear rationale for segment prioritization
-- **Interview Readiness**: PM has clear next steps for customer interviews
-- **Risk Awareness**: Potential risks identified and mitigated

package/dist/registry/workflows/customer-development/thank-customers.md

@@ -1,203 +0,0 @@
-# Thank Customers Workflow
-
-## INTENT
-To automatically generate and send personalized thank you emails to customers whose feedback has been implemented, strengthening customer relationships and encouraging continued engagement.
-
-## PRINCIPLES
-- **Personal Touch**: Ashley's voice, grateful tone, "Thank you for making me better..."
-- **Voice & Pronouns**: Emails are written in first person from Ashley ("I", "me", "my"). When referring to Ashley in third person (outside the email body), use they/them pronouns. Avoid gendered pronouns for Ashley.
-- **Customer-Focused**: No technical jargon or issue numbers in customer emails
-- **Short and Sweet**: To the point, instructive, humble
-- **Encourage more feedback**: ChatGPT (https://ashley-chat.wellnessatwork.me) is the best way
-
-## WORKFLOW TRIGGER
-**User triggers this workflow manually**:
-- When customer issues are resolved and deployed
-- User says: "Generate thank you emails for customers" or similar
-
-## AI AGENT PROCESS
-
-### Step 1: Issue Retrieval
-**AI Agent calls function**:
-```typescript
-// Import helper functions directly from synced location
-const os = require('os');
-const path = require('path');
-const scriptsDir = path.join(os.homedir(), '.fraim', 'scripts');
-const scriptPath = path.join(scriptsDir, 'generate-engagement-emails.ts');
-
-import { getResolvedIssues, findExecutiveByEmail, getAshleyEmailForExecutive } from scriptPath;
-
-// Get issues resolved since last thank-you date (automatic) or user-specified date
-const resolvedIssues = await getResolvedIssues(); // Automatically uses latest thank-you date
-// OR with explicit date:
-const resolvedIssues = await getResolvedIssues('2025-10-29'); // Optional: user-specified date
-```
-
-**Note**: The `getResolvedIssues()` function automatically:
-- Finds the most recent date from existing `thank-you-candidates-YYYY-MM-DD.json` files where emails were sent (status: "sent")
-- Uses that date as the starting point to only fetch issues resolved AFTER that date
-- If no thank-you files exist, falls back to last 14 days
-- This ensures we never send duplicate thank-you emails for the same resolved issues
-
-### Step 2: Customer Information Extraction
-**AI Agent does intelligent extraction**:
-1. **Go through each resolved issue**
-2. **Extract customer email** from:
-   - Issue title format: `email@domain.com: summary`
-   - Issue body: look for email patterns
-   - If no email found, extract customer name and use database lookup
-3. **Extract customer name** from:
-   - Issue title or body
-   - Previous thank-you notes
-   - Onboarding insights documents
-
-### Step 3: Database Lookup
-**AI Agent calls function for each customer**:
-```typescript
-// Look up executive by customer email
-const executive = await findExecutiveByEmail(customerEmail);
-
-// Get Ashley email address for this executive
-const ashleyEmail = await getAshleyEmailForExecutive(executive.id);
-```
-
-### Step 4: Collate Issues by Customer
-**AI Agent organizes data**:
-- Group all resolved issues by customer email
-- **Consolidate customers with multiple email addresses** by matching customer names (case-insensitive)
-- When a customer has multiple emails, use the primary email from the database lookup
-- Output customer list to console for verification
-
-### Step 5: Generate Single Thank-You File
-**AI Agent creates ONE file**:
-- File: `docs/customer-development/thank-you-notes/thank-you-candidates-YYYY-MM-DD.json`
-- Format: Structured JSON (not markdown) for easy parsing by mail sending script
-- Contains ALL customers and their personalized emails
-- **AI Agent writes the email content** - be creative, personal, and contextual!
-- Follow principles: personal touch, customer-focused, short and sweet, encourage feedback
-- **NO TECHNICAL JARGON**: Do not mention issue numbers, BAML, internal systems, or technical details
-- **CUSTOMER EXPERIENCE FOCUS**: Describe what was broken from the user's perspective, what was fixed, and how they can verify it works
-- **First-person Email Body**: Use "I" for actions Ashley took (e.g., "I fixed", "I now", "I will"), not "Ashley" or "she". Sign off as Ashley.
-- Include `From:` field showing Ashley email from PPE (via `getAshleyEmailForExecutive()`)
-
-**File format** (JSON):
-```json
-{
-   "metadata": {
-     "generatedOn": "2025-10-29T02:29:02.497Z",
-     "issuesResolvedSince": "2025-10-28",
-     "totalCustomers": 2,
-     "totalIssues": 3
-   },
-   "candidates": [
-     {
-       "customer": {
-         "name": "Olga Ivanova",
-         "email": "olga.ivanova@gmail.com"
-       },
-       "executive": {
-         "name": "Olga Ivanova",
-         "id": "exec-..."
-       },
-       "status": "pending",
-       "from": {
-         "displayName": "Ashley - Olga Ivanova's AI Executive Assistant",
-         "email": "ashley+olga@ashleycalendar.ai"
-       },
-       "to": "olga.ivanova@gmail.com",
-       "subject": "Thank you for your feedback - your issues have been addressed!",
-       "greeting": "Hi Olga,",
-       "opening": "Thank you for making me better! I wanted to personally reach out because your feedback helped us catch and fix an important bug.",
-       "improvements": [
-         {
-           "title": "Issue filing feature",
-           "description": "The issue filing feature is now working properly - when you ask me to file a bug or feature request through voice, I'll handle it correctly.",
-           "verification": "Try asking me to file a bug or feature request and it should work smoothly now."
-         }
-       ],
-       "closing": "Your quick feedback saved you (and others) frustration down the line. That kind of real-time input makes all the difference as I'm learning."
-     }
-   ]
- }
-```
-
-**Note**: The structured format allows the HTML template to format each section beautifully:
-- `greeting`: Personal greeting (e.g., "Hi Olga,")
-- `opening`: Opening paragraph - thanks and context
-- `improvements[]`: Array of improvements (title, description, optional verification step)
-- `closing`: Closing paragraph - encouraging more feedback
-
-The HTML template formats each section with appropriate styling.
-
-### Step 6: User Review
-**AI Agent**:
-1. **Points user to the generated file**: `docs/customer-development/thank-you-notes/thank-you-candidates-YYYY-MM-DD.json`
-2. **Requests review** and any edits needed (user can edit JSON directly)
-3. **Waits for user approval** before proceeding
-
-**Note**: Each email section includes a `From:` field showing the display name and email address that will be used when sending. The signature includes a humble note about ramping up, without displaying a generic email address.
-
-### Step 7: Send Emails (Separate Command)
-**When user says "Send the emails" or similar**:
-
-**AI Agent calls function**:
-```typescript
-// Import helper functions directly from synced location
-const os = require('os');
-const path = require('path');
-const scriptsDir = path.join(os.homedir(), '.fraim', 'scripts');
-const scriptPath = path.join(scriptsDir, 'generate-engagement-emails.ts');
-
-import { sendCustomerMail } from scriptPath;
-
-// Send emails from the candidates JSON file (all pending candidates)
-await sendCustomerMail('docs/customer-development/thank-you-notes/thank-you-candidates-YYYY-MM-DD.json');
-
-// OR send to a specific executive only (optional)
-await sendCustomerMail('docs/customer-development/thank-you-notes/thank-you-candidates-YYYY-MM-DD.json', 'exec-1761011032377-q36j91sdl');
-```
-
-**Note**: The `sendCustomerMail` function parses JSON (not markdown) for easy, deterministic parsing.
-
-**Function parameters**:
-- `candidatesFilePath` (required): Path to the JSON candidates file
-- `executiveId` (optional): If provided, only sends emails for candidates matching this executive ID. If omitted, sends to all pending candidates.
-
-**This function will**:
-- Parse the JSON candidates file
-- If `executiveId` is provided, filter to only that executive's candidates
-- For each candidate with `status: "pending"`, send email
-- Use the `from` field (displayName and email) specified in JSON
-- Use the `to`, `subject`, and `body` fields from JSON
-- Update the JSON file after each send with status: `"sent"` or `"failed"`
-- Skip candidates that already have status `"sent"` or `"failed"`
-
-## REQUIRED FUNCTIONS IN SCRIPT
-
-The script must provide these deterministic functions for AI agents to call:
-
-```typescript
-// Get resolved issues since a date
-export async function getResolvedIssues(date: string): Promise<ResolvedIssue[]>
-
-// Find executive by email in PPE database  
-export async function findExecutiveByEmail(email: string): Promise<Executive | null>
-
-// Get Ashley email for executive from PPE database
-export async function getAshleyEmailForExecutive(executiveId: string): Promise<string>
-
-// Send emails from candidates file
-// executiveId is optional - if provided, only sends to that executive; if omitted, sends to all pending
-export async function sendCustomerMail(candidatesFilePath: string, executiveId?: string): Promise<void>
-```
-
-**Note**: The script provides ONLY data retrieval and sending. The AI agent does ALL intelligent work:
-- Extracts customer info from issues (intelligent parsing)
-- Writes personalized, creative email content (better than hardcoded templates!)
-- Organizes and formats the candidates file
-
-## WORKFLOW COMPLETION
-
-**Generate workflow completes with**: Single candidates file ready for review
-**Send workflow completes with**: All emails sent and file updated with status

package/dist/registry/workflows/customer-development/user-survey-dispatch.md

@@ -1,312 +0,0 @@
----
-{
-  "name": "user-survey-dispatch",
-  "initialPhase": "survey-scoping",
-  "phases": {
-    "survey-scoping": {
-      "onSuccess": "survey-build-linkedin",
-      "onFailure": "survey-scoping"
-    },
-    "survey-build-linkedin": {
-      "onSuccess": "survey-build-reddit",
-      "onFailure": "survey-scoping"
-    },
-    "survey-build-reddit": {
-      "onSuccess": "survey-build-x",
-      "onFailure": "survey-scoping"
-    },
-    "survey-build-x": {
-      "onSuccess": "survey-build-facebook",
-      "onFailure": "survey-scoping"
-    },
-    "survey-build-facebook": {
-      "onSuccess": "survey-build-custom",
-      "onFailure": "survey-scoping"
-    },
-    "survey-build-custom": {
-      "onSuccess": "survey-dispatch",
-      "onFailure": "survey-scoping"
-    },
-    "survey-dispatch": {
-      "onSuccess": null,
-      "onFailure": "survey-dispatch"
-    }
-  }
-}
----
-# FRAIM Workflow: user-survey-dispatch
-
-## Workflow Activation
-Start by calling the mentor to track your progress:
-
-```javascript
-seekMentoring({
-  workflowType: "user-survey-dispatch",
-  issueNumber: "{issue_number}",
-  currentPhase: "survey-scoping", 
-  status: "starting"
-})
-```
-
-## Intent
-Engage target audiences across multiple social platforms through structured polls and surveys to gather quantitative and qualitative insights for product validation.
-
-## Overview
-This workflow guides you through formulating the right questions, tailoring them for different platforms (LinkedIn, Reddit, X, etc.), and executing the distribution using browser automation.
-
-## Roles & Responsibilities
-To ensure smooth execution, this workflow divides tasks between the AI Agent and the User.
-
-### 🤖 Agent Responsibilities
-- **Strategy**: Define survey goals, questions, and platforms.
-- **Content Creation**: Draft high-quality post copy and poll options.
-- **Browser Automation**: Open the browser, navigate to platforms, and **draft** the content into the post editor.
-- **Context**: Provide specific copy-paste text if automation fails.
-
-### 👤 User Responsibilities
-- **Authentication**: Log in to social platforms (LinkedIn, Reddit, X) if the session is expired.
-- **Verification**: Visually confirm the post text and poll options in the browser.
-- **Final Action**: Click the "Post" or "Tweet" button manually.
-- **Validation**: Explicitly confirm to the agent that the task is done.
-
----
-
-## Phase: survey-scoping
-
-### Objective
-Define the survey's goals, target audience characteristics, and formulate a set of refined questions optimized for audience segmentation and actionable insights.
-
-### Key Questions to Ask
-
-#### Goal Alignment
-1. "What is the single most important thing you want to learn from this survey?"
-2. "How will the answers to these questions change your product roadmap or strategy?"
-3. "Are you looking for qualitative feedback (stories/pain points) or quantitative data (stats/preferences)?"
-
-#### Audience Definition
-4. "Who specifically should be answering this survey? (Job titles, interests, communities)"
-5. "What background knowledge should the respondent have?"
-
-#### Question Design
-6. "Which question will help you disqualify respondents who are NOT in your target market?"
-7. "How can we phrase these questions to avoid leading the witness or bias?"
-8. "What specific 'demographic' or 'psychographic' data points do you need (e.g., industry, company size, frequency of problem)?"
-
-### Validation Criteria
-
-#### Scope Definition
-- [ ] Primary research goal clearly articulated.
-- [ ] Target segment defined with specific characteristics.
-- [ ] Success metrics for the survey (e.g., number of responses, specific insights) established.
-
-#### Question Quality
-- [ ] Disqualification question included to filter non-target respondents.
-- [ ] Questions are open-ended for qualitative phases.
-- [ ] Binary or Scale-based questions included for quantitative phases.
-- [ ] Total number of questions is limited to maximize completion rates (usually < 5 for social polls).
-
-### Report Back:
-When you complete this phase, call:
-
-```javascript
-seekMentoring({
-  workflowType: "user-survey-dispatch",
-  issueNumber: "{issue_number}",
-  currentPhase: "survey-scoping", 
-  status: "complete",
-  evidence: {
-    planPath: "docs/surveys/{id}-survey-plan.md"
-  }
-})
-```
-
----
-
-## Phase: survey-build-linkedin
-
-{{include:orchestration/parallelization-guidance.md}}
-
-### Objective
-Generate LinkedIn-optimized survey content, including professional post copy and poll options.
-
-### Key Actions
-1. **Optimize for Feed**: Write a hook that stops the scroll for professionals.
-2. **Poll Configuration**: Define clear, mutually exclusive poll options (max 30 chars per option).
-3. **Hashtag Strategy**: Identify 3-5 high-reach professional hashtags.
-4. **Call to Action**: Encourage comments for deeper qualitative feedback.
-
-### Report Back:
-When you complete this phase, call:
-
-```javascript
-seekMentoring({
-  workflowType: "user-survey-dispatch",
-  issueNumber: "{issue_number}",
-  currentPhase: "survey-build-linkedin", 
-  status: "complete",
-  evidence: {
-    postCopy: "LinkedIn post content",
-    pollOptions: ["Option 1", "Option 2"]
-  }
-})
-```
-
----
-
-## Phase: survey-build-reddit
-
-### Objective
-Generate Reddit-specific posts for targeted subreddits, ensuring compliance with community rules and "Reddiquette."
-
-### Key Actions
-1. **Subreddit Selection**: Identify 2-3 specific subreddits (e.g., /r/startups, /r/SaaS).
-2. **Rule Verification**: Read the "About" section or Wiki of target subreddits to check rules.
-3. **Conversational Tone**: Use a less formal, more community-oriented tone.
-4. **Value First**: Explicitly state why the community should care.
-
-### Report Back:
-When you complete this phase, call:
-
-```javascript
-seekMentoring({
-  workflowType: "user-survey-dispatch",
-  issueNumber: "{issue_number}",
-  currentPhase: "survey-build-reddit", 
-  status: "complete",
-  evidence: {
-    subreddit: "/r/startups",
-    postCopy: "Reddit post content"
-  }
-})
-```
-
----
-
-## Phase: survey-build-x
-
-### Objective
-Generate short-form, high-engagement content for X (Twitter), including poll copy or threaded questions.
-
-### Key Actions
-1. **Brevity**: Ensure copy fits within character limits (280 characters).
-2. **Engagement Hook**: Create a concise "Question of the Day" format.
-3. **Poll Duration**: Recommend optimal poll duration (e.g., 24 hours or 7 days).
-
-### Report Back:
-When you complete this phase, call:
-
-```javascript
-seekMentoring({
-  workflowType: "user-survey-dispatch",
-  issueNumber: "{issue_number}",
-  currentPhase: "survey-build-x", 
-  status: "complete",
-  evidence: {
-    tweetCopy: "X post content"
-  }
-})
-```
-
----
-
-## Phase: survey-build-facebook
-
-### Objective
-Generate content for Facebook Groups or Profiles, focusing on community engagement and personal networking.
-
-### Key Actions
-1. **Group Identification**: List target Facebook Groups.
-2. **Contextual Hook**: Frame the survey as a "seeking advice" post.
-3. **Admin Check**: Remind the user to check with Group Admins if required.
-
-### Report Back:
-When you complete this phase, call:
-
-```javascript
-seekMentoring({
-  workflowType: "user-survey-dispatch",
-  issueNumber: "{issue_number}",
-  currentPhase: "survey-build-facebook", 
-  status: "complete",
-  evidence: {
-    groupName: "GroupName",
-    postCopy: "Facebook post content"
-  }
-})
-```
-
----
-
-## Phase: survey-build-custom
-
-### Objective
-Assess the need for additional platforms (Discord, Slack, Instagram) and generate custom copy accordingly.
-
-### Report Back:
-When you complete this phase, call:
-
-```javascript
-seekMentoring({
-  workflowType: "user-survey-dispatch",
-  issueNumber: "{issue_number}",
-  currentPhase: "survey-build-custom", 
-  status: "complete",
-  evidence: {
-    platform: "Discord/Slack",
-    postCopy: "Markdown content"
-  }
-})
-```
-
----
-
-## Phase: survey-dispatch
-
-{{include:orchestration/parallelization-guidance.md}}
-
-### Objective
-Execute the survey distribution across the prepared platforms using browser automation (Playwright).
-
-### 🛑 CRITICAL VALIDATION RULE
-The Agent must **NEVER** mark this phase as `complete` until the User has explicitly confirmed the post has been published.
-
-### Agent Instructions (Playwright)
-**CRITICAL**: Use Playwright MCP tools to interact with platforms. Do NOT rely on hard-coded selectors.
-
-#### Pre-Authentication (Before Starting)
-**BEFORE beginning dispatch**, ask the user to log in to ALL required platforms simultaneously:
-- "Please log in to LinkedIn, Reddit, X (Twitter), and Facebook in separate browser tabs. Let me know when all platforms are authenticated and ready."
-
-**Then proceed systematically through each platform** without stopping for authentication issues.
-
-#### General Dispatch Process
-1. **Navigate**: Go to the platform URL.
-2. **Login Verification**: If login form is visible, ask user: "I need you to log in to [Platform Name]. Please complete the login and let me know when it's ready." **Wait for confirmation before continuing.**
-3. **Drafting**: Locate the "Start a post" or "Create post" button and open the editor.
-4. **Filling**: Enter the copy generated in previous phases into the post editor.
-5. **Poll Creation**: Click the "Add Poll" button and fill in options (if automation supports it).
-6. **Fallback**: If automation fails (e.g., complex dialogs, authentication issues), **immediately provide the text and options in the chat** for the user to copy-paste.
-7. **Hand-off**: Ask the user: *"I have drafted the post. Please check the browser, complete any missing details, and click Post. Let me know when you are done."*
-8. **Systematic Execution**: Complete each platform fully before moving to the next. Do not skip platforms or give up due to login issues.
-9. **Completion**: Only call `seekMentoring(status: "complete")` **AFTER** the user says "Done", "Posted", or explicitly confirms publication for all platforms.
-
-#### Platform-Specific Guidance
-- **LinkedIn**: Look for `button[name="Start a post"]` and the "Create a poll" icon.
-- **Reddit**: Navigate to `reddit.com/r/[subreddit]/submit` and select the "Poll" or "Post" tab.
-- **X (Twitter)**: Locate the "Post" button or the large "What is happening?!" textbox and click the "Poll" icon.
-
-### Report Back:
-When you complete this phase (only after user confirmation), call:
-
-```javascript
-seekMentoring({
-  workflowType: "user-survey-dispatch",
-  issueNumber: "{issue_number}",
-  currentPhase: "survey-dispatch", 
-  status: "complete",
-  evidence: {
-    platformDispatched: ["LinkedIn", "Reddit", "X"],
-    postUrls: ["url1", "url2"]
-  }
-})
-```