aidevops 2.52.1

package/.agent/marketing.md

@@ -0,0 +1,440 @@
+---
+name: marketing
+description: Marketing strategy and campaigns - digital marketing, analytics, brand management
+mode: subagent
+tools:
+  read: true
+  write: true
+  edit: true
+  bash: true
+  glob: true
+  grep: true
+  webfetch: true
+---
+
+# Marketing - Main Agent
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Purpose**: Marketing strategy, campaign execution, and analytics
+- **CRM Integration**: FluentCRM MCP for email marketing and automation
+
+**Related Agents**:
+
+- `content.md` - Content creation and copywriting
+- `seo.md` - Search optimization
+- `sales.md` - Sales alignment and lead handoff
+- `services/crm/fluentcrm.md` - CRM operations (detailed)
+
+**FluentCRM MCP Tools**:
+
+| Category | Key Tools |
+|----------|-----------|
+| **Campaigns** | `fluentcrm_list_campaigns`, `fluentcrm_create_campaign`, `fluentcrm_pause_campaign`, `fluentcrm_resume_campaign` |
+| **Templates** | `fluentcrm_list_email_templates`, `fluentcrm_create_email_template` |
+| **Automations** | `fluentcrm_list_automations`, `fluentcrm_create_automation` |
+| **Lists** | `fluentcrm_list_lists`, `fluentcrm_create_list`, `fluentcrm_attach_contact_to_list` |
+| **Tags** | `fluentcrm_list_tags`, `fluentcrm_create_tag`, `fluentcrm_attach_tag_to_contact` |
+| **Smart Links** | `fluentcrm_create_smart_link`, `fluentcrm_generate_smart_link_shortcode` |
+| **Reports** | `fluentcrm_dashboard_stats` |
+
+**Typical Tasks**:
+
+- Email campaign creation and management
+- Marketing automation setup
+- Audience segmentation
+- Lead nurturing sequences
+- Campaign performance analysis
+
+<!-- AI-CONTEXT-END -->
+
+## Email Marketing
+
+### FluentCRM Setup
+
+FluentCRM provides self-hosted email marketing with full API access via MCP.
+
+**Prerequisites**:
+
+1. FluentCRM plugin installed on WordPress
+2. Application password created for API access
+3. FluentCRM MCP server configured
+4. Email sending configured (SMTP or SES)
+
+**Environment Setup**:
+
+> **Security Note**: Never commit actual credentials to version control. Store environment variables in `~/.config/aidevops/mcp-env.sh` (600 permissions). Rotate application passwords regularly.
+
+```bash
+# Add to ~/.config/aidevops/mcp-env.sh
+export FLUENTCRM_API_URL="https://your-domain.com/wp-json/fluent-crm/v2"
+export FLUENTCRM_API_USERNAME="your_username"
+export FLUENTCRM_API_PASSWORD="your_application_password"
+```
+
+See `.agent/services/crm/fluentcrm.md` for detailed setup instructions.
+
+## Campaign Management
+
+### Campaign Types
+
+| Type | Use Case | FluentCRM Feature |
+|------|----------|-------------------|
+| **Newsletter** | Regular updates | Email Campaign |
+| **Promotional** | Sales and offers | Email Campaign |
+| **Nurture** | Lead education | Automation Funnel |
+| **Transactional** | Order confirmations | Automation Funnel |
+| **Re-engagement** | Win back inactive | Automation Funnel |
+
+### Creating a Campaign
+
+```text
+1. Create email template
+   fluentcrm_create_email_template with:
+   - title: "Campaign Name - Template"
+   - subject: "Your Subject Line"
+   - body: HTML content
+
+2. Create campaign
+   fluentcrm_create_campaign with:
+   - title: "Campaign Name"
+   - subject: "Email Subject"
+   - template_id: template ID from step 1
+   - recipient_list: [list IDs]
+
+3. Review in FluentCRM admin
+4. Schedule or send immediately
+```
+
+### Campaign Workflow
+
+1. **Plan** - Define goals, audience, messaging
+2. **Create** - Build template and campaign
+3. **Test** - Send test emails, check rendering
+4. **Schedule** - Set send time for optimal engagement
+5. **Monitor** - Track opens, clicks, conversions
+6. **Optimize** - A/B test and improve
+
+## Email Templates
+
+### Template Best Practices
+
+| Element | Best Practice |
+|---------|---------------|
+| **Subject** | 40-60 chars, personalized, clear value |
+| **Preheader** | Complement subject, 40-100 chars |
+| **Header** | Logo, clear branding |
+| **Body** | Single column, scannable, mobile-first |
+| **CTA** | Clear, contrasting button, above fold |
+| **Footer** | Unsubscribe link, contact info, social |
+
+### Template Variables
+
+FluentCRM supports personalization:
+
+```html
+{{contact.first_name}} - First name
+{{contact.last_name}} - Last name
+{{contact.email}} - Email address
+{{contact.full_name}} - Full name
+{{contact.custom.field_name}} - Custom fields
+```
+
+### Creating Templates
+
+```text
+fluentcrm_create_email_template with:
+- title: "Welcome Email Template"
+- subject: "Welcome to {{company_name}}, {{contact.first_name}}!"
+- body: "<html>...</html>"
+```
+
+## Marketing Automation
+
+### Automation Triggers
+
+| Trigger | Use Case |
+|---------|----------|
+| `tag_added` | When tag is applied |
+| `list_added` | When contact joins list |
+| `form_submitted` | When form is completed |
+| `link_clicked` | When email link is clicked |
+| `email_opened` | When email is opened |
+
+### Common Automation Sequences
+
+#### Welcome Sequence
+
+```text
+Trigger: list_added (Newsletter list)
+Day 0: Welcome email
+Day 2: Value content email
+Day 5: Product introduction
+Day 7: Social proof / testimonials
+Day 10: Soft CTA
+```
+
+#### Lead Nurture Sequence
+
+```text
+Trigger: tag_added (lead-mql)
+Day 0: Educational content
+Day 3: Case study
+Day 7: Comparison guide
+Day 10: Demo invitation
+Day 14: Follow-up if no response
+```
+
+#### Re-engagement Sequence
+
+```text
+Trigger: tag_added (inactive-90-days)
+Day 0: "We miss you" email
+Day 3: Best content roundup
+Day 7: Special offer
+Day 14: Last chance + unsubscribe option
+```
+
+### Creating Automations
+
+```text
+fluentcrm_create_automation with:
+- title: "Welcome Sequence"
+- description: "New subscriber welcome series"
+- trigger: "list_added"
+
+Then configure steps in FluentCRM admin:
+1. Add email actions
+2. Set delays between emails
+3. Add conditions and branches
+4. Set exit conditions
+```
+
+## Audience Segmentation
+
+### Segmentation Strategies
+
+| Segment Type | Tags/Lists | Use Case |
+|--------------|------------|----------|
+| **Demographic** | industry-*, company-size-* | Targeted messaging |
+| **Behavioral** | engaged-*, downloaded-* | Engagement-based |
+| **Lifecycle** | lead-*, customer-* | Stage-appropriate |
+| **Interest** | interest-*, product-* | Relevant content |
+| **Source** | source-*, campaign-* | Attribution |
+
+### Creating Segments
+
+```text
+# Create list for segment
+fluentcrm_create_list with:
+- title: "Enterprise Prospects"
+- slug: "enterprise-prospects"
+- description: "Companies with 500+ employees interested in enterprise plan"
+
+# Add contacts matching criteria
+fluentcrm_attach_contact_to_list with subscriberId and listIds
+```
+
+### Dynamic Segmentation
+
+Use tags for dynamic segments that update automatically:
+
+```text
+# Create behavior tags
+fluentcrm_create_tag with:
+- title: "Engaged - Last 30 Days"
+- slug: "engaged-30-days"
+
+# Automation applies/removes based on activity
+```
+
+## Smart Links
+
+### Trackable Links
+
+Smart Links track clicks and can trigger actions:
+
+```text
+fluentcrm_create_smart_link with:
+- title: "Product Demo CTA"
+- slug: "demo-cta"
+- target_url: "https://your-site.com/demo"
+- apply_tags: [tag_id for 'clicked-demo-cta']
+```
+
+### Use Cases
+
+| Use Case | Configuration |
+|----------|---------------|
+| **Content tracking** | Apply interest tags on click |
+| **Lead scoring** | Apply engagement tags |
+| **Segmentation** | Add to lists on click |
+| **Retargeting** | Tag for ad audiences |
+
+### Generating Shortcodes
+
+```text
+fluentcrm_generate_smart_link_shortcode with:
+- slug: "demo-cta"
+- linkText: "Request a Demo"
+
+Returns: <a href="{{fc_smart_link slug='demo-cta'}}">Request a Demo</a>
+```
+
+## Content Marketing Integration
+
+### Content to Campaign Workflow
+
+1. **Create content** using `content.md` agent
+2. **Optimize for SEO** using `seo.md` agent
+3. **Create email** promoting content
+4. **Segment audience** by interest
+5. **Send campaign** to relevant segments
+6. **Track engagement** and conversions
+
+### Content Promotion Campaigns
+
+```text
+# For each new blog post:
+1. Create email template with post excerpt
+2. Create campaign targeting relevant interest tags
+3. Add smart link to track clicks
+4. Schedule for optimal send time
+```
+
+## Lead Generation
+
+### Lead Magnet Workflow
+
+1. **Create lead magnet** (ebook, guide, template)
+2. **Create landing page** with form
+3. **Create FluentCRM list** for leads
+4. **Set up automation** for delivery
+5. **Create nurture sequence** for follow-up
+
+### Form Integration
+
+FluentCRM integrates with:
+
+- Fluent Forms
+- WPForms
+- Gravity Forms
+- Contact Form 7
+- Custom forms via API
+
+### Lead Handoff to Sales
+
+```text
+# When lead is qualified:
+1. Apply 'lead-mql' tag
+2. Automation notifies sales team
+3. Sales reviews and accepts
+4. Apply 'lead-sql' tag
+5. Remove from marketing sequences
+```
+
+## Analytics & Reporting
+
+### Key Metrics
+
+| Metric | Target | How to Improve |
+|--------|--------|----------------|
+| **Open Rate** | 20-30% | Better subjects, send time |
+| **Click Rate** | 2-5% | Better CTAs, content |
+| **Conversion Rate** | 1-3% | Landing page optimization |
+| **Unsubscribe Rate** | <0.5% | Better targeting, frequency |
+| **List Growth** | 5-10%/mo | More lead magnets, promotion |
+
+### Dashboard Stats
+
+```text
+fluentcrm_dashboard_stats
+
+Returns:
+- Total contacts
+- New contacts this period
+- Email engagement metrics
+- Campaign performance
+```
+
+### Campaign Analysis
+
+After each campaign:
+
+1. Review open and click rates
+2. Analyze by segment performance
+3. Identify top-performing content
+4. Note unsubscribes and complaints
+5. Document learnings for future
+
+## A/B Testing
+
+### What to Test
+
+| Element | Test Ideas |
+|---------|------------|
+| **Subject Line** | Length, personalization, emoji |
+| **Send Time** | Day of week, time of day |
+| **From Name** | Company vs. person |
+| **CTA** | Button text, color, placement |
+| **Content** | Long vs. short, format |
+
+### Testing Process
+
+1. Create two template variations
+2. Split audience randomly
+3. Send to small test group (10-20%)
+4. Wait for results (24-48 hours)
+5. Send winner to remaining audience
+
+## Best Practices
+
+### Email Deliverability
+
+- Warm up new sending domains
+- Maintain clean lists (remove bounces)
+- Use double opt-in
+- Monitor sender reputation
+- Authenticate with SPF, DKIM, DMARC
+
+### List Hygiene
+
+- Remove hard bounces immediately
+- Re-engage or remove inactive (90+ days)
+- Honor unsubscribes instantly
+- Validate emails on import
+
+### Compliance
+
+| Regulation | Requirements |
+|------------|--------------|
+| **GDPR** | Explicit consent, right to erasure |
+| **CAN-SPAM** | Unsubscribe link, physical address |
+| **CASL** | Express consent, identification |
+
+### Frequency
+
+- Newsletter: Weekly or bi-weekly
+- Promotional: 2-4 per month max
+- Transactional: As needed
+- Nurture: Spaced 2-5 days apart
+
+## Troubleshooting
+
+### Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| Low open rates | Test subjects, check deliverability |
+| High unsubscribes | Review frequency, improve targeting |
+| Bounces | Clean list, validate emails |
+| Spam complaints | Better consent, relevant content |
+| Template rendering | Test across email clients |
+
+### Getting Help
+
+- FluentCRM Docs: https://fluentcrm.com/docs/
+- FluentCRM REST API: https://rest-api.fluentcrm.com/
+- See `.agent/services/crm/fluentcrm.md` for detailed troubleshooting

package/.agent/memory/README.md

@@ -0,0 +1,260 @@
+---
+description: Memory template directory documentation
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: true
+  glob: true
+  grep: true
+  webfetch: false
+  task: true
+---
+
+# Memory System
+
+Cross-session memory for AI assistants using SQLite FTS5 for fast full-text search.
+
+**Motto**: "Compound, then clear" - Sessions should build on each other.
+
+## Quick Start
+
+```bash
+# Store a memory
+~/.aidevops/agents/scripts/memory-helper.sh store --type "WORKING_SOLUTION" --content "Fixed CORS with nginx headers" --tags "cors,nginx"
+
+# Recall memories
+~/.aidevops/agents/scripts/memory-helper.sh recall "cors"
+
+# Show recent memories
+~/.aidevops/agents/scripts/memory-helper.sh recall --recent
+
+# View statistics
+~/.aidevops/agents/scripts/memory-helper.sh stats
+```
+
+## Slash Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/remember {content}` | Store a memory with AI-assisted categorization |
+| `/recall {query}` | Search memories by keyword |
+| `/recall --recent` | Show 10 most recent memories |
+| `/recall --stats` | Show memory statistics |
+
+See `scripts/commands/remember.md` and `scripts/commands/recall.md` for full documentation.
+
+## Memory Types
+
+| Type | Use For |
+|------|---------|
+| `WORKING_SOLUTION` | Fixes that worked |
+| `FAILED_APPROACH` | What didn't work (avoid repeating) |
+| `CODEBASE_PATTERN` | Project conventions |
+| `USER_PREFERENCE` | Developer preferences |
+| `TOOL_CONFIG` | Tool setup notes |
+| `DECISION` | Architecture decisions |
+| `CONTEXT` | Background info |
+
+## Storage Location
+
+```text
+~/.aidevops/.agent-workspace/memory/
+├── memory.db           # SQLite database with FTS5
+└── preferences/        # Optional: markdown preference files
+```
+
+## CLI Reference
+
+```bash
+# Store with project context
+memory-helper.sh store --type "TYPE" --content "content" --tags "tags" --project "project-name"
+
+# Search with filters
+memory-helper.sh recall "query" --type WORKING_SOLUTION --project myapp --limit 20
+
+# Show recent memories
+memory-helper.sh recall --recent 10
+
+# Maintenance
+memory-helper.sh validate          # Check for stale entries
+memory-helper.sh prune --dry-run   # Preview cleanup
+memory-helper.sh prune             # Remove stale entries
+
+# Export
+memory-helper.sh export --format json   # Export as JSON
+memory-helper.sh export --format toon   # Export as TOON (token-efficient)
+```
+
+## Legacy: File-Based Preferences
+
+For detailed preference files (optional, complements SQLite):
+
+```text
+~/.aidevops/.agent-workspace/memory/preferences/
+├── coding-style.md
+├── workflow.md
+└── project-specific/
+    └── wordpress.md
+```
+
+## Developer Preferences Memory
+
+### Purpose
+
+Maintain a consistent record of developer preferences across coding sessions to:
+
+- Ensure AI assistants provide assistance aligned with the developer's preferred style
+- Reduce the need for developers to repeatedly explain their preferences
+- Create a persistent context across tools and sessions
+
+### How AI Assistants Should Use Preferences
+
+1. **Before starting work**: Check `~/.aidevops/.agent-workspace/memory/preferences/` for relevant preferences
+2. **During development**: Apply established preferences to suggestions and code
+3. **When feedback is given**: Update preference files to record new preferences
+4. **When switching projects**: Check for project-specific preference files
+
+### Preference Categories to Track
+
+#### Code Style Preferences
+
+```markdown
+# ~/.aidevops/.agent-workspace/memory/preferences/coding-style.md
+
+## General
+- Preferred indentation: [tabs/spaces, count]
+- Line length limit: [80/100/120]
+- Quote style: [single/double]
+
+## Language-Specific
+### JavaScript/TypeScript
+- Semicolons: [yes/no]
+- Arrow functions: [preferred/when-appropriate]
+
+### Python
+- Type hints: [always/public-only/never]
+- Docstring style: [Google/NumPy/Sphinx]
+
+### PHP
+- WordPress coding standards: [yes/no]
+- PSR-12: [yes/no]
+```
+
+#### Documentation Preferences
+
+```markdown
+# ~/.aidevops/.agent-workspace/memory/preferences/documentation.md
+
+## Code Comments
+- Prefer: [minimal/moderate/extensive]
+- JSDoc/PHPDoc: [always/public-only/never]
+
+## Project Documentation
+- README format: [brief/comprehensive]
+- Changelog style: [Keep a Changelog/custom]
+
+## AI Assistant Documentation
+- Token-efficient: [yes/no]
+- Reference external files: [yes/no]
+```
+
+#### Workflow Preferences
+
+```markdown
+# ~/.aidevops/.agent-workspace/memory/preferences/workflow.md
+
+## Git
+- Commit message style: [conventional/descriptive]
+- Branch naming: [feature/issue-123/kebab-case]
+- Squash commits: [yes/no]
+
+## Testing
+- Test coverage minimum: [80%/90%/100%]
+- TDD approach: [yes/no]
+
+## CI/CD
+- Auto-fix on commit: [yes/no]
+- Required checks: [list]
+```
+
+#### Tool Preferences
+
+```markdown
+# ~/.aidevops/.agent-workspace/memory/preferences/tools.md
+
+## Editors/IDEs
+- Primary: [VS Code/Cursor/etc]
+- Extensions: [list relevant]
+
+## Terminal
+- Shell: [zsh/bash/fish]
+- Custom aliases: [note any that affect commands]
+
+## Environment
+- Node.js manager: [nvm/n/fnm]
+- Python manager: [pyenv/conda/system]
+- Package managers: [npm/yarn/pnpm]
+```
+
+### Project-Specific Preferences
+
+For projects with unique requirements:
+
+```markdown
+# ~/.aidevops/.agent-workspace/memory/preferences/project-specific/wordpress.md
+
+## WordPress Development
+- Prefer simpler solutions over complex ones
+- Follow WordPress coding standards
+- Use OOP best practices
+- Admin functionality in admin/lib/
+- Core functionality in includes/
+- Assets in /assets organized by admin folders
+- Version updates require language file updates (POT/PO)
+
+## Plugin Release Process
+- Create version branch from main
+- Update all version references
+- Run quality checks before merge
+- Create GitHub tag and release
+- Ensure readme.txt is updated (Git Updater uses main branch)
+```
+
+### Potential Issues to Track
+
+Document environment-specific issues that affect AI assistance:
+
+```markdown
+# ~/.aidevops/.agent-workspace/memory/preferences/environment-issues.md
+
+## Terminal Customizations
+- Non-standard prompt: [describe]
+- Custom aliases that might confuse: [list]
+- Shell integrations: [starship/oh-my-zsh/etc]
+
+## Multiple Runtime Versions
+- Node.js versions: [list, note if Homebrew]
+- Python versions: [list, note manager]
+- PHP versions: [list]
+
+## Known Conflicts
+- [Document any tool conflicts discovered]
+```
+
+## Security Guidelines
+
+- **Never store credentials** in memory files
+- **Use configuration references** instead of actual API keys
+- **Keep sensitive data** in separate secure locations (`~/.config/aidevops/mcp-env.sh`)
+- **Regular cleanup** of outdated information
+- **No personal identifiable information** in shareable templates
+
+## Important Reminders
+
+- **Never store personal data** in this template directory
+- **Use ~/.aidevops/.agent-workspace/memory/** for all actual operations
+- **This directory is version controlled** - keep it clean
+- **Respect privacy** - be mindful of what you store
+- **Update preferences** when developer feedback indicates a change