feat: add discovery files sync commands and update documentation

prds/AgentMail-ideas.md

@@ -0,0 +1,114 @@
+# AgentMail Integration Ideas for Markdown Blog
+
+Ideas for integrating [AgentMail](https://agentmail.to/) into the markdown blog application to enhance developer experience, user experience, and interactive features.
+
+## Developer Experience (Building)
+
+### 1. Email-to-Post Workflow
+
+- Developers email markdown content to a dedicated inbox
+- Agent automatically creates draft posts from email content
+- Handle attachments (images) - agent processes and uploads them
+- Use subject line tags like `[draft]` or `[publish]` for workflow control
+
+### 2. Content Curation Agent
+
+- Agent monitors RSS feeds or URLs and automatically creates post drafts
+- Email agent URLs to import as markdown posts
+- Email threads for review/approval workflows before publishing
+
+### 3. Newsletter Management
+
+- Automated weekly/monthly digest emails sent to subscribers
+- Agent compiles recent posts and formats email newsletters
+- Reply-to support for subscriber engagement
+
+### 4. Developer Notifications
+
+- Daily/weekly stats summaries via email
+- New subscriber alerts
+- Email replies/comments notifications
+- RSS feed validation alerts
+
+## User Experience (Reading)
+
+### 5. Email Subscriptions
+
+- Users subscribe to all posts or specific tags
+- Get new post notifications or digests
+- Include post excerpts with "read more" links
+
+### 6. Email Newsletter
+
+- Weekly/monthly digest of new posts
+- Group by tags or themes
+- Personalization based on reading history
+
+### 7. Reply via Email
+
+- Users reply to post notification emails to comment
+- Thread conversations via email
+- Agents parse and add replies to posts/pages
+
+## Interactive Features (Receiving)
+
+### 8. Email-Based Contact
+
+- Contact form sends via AgentMail
+- Agent categorizes inquiries (support, feedback, collaboration)
+- Auto-reply confirmations
+- Forward to appropriate team member
+
+### 9. Guest Post Submissions
+
+- Accept guest post submissions via email
+- Agent validates markdown format
+- Creates draft posts for review
+- Sends confirmation/rejection emails
+
+### 10. Feedback and Comments
+
+- Readers email feedback on posts
+- Agent extracts relevant quotes
+- Creates comment threads or feedback summaries
+- Send thank-you emails
+
+### 11. Content Requests
+
+- Email topics to request
+- Agent creates feature requests or drafts
+- Track requests in Convex table
+- Follow up on status
+
+## Advanced Integrations
+
+### 12. AI-Powered Content Assistant
+
+- Email content questions to agent
+- Agent searches your blog content
+- Replies with relevant excerpts and links
+- Uses semantic search on your posts
+
+### 13. Automated Outreach
+
+- Agent identifies external blogs for cross-posting
+- Sends personalized outreach emails
+- Tracks responses and follow-ups
+
+### 14. Community Engagement
+
+- Weekly community email with top posts, comments, discussions
+- Agent compiles engagement metrics
+- Personalizes based on subscriber preferences
+
+## Implementation Strategy
+
+**Start Simple:**
+
+1. Email subscriptions - readers subscribe, receive new post notifications
+2. Contact form - replace or augment current contact page
+3. Developer notifications - stats summaries and alerts
+
+**Then Expand:** 4. Email-to-post workflow - content creation via email 5. Newsletter automation - scheduled digests 6. Interactive features - email comments and feedback
+
+The key advantage of AgentMail is that agents can handle email interactions autonomously without OAuth/MFA hassles, so you can create truly autonomous workflows that integrate with your Convex backend.