diff --git a/bmad-core/agents/seo-expert.md b/bmad-core/agents/seo-expert.md index dcd62ad9..fb57a2bc 100644 --- a/bmad-core/agents/seo-expert.md +++ b/bmad-core/agents/seo-expert.md @@ -32,61 +32,44 @@ agent: id: seo-expert title: SEO & Digital Marketing Strategist icon: 🔍 - whenToUse: Use for SEO audits, keyword research, content optimization, technical SEO implementation, search rankings analysis, and digital marketing strategy + whenToUse: Use for SEO audits, technical SEO requirements, content optimization guidance, and search visibility planning during project development customization: null persona: - role: Strategic SEO Expert & Digital Marketing Optimizer - style: Data-driven, strategic, technical yet accessible, results-focused, proactive - identity: SEO specialist who bridges technical implementation with content strategy and business goals - focus: Search visibility, organic growth, technical optimization, content strategy, measurable outcomes + role: Technical SEO Specialist & Search Optimization Architect + style: Analytical, precise, collaborative, implementation-focused, standards-driven + identity: SEO expert who integrates search optimization into the BMad development workflow, ensuring SEO is built-in, not bolted-on + focus: Technical SEO requirements, development-friendly optimization, measurable search performance, agile SEO integration core_principles: - - Data-Driven Decision Making - Base all recommendations on analytics and proven SEO metrics - - Holistic SEO Approach - Balance technical, content, and authority-building strategies - - User Intent Alignment - Prioritize user experience and search intent over keyword stuffing - - Technical Excellence - Ensure crawlability, indexability, and optimal site performance - - Content Quality First - Create valuable content that serves users while optimizing for search - - Competitive Intelligence - Monitor and learn from competitor strategies and market trends - - Measurable Impact - Focus on KPIs that directly affect business outcomes - - White-Hat Practices - Follow search engine guidelines and ethical SEO practices - - Continuous Optimization - Iterate based on performance data and algorithm updates - - Cross-Team Collaboration - Bridge gap between content, development, and marketing teams + - Development Integration First - Embed SEO requirements directly into user stories and architecture docs + - Technical Foundation - Ensure proper technical SEO implementation from the start + - Collaborative Workflow - Work seamlessly with Dev, Architect, and UX agents + - Story-Driven SEO - Create actionable SEO tasks that fit the sprint cycle + - Performance Metrics - Define clear, measurable SEO acceptance criteria + - BMad Method Alignment - Follow established documentation and workflow patterns + - Proactive Optimization - Identify SEO needs during planning, not after deployment + - Standards Compliance - Ensure adherence to web standards and accessibility + - User-Centric Approach - Balance search optimization with user experience + - Continuous Monitoring - Establish tracking and reporting from project inception - Numbered Options Protocol - Always use numbered lists for selections # All commands require * prefix when used (e.g., *help) commands: - help: Show numbered list of the following commands to allow selection - - site-audit: Perform comprehensive SEO audit (task execute-seo-audit with seo-audit-tmpl.yaml) - - keyword-research: Conduct keyword research and opportunity analysis (task keyword-research with keyword-research-tmpl.yaml) - - content-optimize: Optimize content for target keywords (task optimize-content with content-optimization-checklist.md) - - technical-seo: Execute technical SEO improvements (task technical-seo-implementation) - - competitor-analysis: Analyze competitor SEO strategies (task seo-competitor-analysis with seo-competitor-tmpl.yaml) - - create-content-strategy: Develop content strategy based on SEO insights (task create-doc with content-strategy-tmpl.yaml) - - monitor-rankings: Set up and review ranking tracking (task monitor-search-performance) - - local-seo: Optimize for local search (task local-seo-optimization) - - link-analysis: Analyze and improve link profile (task backlink-analysis) + - audit-site: Perform comprehensive SEO audit (task seo-audit with seo-audit-tmpl.yaml) + - create-seo-requirements: Generate SEO requirements for PRD/Architecture (task create-doc with seo-requirements-tmpl.yaml) + - review-story-seo: Review story for SEO considerations (task review-story) + - seo-checklist: Execute SEO implementation checklist (task execute-checklist with seo-implementation-checklist.md) - yolo: Toggle Yolo Mode - doc-out: Output full document in progress to current destination file - exit: Say goodbye as the SEO Expert, and then abandon inhabiting this persona dependencies: tasks: - - execute-seo-audit.md - - keyword-research.md - - optimize-content.md - - technical-seo-implementation.md - - seo-competitor-analysis.md - - monitor-search-performance.md - - local-seo-optimization.md - - backlink-analysis.md + - seo-audit.md - create-doc.md + - review-story.md + - execute-checklist.md templates: - seo-audit-tmpl.yaml - - keyword-research-tmpl.yaml - - seo-competitor-tmpl.yaml - - content-strategy-tmpl.yaml + - seo-requirements-tmpl.yaml checklists: - - content-optimization-checklist.md - - technical-seo-checklist.md - - local-seo-checklist.md - data: - - seo-best-practices.md - - search-algorithm-factors.md + - seo-implementation-checklist.md ``` \ No newline at end of file diff --git a/bmad-core/checklists/seo-implementation-checklist.md b/bmad-core/checklists/seo-implementation-checklist.md new file mode 100644 index 00000000..e56acfe7 --- /dev/null +++ b/bmad-core/checklists/seo-implementation-checklist.md @@ -0,0 +1,85 @@ +# SEO Implementation Checklist + +## Technical SEO +- [ ] Verify robots.txt is properly configured +- [ ] Generate and submit XML sitemap +- [ ] Implement canonical URLs +- [ ] Set up 301 redirects for moved content +- [ ] Enable HTTPS across entire site +- [ ] Configure hreflang tags (if multi-language) +- [ ] Implement structured data markup (Schema.org) +- [ ] Optimize site speed and Core Web Vitals +- [ ] Fix crawl errors in Search Console +- [ ] Ensure mobile responsiveness + +## On-Page Optimization +- [ ] Optimize title tags (unique, 50-60 chars) +- [ ] Write compelling meta descriptions (150-160 chars) +- [ ] Structure content with proper H1-H6 hierarchy +- [ ] Optimize images (compression, alt text, filenames) +- [ ] Implement internal linking strategy +- [ ] Create SEO-friendly URL structure +- [ ] Add breadcrumb navigation +- [ ] Optimize for featured snippets +- [ ] Update outdated content +- [ ] Fix broken links + +## Content Strategy +- [ ] Conduct keyword research +- [ ] Map keywords to user intent +- [ ] Create content calendar +- [ ] Develop topic clusters +- [ ] Write comprehensive, valuable content +- [ ] Optimize for semantic search +- [ ] Include relevant LSI keywords +- [ ] Add FAQ sections where appropriate +- [ ] Create location-specific content (if local) +- [ ] Implement content refresh schedule + +## Off-Page SEO +- [ ] Audit existing backlink profile +- [ ] Disavow toxic backlinks +- [ ] Develop link building strategy +- [ ] Create linkable assets +- [ ] Build local citations (if applicable) +- [ ] Monitor brand mentions +- [ ] Engage in relevant communities +- [ ] Guest posting outreach +- [ ] Partner/supplier link opportunities +- [ ] Social media optimization + +## Analytics & Monitoring +- [ ] Set up Google Analytics 4 +- [ ] Configure Google Search Console +- [ ] Implement conversion tracking +- [ ] Set up rank tracking +- [ ] Create custom dashboards +- [ ] Configure automated reporting +- [ ] Set up alerts for issues +- [ ] Monitor Core Web Vitals +- [ ] Track keyword rankings +- [ ] Monitor competitor performance + +## Local SEO (if applicable) +- [ ] Claim Google Business Profile +- [ ] Optimize GBP listing +- [ ] Build local citations +- [ ] Gather customer reviews +- [ ] Create location pages +- [ ] Implement local schema markup +- [ ] Optimize for "near me" searches +- [ ] Join local business directories +- [ ] Create locally-relevant content +- [ ] Build local backlinks + +## E-commerce SEO (if applicable) +- [ ] Optimize product pages +- [ ] Create unique product descriptions +- [ ] Implement product schema +- [ ] Optimize category pages +- [ ] Add customer reviews +- [ ] Create buying guides +- [ ] Optimize for commercial intent +- [ ] Implement faceted navigation properly +- [ ] Handle out-of-stock products +- [ ] Optimize checkout process \ No newline at end of file diff --git a/bmad-core/tasks/seo-audit.md b/bmad-core/tasks/seo-audit.md new file mode 100644 index 00000000..ab9d8797 --- /dev/null +++ b/bmad-core/tasks/seo-audit.md @@ -0,0 +1,53 @@ +# SEO Audit Task + +## Purpose +Conduct comprehensive SEO audit to identify optimization opportunities and technical issues affecting search visibility. + +## Task Instructions + +### 1. Technical SEO Assessment +Analyze technical foundation: +- Site crawlability and indexability +- XML sitemap presence and validity +- Robots.txt configuration +- Site speed and Core Web Vitals +- Mobile responsiveness +- HTTPS implementation +- Canonical URL setup +- Structured data markup + +### 2. On-Page SEO Analysis +Review content optimization: +- Title tags and meta descriptions +- Header tag hierarchy (H1-H6) +- Internal linking structure +- Image optimization and alt text +- Content quality and keyword usage +- URL structure and permalinks +- Duplicate content issues + +### 3. Off-Page SEO Review +Evaluate external factors: +- Backlink profile quality +- Domain authority metrics +- Brand mentions and citations +- Social signals +- Competitor comparison + +### 4. Content Gap Analysis +Identify opportunities: +- Missing topic coverage +- Keyword opportunities +- Content depth requirements +- User intent alignment + +### 5. Generate Audit Report +Create comprehensive report using seo-audit-tmpl.yaml including: +- Executive summary +- Priority issues matrix +- Detailed findings by category +- Actionable recommendations +- Implementation roadmap + +## Output +Structured SEO audit document with prioritized action items and implementation timeline. \ No newline at end of file diff --git a/bmad-core/templates/seo-audit-tmpl.yaml b/bmad-core/templates/seo-audit-tmpl.yaml new file mode 100644 index 00000000..4958d5cb --- /dev/null +++ b/bmad-core/templates/seo-audit-tmpl.yaml @@ -0,0 +1,127 @@ +template: + name: SEO Audit Report + version: 1.0 + description: Comprehensive SEO audit documentation template + sections: + - name: Executive Summary + required: true + prompts: + - Current SEO performance overview + - Critical issues impacting visibility + - Top 3-5 priority recommendations + - Expected impact of improvements + + - name: Technical SEO Analysis + required: true + subsections: + - name: Site Architecture + prompts: + - Crawlability assessment + - Indexation status + - XML sitemap analysis + - Robots.txt review + - name: Performance Metrics + prompts: + - Page speed scores (Mobile/Desktop) + - Core Web Vitals (LCP, FID, CLS) + - Server response times + - Resource optimization needs + - name: Mobile Optimization + prompts: + - Mobile responsiveness issues + - Mobile-specific user experience + - AMP implementation (if applicable) + + - name: On-Page SEO Assessment + required: true + subsections: + - name: Content Optimization + prompts: + - Title tag analysis + - Meta description review + - Header structure (H1-H6) + - Keyword density and placement + - name: Internal Linking + prompts: + - Link structure analysis + - Anchor text distribution + - Orphan pages identification + - Link depth assessment + + - name: Off-Page SEO Factors + required: true + subsections: + - name: Backlink Profile + prompts: + - Total backlinks and referring domains + - Link quality assessment + - Toxic link identification + - Competitor backlink gap + - name: Brand Authority + prompts: + - Domain authority metrics + - Brand mention tracking + - Local citations (if applicable) + + - name: Content Analysis + required: true + subsections: + - name: Content Quality + prompts: + - Thin content identification + - Duplicate content issues + - Content freshness assessment + - E-E-A-T factors + - name: Keyword Opportunities + prompts: + - Current keyword rankings + - Keyword gap analysis + - Search intent alignment + - Featured snippet opportunities + + - name: Competitive Analysis + required: false + prompts: + - Top 3-5 competitors identified + - Competitive advantages/disadvantages + - Content gap opportunities + - Technical differentiators + + - name: Priority Action Matrix + required: true + subsections: + - name: Critical Issues + prompts: + - Issues blocking crawling/indexing + - Major technical problems + - Immediate fixes needed + - name: High Priority + prompts: + - Quick wins with high impact + - Important optimizations + - 30-day action items + - name: Medium Priority + prompts: + - Ongoing improvements + - 60-90 day initiatives + - Content enhancements + - name: Low Priority + prompts: + - Nice-to-have improvements + - Long-term initiatives + + - name: Implementation Roadmap + required: true + prompts: + - Week 1-2 tasks + - Month 1 deliverables + - Quarter 1 goals + - Success metrics and KPIs + + - name: Monitoring Plan + required: true + prompts: + - Key metrics to track + - Reporting frequency + - Tools and dashboards + - Success benchmarks \ No newline at end of file diff --git a/bmad-core/templates/seo-requirements-tmpl.yaml b/bmad-core/templates/seo-requirements-tmpl.yaml new file mode 100644 index 00000000..add88b5f --- /dev/null +++ b/bmad-core/templates/seo-requirements-tmpl.yaml @@ -0,0 +1,83 @@ +template: + name: SEO Requirements Document + version: 1.0 + description: SEO requirements to be integrated into PRD and Architecture documents + sections: + - name: SEO Objectives + required: true + prompts: + - Primary SEO goals for this project + - Target audience search behavior + - Key performance indicators (KPIs) + - Success metrics and benchmarks + + - name: Technical SEO Requirements + required: true + subsections: + - name: Site Architecture + prompts: + - URL structure requirements + - Navigation hierarchy for SEO + - Internal linking strategy + - Sitemap generation needs + - name: Performance Requirements + prompts: + - Page speed targets (Mobile/Desktop) + - Core Web Vitals requirements + - Image optimization standards + - Code optimization needs + - name: Crawlability & Indexing + prompts: + - Robots.txt configuration + - Canonical URL strategy + - Pagination handling + - JavaScript rendering requirements + + - name: Content Requirements + required: true + subsections: + - name: Content Structure + prompts: + - Page template SEO requirements + - Meta data requirements + - Heading hierarchy standards + - Content depth guidelines + - name: Keyword Strategy + prompts: + - Primary keyword targets + - Secondary keywords + - Long-tail opportunities + - Semantic keyword clusters + + - name: Development Considerations + required: true + prompts: + - Schema markup implementation + - Open Graph and Twitter Cards + - Accessibility requirements (overlap with SEO) + - Mobile-first development approach + - Progressive enhancement strategy + + - name: User Story SEO Criteria + required: true + prompts: + - SEO acceptance criteria for stories + - Testing requirements for SEO features + - Performance benchmarks for stories + - SEO validation checkpoints + + - name: Monitoring & Analytics + required: true + prompts: + - Analytics implementation requirements + - Search Console setup needs + - Tracking and reporting setup + - Dashboard and alerting requirements + + - name: Integration Points + required: true + prompts: + - CMS/backend SEO features needed + - API requirements for SEO data + - Third-party tool integrations + - CDN and caching considerations \ No newline at end of file