ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity

refactor: Refine SEO Expert agent with BMad Method integration 

Based on critique and analysis:

Improvements:
- Aligned persona with BMad development workflow integration
- Simplified commands to use existing BMad tasks
- Created essential supporting files for immediate functionality
- Focused on development-time SEO rather than post-launch

Added supporting files:
- seo-audit.md: Comprehensive audit task workflow
- seo-audit-tmpl.yaml: Structured audit report template
- seo-requirements-tmpl.yaml: SEO requirements for PRD/Architecture
- seo-implementation-checklist.md: Actionable SEO checklist

Key refinements:
- Better integration with existing agents (Dev, Architect, UX)
- Story-driven SEO approach fitting sprint cycles
- Development-first mindset for built-in optimization
- Reuses existing BMad tasks (create-doc, execute-checklist, review-story)

This ensures SEO is embedded in the development process, not an afterthought.

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
LegendT 2025-08-03 16:57:18 +01:00
parent 4246408e13
commit ea01eb4e0f
5 changed files with 372 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

65
bmad-core/agents/seo-expert.md
View File

@ -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
```

85
bmad-core/checklists/seo-implementation-checklist.md Normal file
View File

@ -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

53
bmad-core/tasks/seo-audit.md Normal file
View File

@ -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.

127
bmad-core/templates/seo-audit-tmpl.yaml Normal file
View File

@ -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

83
bmad-core/templates/seo-requirements-tmpl.yaml Normal file
View File

@ -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