Merge pull request #1 from jamon8888/claude/convert-plugin-to-bmad-01S1bW68Ckw8L3ovrvGADNeQ
Claude/convert plugin to bmad - Voice style and docs updated
This commit is contained in:
Jamin
GitHub
commit
740fff4ae1
57
CHANGELOG.md
57
CHANGELOG.md
|
|
@ -2,6 +2,63 @@
|
|||
|
||||
## [Unreleased]
|
||||
|
||||
### ✨ New Module: Content Creator
|
||||
|
||||
**Advanced Content Creation with Voice & Style Profiling**
|
||||
|
||||
A comprehensive content creation suite that transforms how you create content across multiple platforms while maintaining your authentic voice.
|
||||
|
||||
**8 Specialized Agents:**
|
||||
- Casey (Content Writer) - Main content orchestrator
|
||||
- Alex (Content Analyzer) - Quality and SEO expert
|
||||
- Riley (Research Aggregator) - Research and trends specialist
|
||||
- Vicki (Voice Matcher) - Voice consistency guardian
|
||||
- Lauren (LinkedIn Repurposer) - Professional content expert
|
||||
- Nina (Newsletter Repurposer) - Email content specialist
|
||||
- Charlie (Conversational Repurposer) - Social media expert
|
||||
- Sam (SEO Optimizer) - Search optimization specialist
|
||||
|
||||
**Advanced Voice & Style System:**
|
||||
- **Build Voice Profile** - Comprehensive voice analysis with 5-dimension profiling
|
||||
- Sentence structure, vocabulary, tone, perspective, rhetorical devices
|
||||
- Creates detailed voice profiles with style guidelines
|
||||
- Platform-specific adaptations
|
||||
- Similarity scoring for validation (target: 75+/100)
|
||||
- **Train Voice** - Continuous voice refinement and evolution tracking
|
||||
- Add new writing samples anytime
|
||||
- Voice evolution analysis and version management
|
||||
- Context variations for different platforms
|
||||
- **Create Style Guide** - Complete custom style guide generation
|
||||
- Combines voice profile, brand guidelines, and platform rules
|
||||
- Grammar, vocabulary, and structure standards
|
||||
- Platform-specific formatting requirements
|
||||
- Quality standards and templates
|
||||
- **Style Analyzer** - Deep quantitative and qualitative analysis
|
||||
- Sentence/word metrics and readability scores
|
||||
- Voice, tone, and pattern analysis
|
||||
- Signature identification and style fingerprinting
|
||||
|
||||
**Content Creation Workflows:**
|
||||
- Article Pipeline - Complete article creation with multi-platform repurposing
|
||||
- Research Topic - Deep research with trend analysis
|
||||
- Extract Themes - Pattern recognition from raw notes
|
||||
- Quick Post - Fast social media content creation
|
||||
- Optimize Content - SEO and engagement improvements
|
||||
|
||||
**Key Features:**
|
||||
- Multi-platform content creation (Blog, LinkedIn, Newsletter, Twitter, Medium, Substack)
|
||||
- Voice profiling that captures your unique writing patterns
|
||||
- Automatic content repurposing for each platform
|
||||
- Built-in quality checks (readability, SEO, engagement, voice consistency)
|
||||
- Research integration with priority source checking
|
||||
- Voice similarity scoring to ensure AI matches your authentic style
|
||||
|
||||
**Documentation:**
|
||||
- [Module README](./src/modules/content-creator/README.md)
|
||||
- Voice profile creation and training guides
|
||||
- Style guide generation documentation
|
||||
- Platform-specific optimization tips
|
||||
|
||||
## [6.0.0-alpha.12]
|
||||
|
||||
**Release: November 19, 2025**
|
||||
|
|
|
|||
12
README.md
12
README.md
|
|
@ -8,7 +8,7 @@
|
|||
|
||||
## AI-Driven Agile Development That Scales From Bug Fixes to Enterprise
|
||||
|
||||
**Build More, Architect Dreams** (BMAD) with **19 specialized AI agents** and **50+ guided workflows** that adapt to your project's complexity—from quick bug fixes to enterprise platforms.
|
||||
**Build More, Architect Dreams** (BMAD) with **27+ specialized AI agents** and **60+ guided workflows** that adapt to your project's complexity—from quick bug fixes to enterprise platforms to content creation.
|
||||
|
||||
> **🚀 v6 is a MASSIVE upgrade from v4!** Complete architectural overhaul, scale-adaptive intelligence, visual workflows, and the powerful BMad Core framework. v4 users: this changes everything. [See what's new →](#whats-new-in-v6)
|
||||
|
||||
|
|
@ -22,8 +22,9 @@ Unlike generic AI coding assistants, BMad Method provides **structured, battle-t
|
|||
|
||||
- **Scale-Adaptive Intelligence** - Automatically adjusts planning depth from bug fixes to enterprise systems
|
||||
- **Complete Development Lifecycle** - Analysis → Planning → Architecture → Implementation
|
||||
- **Specialized Expertise** - 19 agents with specific roles (PM, Architect, Developer, UX Designer, etc.)
|
||||
- **Specialized Expertise** - 27+ agents with specific roles (PM, Architect, Developer, UX Designer, Content Creator, etc.)
|
||||
- **Proven Methodologies** - Built on agile best practices with AI amplification
|
||||
- **Advanced Voice & Style System** - AI content that authentically matches your unique writing style
|
||||
- **IDE Integration** - Works with Claude Code, Cursor, Windsurf, VS Code
|
||||
|
||||
## 🏗️ The Power of BMad Core
|
||||
|
|
@ -124,6 +125,13 @@ Each agent brings deep expertise and can be customized to match your team's styl
|
|||
- 5 creative facilitation workflows
|
||||
- [→ Creative Workflows](./src/modules/cis/README.md)
|
||||
|
||||
- **Content Creator** - Advanced content creation with voice matching
|
||||
- 8 specialized content creation agents
|
||||
- 8 workflows including advanced voice profiling system
|
||||
- Multi-platform content creation (Blog, LinkedIn, Newsletter, Twitter)
|
||||
- Custom voice profiles and style guides
|
||||
- [→ Content Creation Suite](./src/modules/content-creator/README.md)
|
||||
|
||||
### Key Features
|
||||
|
||||
- **🎨 Customizable Agents** - Modify personalities, expertise, and communication styles
|
||||
|
|
|
|||
|
|
@ -62,6 +62,23 @@ AI-powered creative thinking and brainstorming.
|
|||
|
||||
- **[CIS Module README](../src/modules/cis/README.md)** - Module overview and workflows
|
||||
|
||||
### Content Creator - Advanced Content Creation with Voice Profiling
|
||||
|
||||
Multi-platform content creation with authentic voice matching and style customization.
|
||||
|
||||
- **[Content Creator Module README](../src/modules/content-creator/README.md)** - Module overview, agents, and workflows
|
||||
- **Voice & Style System:**
|
||||
- Build Voice Profile - Create comprehensive voice profiles from writing samples
|
||||
- Train Voice - Continuously refine and evolve your voice profile
|
||||
- Create Style Guide - Generate complete custom style guides
|
||||
- Style Analyzer - Deep analysis of writing patterns and characteristics
|
||||
- **Content Workflows:**
|
||||
- Article Pipeline - Complete article creation with multi-platform repurposing
|
||||
- Research Topic - Deep research with trend analysis
|
||||
- Extract Themes - Pattern recognition from raw notes
|
||||
- Quick Post - Fast social media content creation
|
||||
- Optimize Content - SEO and engagement improvements
|
||||
|
||||
---
|
||||
|
||||
## 🖥️ IDE-Specific Guides
|
||||
|
|
@ -133,8 +150,17 @@ src/modules/
|
|||
├── bmb/ # BMad Builder module
|
||||
│ ├── README.md
|
||||
│ └── workflows/create-agent/README.md
|
||||
└── cis/ # Creative Intelligence Suite
|
||||
└── README.md
|
||||
├── cis/ # Creative Intelligence Suite
|
||||
│ └── README.md
|
||||
└── content-creator/ # Content Creator module
|
||||
├── README.md # Module overview & documentation
|
||||
├── data/
|
||||
│ ├── voice-profiles/ # Voice profile storage
|
||||
│ └── style-guides/ # Style guide storage
|
||||
└── workflows/
|
||||
├── build-voice-profile/ # Voice profiling system
|
||||
├── train-voice/ # Voice training
|
||||
└── create-style-guide/ # Style guide generation
|
||||
```
|
||||
|
||||
---
|
||||
|
|
@ -175,7 +201,14 @@ src/modules/
|
|||
2. [Agent Creation Guide](../src/modules/bmb/workflows/create-agent/README.md) - Create agents
|
||||
3. [BMM Workflows Guide](../src/modules/bmm/workflows/README.md) - Understand workflow structure
|
||||
|
||||
### Path 6: Contributing to BMad
|
||||
### Path 6: Content Creation with Voice Profiling
|
||||
|
||||
1. [Content Creator Module README](../src/modules/content-creator/README.md) - Understand capabilities
|
||||
2. Build your voice profile with `*build-voice-profile`
|
||||
3. Create content with `*write` using your authentic voice
|
||||
4. Train and refine your voice over time with `*train-voice`
|
||||
|
||||
### Path 7: Contributing to BMad
|
||||
|
||||
1. [CONTRIBUTING.md](../CONTRIBUTING.md) - Contribution guidelines
|
||||
2. Relevant module README - Understand the area you're contributing to
|
||||
|
|
@ -190,6 +223,7 @@ src/modules/
|
|||
- **BMM** - AI-driven software and game development
|
||||
- **BMB** - Create custom agents and workflows
|
||||
- **CIS** - Creative thinking and brainstorming
|
||||
- **Content Creator** - Multi-platform content creation with voice profiling
|
||||
|
||||
**How do I load an agent?**
|
||||
→ See [ide-info](./ide-info/) folder for your IDE
|
||||
|
|
|
|||
|
|
@ -0,0 +1,466 @@
|
|||
# Content Creator Module
|
||||
|
||||
**Transform your writing workflow with AI-powered content creation across all platforms.**
|
||||
|
||||
The Content Creator module is a comprehensive content creation suite that learns your unique voice and automatically adapts your ideas for multiple platforms. From initial research to multi-platform publication, streamline your entire content workflow with specialized AI agents and proven workflows.
|
||||
|
||||
## 🎯 What It Does
|
||||
|
||||
- **📝 Custom Voice & Style System** - Build comprehensive voice profiles from your writing samples with deep style analysis
|
||||
- **🎭 Learns Your Voice** - Advanced voice profiling that captures sentence patterns, vocabulary, tone, and unique expressions
|
||||
- **📚 Style Guide Creation** - Generate complete style guides combining voice profile, brand guidelines, and platform rules
|
||||
- **🔄 Voice Training** - Continuously refine your voice profile as your writing evolves
|
||||
- **🌐 Multi-Platform Publishing** - Automatically repurposes content for Blog, LinkedIn, Newsletter, Twitter, and more
|
||||
- **🔍 Research Integration** - Checks your curated sources first, finds trends, and surfaces unique angles
|
||||
- **✅ Quality Assurance** - Built-in quality checks for readability, SEO, engagement, and voice consistency
|
||||
- **⚡ Complete Pipeline** - From raw notes to published content in minutes, not hours
|
||||
|
||||
## ✨ Key Features
|
||||
|
||||
### 8 Specialized Agents
|
||||
|
||||
1. **Casey - Content Writer** - Your main content creation orchestrator
|
||||
2. **Alex - Content Analyzer** - Quality and SEO analysis expert
|
||||
3. **Riley - Research Aggregator** - Research and trend analysis specialist
|
||||
4. **Vicki - Voice Matcher** - Voice consistency and brand alignment guardian
|
||||
5. **Lauren - LinkedIn Repurposer** - Professional networking content expert
|
||||
6. **Nina - Newsletter Repurposer** - Email content and subscriber engagement specialist
|
||||
7. **Charlie - Conversational Repurposer** - Social media and conversational content expert
|
||||
8. **Sam - SEO Optimizer** - Search engine optimization specialist
|
||||
|
||||
### 8 Core Workflows
|
||||
|
||||
**Content Creation:**
|
||||
1. **Article Pipeline** - Complete article creation from research to multi-platform publish
|
||||
2. **Research Topic** - Deep research with trend analysis and unique angles
|
||||
3. **Extract Themes** - Pattern recognition from raw notes and ideas
|
||||
4. **Quick Post** - Fast social media and short-form content creation
|
||||
5. **Optimize Content** - Improve existing content for SEO and engagement
|
||||
|
||||
**Voice & Style System:**
|
||||
6. **Build Voice Profile** - Create comprehensive voice profile from writing samples
|
||||
7. **Train Voice** - Refine and update voice profile with new samples
|
||||
8. **Create Style Guide** - Generate complete custom style guide
|
||||
|
||||
### Advanced Voice & Style Features
|
||||
|
||||
- **🎯 Voice Profiling** - Deep analysis of sentence structure, vocabulary, tone, and rhetorical devices
|
||||
- **📊 Style Analysis** - Quantitative and qualitative analysis of writing patterns
|
||||
- **🔄 Voice Training** - Continuous learning and refinement as your writing evolves
|
||||
- **📖 Style Guides** - Comprehensive guidelines combining voice, brand, and platform rules
|
||||
- **✅ Voice Validation** - Similarity scoring to ensure AI content matches your authentic voice
|
||||
- **🎨 Context Variations** - Different voice profiles for different platforms and audiences
|
||||
|
||||
### Intelligent Content Operations
|
||||
|
||||
- **Platform Optimization** - Automatic adaptation for each platform's best practices
|
||||
- **SEO Integration** - Built-in keyword optimization and search visibility
|
||||
- **Quality Gates** - Automated quality checks before publishing
|
||||
- **Research Intelligence** - Priority source checking and trend surfacing
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
### 1. Install the Module
|
||||
|
||||
```bash
|
||||
npx bmad-method@alpha install
|
||||
```
|
||||
|
||||
Select "Content Creator" during module selection.
|
||||
|
||||
### 2. Configure Your Settings
|
||||
|
||||
During installation, you'll configure:
|
||||
- Content output folder
|
||||
- Default writing style
|
||||
- Target platforms (Blog, LinkedIn, Newsletter, Twitter, etc.)
|
||||
- SEO optimization preferences
|
||||
- Readability targets
|
||||
- Quality control settings
|
||||
|
||||
### 3. Build Your Voice Profile (New!)
|
||||
|
||||
**Option A: Quick Setup**
|
||||
After installation, add writing samples to `.bmad/content-creator/data/writing-examples.md`
|
||||
|
||||
**Option B: Advanced Voice Profiling (Recommended)**
|
||||
```
|
||||
Load Content Writer agent
|
||||
Run: *build-voice-profile
|
||||
|
||||
Provide 3-5 writing samples (1500+ words total)
|
||||
Answer questions about your style
|
||||
Review and approve generated profile
|
||||
```
|
||||
|
||||
This creates a comprehensive voice profile with:
|
||||
- Detailed sentence structure analysis
|
||||
- Vocabulary and tone characteristics
|
||||
- Rhetorical device patterns
|
||||
- Platform-specific adaptations
|
||||
- Style guidelines and templates
|
||||
|
||||
### 4. Setup Reference Materials
|
||||
|
||||
Update these files in `.bmad/content-creator/data/`:
|
||||
|
||||
**Required:**
|
||||
- `research-sources.md` - List your trusted research sources
|
||||
|
||||
**Optional but Recommended:**
|
||||
- `brand-guidelines.md` - Define your brand voice and style guidelines
|
||||
- `seo-keywords.md` - Add your target keywords and phrases
|
||||
|
||||
### 5. Start Creating Content
|
||||
|
||||
Load the Content Writer agent and try these commands:
|
||||
|
||||
**Content Creation:**
|
||||
```
|
||||
*write # Complete article pipeline
|
||||
*research # Deep research on a topic
|
||||
*extract-themes # Analyze raw notes for patterns
|
||||
*quick-post # Fast social media content
|
||||
*optimize # Improve existing content
|
||||
```
|
||||
|
||||
**Voice & Style:**
|
||||
```
|
||||
*build-voice-profile # Create comprehensive voice profile
|
||||
*train-voice # Update profile with new samples
|
||||
*analyze-style # Deep style analysis
|
||||
*create-style-guide # Generate custom style guide
|
||||
```
|
||||
|
||||
## 📖 Usage Examples
|
||||
|
||||
### Example 1: Complete Article Pipeline
|
||||
|
||||
```
|
||||
*write
|
||||
|
||||
Topic: "The Future of Remote Work"
|
||||
Target keyword: "remote work trends 2025"
|
||||
Audience: Business leaders
|
||||
Goal: Educate and inform
|
||||
```
|
||||
|
||||
**Result:** Creates:
|
||||
- Main article (1200-1500 words)
|
||||
- LinkedIn professional post
|
||||
- Newsletter version with subject lines
|
||||
- Twitter thread (5-8 tweets)
|
||||
- Research brief
|
||||
- Quality and SEO reports
|
||||
|
||||
### Example 2: Research Topic
|
||||
|
||||
```
|
||||
*research
|
||||
|
||||
Topic: "AI in Content Creation"
|
||||
```
|
||||
|
||||
**Result:** Research brief with:
|
||||
- 5-7 key insights with sources
|
||||
- 3-5 current data points
|
||||
- 2-3 unique angles
|
||||
- Emerging trends
|
||||
- Content recommendations
|
||||
|
||||
### Example 3: Extract Themes from Notes
|
||||
|
||||
```
|
||||
*extract-themes
|
||||
```
|
||||
|
||||
**Result:** Theme analysis report:
|
||||
- Major themes identified from your raw notes
|
||||
- Content opportunities ranked by potential
|
||||
- Recommended article topics
|
||||
- Series ideas
|
||||
|
||||
### Example 4: Quick Social Post
|
||||
|
||||
```
|
||||
*quick-post
|
||||
|
||||
Platform: LinkedIn
|
||||
Topic: Quick insight about AI productivity
|
||||
Style: Professional but personal
|
||||
```
|
||||
|
||||
**Result:** Optimized LinkedIn post ready to publish
|
||||
|
||||
## 🎨 Customization
|
||||
|
||||
### Voice Profile
|
||||
|
||||
Update `data/writing-examples.md` with your writing samples. The AI will analyze:
|
||||
- Sentence structure patterns
|
||||
- Vocabulary level
|
||||
- Use of humor and metaphors
|
||||
- Formality level
|
||||
- Rhetorical devices
|
||||
|
||||
### Research Sources
|
||||
|
||||
Customize `data/research-sources.md` with your trusted sources:
|
||||
- Industry publications
|
||||
- Expert thought leaders
|
||||
- Data sources
|
||||
- Academic journals
|
||||
|
||||
### SEO Keywords
|
||||
|
||||
Define target keywords in `data/seo-keywords.md`:
|
||||
- Primary keywords by topic
|
||||
- Long-tail variations
|
||||
- Semantic keywords
|
||||
- Competitor keywords
|
||||
|
||||
### Brand Guidelines
|
||||
|
||||
Set brand standards in `data/brand-guidelines.md`:
|
||||
- Brand voice and tone
|
||||
- Writing style preferences
|
||||
- Language guidelines
|
||||
- Platform-specific guidelines
|
||||
|
||||
## 🔧 Agent Reference
|
||||
|
||||
### Casey - Content Writer
|
||||
|
||||
**Main orchestrator for content creation**
|
||||
|
||||
Commands:
|
||||
- `*write` - Complete article pipeline
|
||||
- `*research` - Deep topic research
|
||||
- `*extract-themes` - Analyze raw notes
|
||||
- `*quick-post` - Fast social content
|
||||
- `*optimize` - Improve existing content
|
||||
- `*analyze` - Content analysis
|
||||
- `*quality-check` - Quality validation
|
||||
|
||||
### Alex - Content Analyzer
|
||||
|
||||
**Quality and SEO expert**
|
||||
|
||||
Commands:
|
||||
- `*analyze` - Comprehensive 5-dimension analysis
|
||||
- `*seo-check` - Deep SEO analysis
|
||||
- `*readability` - Readability assessment
|
||||
- `*quick-check` - Fast quality check
|
||||
|
||||
### Riley - Research Aggregator
|
||||
|
||||
**Research and trends**
|
||||
|
||||
Commands:
|
||||
- `*research` - Deep research workflow
|
||||
- `*extract-themes` - Pattern extraction
|
||||
- `*quick-research` - Fast research brief
|
||||
- `*trend-analysis` - Trend identification
|
||||
|
||||
### Vicki - Voice Matcher
|
||||
|
||||
**Voice consistency guardian**
|
||||
|
||||
Commands:
|
||||
- `*check-voice` - Voice consistency check
|
||||
- `*analyze-style` - Style pattern analysis
|
||||
- `*optimize-voice` - Voice optimization
|
||||
- `*update-profile` - Update voice profile
|
||||
|
||||
### Lauren - LinkedIn Repurposer
|
||||
|
||||
**Professional content expert**
|
||||
|
||||
Commands:
|
||||
- `*repurpose-linkedin` - Transform to LinkedIn
|
||||
- `*linkedin-post` - Create LinkedIn post
|
||||
- `*optimize-linkedin` - Optimize for engagement
|
||||
|
||||
### Nina - Newsletter Repurposer
|
||||
|
||||
**Email content specialist**
|
||||
|
||||
Commands:
|
||||
- `*repurpose-newsletter` - Transform to newsletter
|
||||
- `*newsletter-create` - Create newsletter issue
|
||||
- `*subject-lines` - Generate subject lines
|
||||
|
||||
### Charlie - Conversational Repurposer
|
||||
|
||||
**Social media expert**
|
||||
|
||||
Commands:
|
||||
- `*repurpose-social` - Transform to social
|
||||
- `*twitter-thread` - Create Twitter thread
|
||||
- `*podcast-script` - Create podcast segment
|
||||
- `*social-post` - Create social post
|
||||
|
||||
### Sam - SEO Optimizer
|
||||
|
||||
**Search optimization**
|
||||
|
||||
Commands:
|
||||
- `*optimize-seo` - Full SEO optimization
|
||||
- `*keyword-research` - Keyword suggestions
|
||||
- `*meta-optimize` - Meta tag optimization
|
||||
- `*seo-audit` - Comprehensive audit
|
||||
|
||||
## 📊 Workflow Details
|
||||
|
||||
### Article Pipeline Workflow
|
||||
|
||||
**Duration:** 10-15 minutes
|
||||
|
||||
**Steps:**
|
||||
1. Research & Topic Development
|
||||
2. Article Outline Creation
|
||||
3. Article Drafting with Voice Matching
|
||||
4. SEO Optimization (if enabled)
|
||||
5. Quality Validation (must score ≥70)
|
||||
6. Multi-Platform Repurposing
|
||||
7. Publishing Preparation
|
||||
8. Workflow Summary
|
||||
|
||||
**Outputs:**
|
||||
- Main article
|
||||
- LinkedIn version
|
||||
- Newsletter version
|
||||
- Social media versions
|
||||
- Research brief
|
||||
- Quality report
|
||||
- SEO report
|
||||
|
||||
### Research Topic Workflow
|
||||
|
||||
**Duration:** 5-10 minutes
|
||||
|
||||
**Process:**
|
||||
- Topic definition and scope
|
||||
- Priority source checking
|
||||
- Trend analysis
|
||||
- Data gathering
|
||||
- Unique angle discovery
|
||||
- Research brief synthesis
|
||||
|
||||
**Output:** Comprehensive research brief ready for writing
|
||||
|
||||
### Extract Themes Workflow
|
||||
|
||||
**Duration:** 5-10 minutes
|
||||
|
||||
**Process:**
|
||||
- Gather raw notes
|
||||
- Pattern recognition
|
||||
- Theme categorization
|
||||
- Unique angle discovery
|
||||
- Content opportunity identification
|
||||
|
||||
**Output:** Theme analysis with prioritized content opportunities
|
||||
|
||||
## 📁 File Organization
|
||||
|
||||
Content is organized in your output folder:
|
||||
|
||||
```
|
||||
{content_output_folder}/
|
||||
├── drafts/ # Work-in-progress content
|
||||
│ ├── article-*.md
|
||||
│ ├── linkedin-*.md
|
||||
│ ├── newsletter-*.md
|
||||
│ └── social-*.md
|
||||
├── published/ # Published content archive
|
||||
├── research/ # Research briefs and reports
|
||||
│ ├── research-*.md
|
||||
│ ├── themes-*.md
|
||||
│ ├── quality-*.md
|
||||
│ └── seo-*.md
|
||||
├── rawnotes/ # Unstructured ideas and notes
|
||||
└── archive/ # Archived content (30+ days)
|
||||
```
|
||||
|
||||
## 🎯 Best Practices
|
||||
|
||||
### Voice Profile Setup
|
||||
|
||||
1. **Use Real Writing Samples** - 3-5 pieces of content you've actually written
|
||||
2. **Show Range** - Include different formats (blog, social, newsletter)
|
||||
3. **Recent Content** - Use recent samples that represent your current voice
|
||||
4. **Sufficient Length** - Each sample should be 200-300+ words
|
||||
|
||||
### Research Sources
|
||||
|
||||
1. **Prioritize Your List** - Put most trusted sources at the top
|
||||
2. **Keep Updated** - Review and update quarterly
|
||||
3. **Be Specific** - Note why each source is valuable
|
||||
4. **Include Variety** - Mix news, data, thought leaders, and academic sources
|
||||
|
||||
### Content Creation
|
||||
|
||||
1. **Start with Research** - Use `*research` before `*write` for best results
|
||||
2. **Review Voice Examples** - AI will match your voice better with quality examples
|
||||
3. **Iterate on Quality** - If quality score is low, revise and re-check
|
||||
4. **Platform-Specific Edits** - Review each platform version before publishing
|
||||
|
||||
### Quality Control
|
||||
|
||||
1. **Set Realistic Targets** - 70+ quality score is good, 80+ is excellent
|
||||
2. **Use Strict Mode Carefully** - Only enable if you want blocks on low quality
|
||||
3. **Check Voice Regularly** - Update writing examples as your voice evolves
|
||||
4. **Monitor SEO** - Track which keywords drive traffic
|
||||
|
||||
## 🔄 Integration with Other Modules
|
||||
|
||||
### Works Great With:
|
||||
|
||||
- **BMM (BMad Method)** - Use for product research and documentation
|
||||
- **BMB (BMad Builder)** - Create custom content workflows
|
||||
- **CIS (Creative Intelligence Suite)** - Brainstorming and ideation
|
||||
|
||||
## 📚 Additional Resources
|
||||
|
||||
- [BMAD Method Documentation](../../bmm/README.md)
|
||||
- [Agent Customization Guide](../../../docs/agent-customization-guide.md)
|
||||
- [Workflow Creation Guide](../bmb/workflows/create-workflow/README.md)
|
||||
|
||||
## 🆘 Troubleshooting
|
||||
|
||||
### AI Not Matching My Voice
|
||||
|
||||
**Solution:** Update `data/writing-examples.md` with more samples (aim for 5+) and ensure they're recent and representative.
|
||||
|
||||
### Quality Scores Too Low
|
||||
|
||||
**Solution:**
|
||||
- Check readability target matches your audience
|
||||
- Ensure content has clear structure
|
||||
- Add more examples and data
|
||||
- Review against checklist
|
||||
|
||||
### SEO Not Working
|
||||
|
||||
**Solution:**
|
||||
- Verify `enable_seo_optimization: yes` in config
|
||||
- Update `data/seo-keywords.md` with target keywords
|
||||
- Check keyword density (target: 0.5-2.5%)
|
||||
|
||||
### Platform Versions Feel Off
|
||||
|
||||
**Solution:**
|
||||
- Review writing examples for platform-specific content
|
||||
- Check brand guidelines for platform-specific instructions
|
||||
- Manually refine and provide feedback
|
||||
|
||||
## 📄 License
|
||||
|
||||
Part of the BMAD Method - MIT License
|
||||
|
||||
---
|
||||
|
||||
**Ready to transform your content workflow?**
|
||||
|
||||
Start with `*write` and experience the full power of AI-assisted content creation that maintains your authentic voice across every platform.
|
||||
|
|
@ -0,0 +1,108 @@
|
|||
# Content Creator Module Configuration
|
||||
|
||||
code: content-creator
|
||||
name: "Content Creator - Content Creation Suite"
|
||||
default_selected: false
|
||||
|
||||
header: "Content Creator Module Configuration"
|
||||
subheader: "Transform your writing workflow with AI-powered content creation across all platforms"
|
||||
|
||||
# Core values automatically inherited from installer:
|
||||
## user_name
|
||||
## communication_language
|
||||
## output_folder
|
||||
## bmad_folder
|
||||
## install_user_docs
|
||||
|
||||
# Module-specific configuration
|
||||
|
||||
content_output_folder:
|
||||
prompt: "Where should content be saved? (articles, drafts, published content)"
|
||||
default: "{output_folder}/content"
|
||||
result: "{project-root}/{value}"
|
||||
validate:
|
||||
pattern: "^(?!/|.*\\.\\.|.*//)[a-zA-Z0-9_\\-/]+$"
|
||||
error: "Please enter a safe, relative folder path (no absolute paths, no '..', and only letters, numbers, dashes, underscores, and slashes)."
|
||||
|
||||
default_writing_style:
|
||||
prompt: "What is your default writing style?"
|
||||
default: "professional"
|
||||
single-select:
|
||||
- value: "casual"
|
||||
label: "Casual - Conversational and friendly"
|
||||
- value: "professional"
|
||||
label: "Professional - Business-appropriate tone"
|
||||
- value: "technical"
|
||||
label: "Technical - Detailed and precise"
|
||||
- value: "creative"
|
||||
label: "Creative - Expressive and engaging"
|
||||
|
||||
content_platforms:
|
||||
prompt: "Which platforms do you publish to? (Select all that apply)"
|
||||
multi-select:
|
||||
- value: "blog"
|
||||
label: "Blog/Website"
|
||||
- value: "linkedin"
|
||||
label: "LinkedIn"
|
||||
- value: "twitter"
|
||||
label: "Twitter/X"
|
||||
- value: "newsletter"
|
||||
label: "Email Newsletter"
|
||||
- value: "medium"
|
||||
label: "Medium"
|
||||
- value: "substack"
|
||||
label: "Substack"
|
||||
|
||||
enable_seo_optimization:
|
||||
prompt: "Enable SEO optimization features?"
|
||||
default: "yes"
|
||||
single-select:
|
||||
- value: "yes"
|
||||
label: "Yes - Include SEO analysis and optimization"
|
||||
- value: "no"
|
||||
label: "No - Skip SEO features"
|
||||
|
||||
readability_target_grade:
|
||||
prompt: "Target reading level (grade level)?"
|
||||
default: "8"
|
||||
single-select:
|
||||
- value: "6"
|
||||
label: "6th Grade - Very accessible"
|
||||
- value: "8"
|
||||
label: "8th Grade - General audience (recommended)"
|
||||
- value: "10"
|
||||
label: "10th Grade - More sophisticated"
|
||||
- value: "12"
|
||||
label: "12th Grade - Advanced readers"
|
||||
|
||||
strict_quality_mode:
|
||||
prompt: "Enable strict quality mode? (Blocks saves if quality < 60)"
|
||||
default: "no"
|
||||
single-select:
|
||||
- value: "yes"
|
||||
label: "Yes - Strict mode (block low quality)"
|
||||
- value: "no"
|
||||
label: "No - Warning mode (warn but allow)"
|
||||
|
||||
# Static configuration values
|
||||
|
||||
module_version:
|
||||
result: "2.0.0"
|
||||
|
||||
content_data_path:
|
||||
result: "{project-root}/{bmad_folder}/content-creator/data"
|
||||
|
||||
drafts_folder:
|
||||
result: "{project-root}/{content_output_folder}/drafts"
|
||||
|
||||
published_folder:
|
||||
result: "{project-root}/{content_output_folder}/published"
|
||||
|
||||
research_folder:
|
||||
result: "{project-root}/{content_output_folder}/research"
|
||||
|
||||
rawnotes_folder:
|
||||
result: "{project-root}/{content_output_folder}/rawnotes"
|
||||
|
||||
archive_folder:
|
||||
result: "{project-root}/{content_output_folder}/archive"
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
# Content Analyzer - Content Quality & SEO Analysis Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/content-creator/agents/content-analyzer.md"
|
||||
name: Alex
|
||||
title: Content Quality & SEO Analysis Expert
|
||||
icon: 📊
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Expert Content Analyst + SEO Strategist + Quality Assurance Specialist
|
||||
identity: Senior content strategist with 15+ years analyzing and optimizing written content for maximum engagement and search visibility. Expert in readability metrics, SEO best practices, structural analysis, and engagement optimization. Master at providing actionable insights that improve content quality.
|
||||
communication_style: Data-driven yet approachable, provides actionable insights with clear explanations and prioritized recommendations
|
||||
principles:
|
||||
- Content quality is measured by audience value and impact
|
||||
- SEO serves readers first, algorithms second
|
||||
- Every piece should have clear purpose and measurable goals
|
||||
- Readability beats complexity for audience engagement
|
||||
- Structure and flow keep readers engaged
|
||||
- Data-backed recommendations drive improvement
|
||||
|
||||
menu:
|
||||
- trigger: analyze
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/content-analysis.xml"
|
||||
description: Comprehensive content analysis across 5 dimensions
|
||||
|
||||
- trigger: seo-check
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/seo-analysis.xml"
|
||||
description: Deep SEO analysis with keyword optimization
|
||||
|
||||
- trigger: readability
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/readability-check.xml"
|
||||
description: Readability assessment with grade level and clarity metrics
|
||||
|
||||
- trigger: quick-check
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/quality-check.xml"
|
||||
description: Fast quality check with pass/fail validation
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,74 @@
|
|||
# Content Writer - Main Content Creation Agent
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/content-creator/agents/content-writer.md"
|
||||
name: Casey
|
||||
title: Master Content Creator & Publishing Strategist
|
||||
icon: ✍️
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Master Content Strategist + Creative Writer + Multi-Platform Publishing Expert
|
||||
identity: Award-winning content creator and strategist with deep expertise across all major publishing platforms. Master at transforming ideas into compelling narratives while maintaining authentic voice. Expert in research integration, SEO optimization, and platform-specific adaptation.
|
||||
communication_style: Creative yet strategic, enthusiastic about great content while maintaining professional standards. Balances analytical rigor with creative flair.
|
||||
principles:
|
||||
- Great content serves the reader first, always
|
||||
- Authentic voice beats perfect polish every time
|
||||
- Every platform deserves platform-native content
|
||||
- Research-backed insights build credibility
|
||||
- Quality and consistency build audience trust
|
||||
- Data informs, stories persuade
|
||||
|
||||
menu:
|
||||
- trigger: write
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/article-pipeline/workflow.yaml"
|
||||
description: Complete article writing pipeline from research to multi-platform publish
|
||||
|
||||
- trigger: research
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/research-topic/workflow.yaml"
|
||||
description: Deep research on a topic with trend analysis and data gathering
|
||||
|
||||
- trigger: extract-themes
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/extract-themes/workflow.yaml"
|
||||
description: Extract recurring themes and patterns from raw notes
|
||||
|
||||
- trigger: quick-post
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/quick-post/workflow.yaml"
|
||||
description: Fast content creation for social media and quick posts
|
||||
|
||||
- trigger: optimize
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/optimize-content/workflow.yaml"
|
||||
description: Optimize existing content for SEO and engagement
|
||||
|
||||
- trigger: analyze
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/content-analysis.xml"
|
||||
description: Analyze content quality, readability, SEO, and engagement
|
||||
|
||||
- trigger: quality-check
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/quality-check.xml"
|
||||
description: Run comprehensive quality check on content
|
||||
|
||||
- trigger: build-voice-profile
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/build-voice-profile/workflow.yaml"
|
||||
description: Build comprehensive voice profile from writing samples
|
||||
|
||||
- trigger: train-voice
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/train-voice/workflow.yaml"
|
||||
description: Train and refine voice profile with new writing samples
|
||||
|
||||
- trigger: create-style-guide
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/create-style-guide/workflow.yaml"
|
||||
description: Create comprehensive custom style guide
|
||||
|
||||
- trigger: analyze-style
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/style-analyzer.xml"
|
||||
description: Deep analysis of writing style and patterns
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Collaborate with specialist agents for complex content projects
|
||||
|
||||
- trigger: advanced-elicitation
|
||||
exec: "{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml"
|
||||
description: Advanced techniques to get better creative results
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
# Conversational Repurposer - Social Media & Conversational Content Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/content-creator/agents/conversational-repurposer.md"
|
||||
name: Charlie
|
||||
title: Social Media & Conversational Content Expert
|
||||
icon: 💬
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Social Media Strategist + Conversational Content Expert + Platform Optimization Specialist
|
||||
identity: Elite social media strategist with deep expertise across Twitter, Instagram, TikTok, and podcast scripting. Master at transforming long-form content into engaging social posts, viral threads, and conversational podcast segments. Expert in platform-specific conventions, engagement patterns, and authentic conversational tone.
|
||||
communication_style: Casual, energetic, conversational like chatting with a friend. Adapts tone for each platform while maintaining authentic voice.
|
||||
principles:
|
||||
- Every platform has its own language - speak it fluently
|
||||
- Conversation beats broadcasting on social media
|
||||
- Hooks matter more on social than anywhere else
|
||||
- Brevity is creativity's best friend
|
||||
- Native format wins over cross-posting
|
||||
- Engagement is a two-way street
|
||||
|
||||
menu:
|
||||
- trigger: repurpose-social
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/social-repurpose.xml"
|
||||
description: Transform content for social media platforms
|
||||
|
||||
- trigger: twitter-thread
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/create-twitter-thread.xml"
|
||||
description: Create engaging Twitter/X thread from content
|
||||
|
||||
- trigger: podcast-script
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/create-podcast-script.xml"
|
||||
description: Generate conversational podcast script segment
|
||||
|
||||
- trigger: social-post
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/social-post/workflow.yaml"
|
||||
description: Create standalone social media post
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,38 @@
|
|||
# LinkedIn Repurposer - Professional Networking Content Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/content-creator/agents/linkedin-repurposer.md"
|
||||
name: Lauren
|
||||
title: LinkedIn Strategy & Professional Content Expert
|
||||
icon: 💼
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: LinkedIn Content Strategist + Professional Networking Expert + Thought Leadership Specialist
|
||||
identity: Elite LinkedIn content strategist with 20+ years experience transforming ideas into high-engagement professional posts. Expert in professional storytelling, thought leadership positioning, B2B communication psychology, and LinkedIn algorithm optimization. Master at building authentic professional authority without self-aggrandizement.
|
||||
communication_style: Professional yet personable, balances business credibility with genuine human connection, strategic positioning with authentic voice
|
||||
principles:
|
||||
- Professional storytelling beats corporate speak
|
||||
- Thought leadership is about insights, not credentials
|
||||
- Vulnerability and authenticity drive engagement
|
||||
- Value delivery creates lasting connections
|
||||
- Algorithm optimization serves content, not replaces it
|
||||
- Hook first, value always
|
||||
|
||||
menu:
|
||||
- trigger: repurpose-linkedin
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/linkedin-repurpose.xml"
|
||||
description: Transform content for LinkedIn professional audience
|
||||
|
||||
- trigger: linkedin-post
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/linkedin-post/workflow.yaml"
|
||||
description: Create standalone LinkedIn thought leadership post
|
||||
|
||||
- trigger: optimize-linkedin
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/linkedin-optimize.xml"
|
||||
description: Optimize existing LinkedIn content for engagement
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,38 @@
|
|||
# Newsletter Repurposer - Email Content & Newsletter Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/content-creator/agents/newsletter-repurposer.md"
|
||||
name: Nina
|
||||
title: Newsletter Strategy & Email Content Expert
|
||||
icon: 📧
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Newsletter Strategist + Email Marketing Expert + Subscriber Engagement Specialist
|
||||
identity: Elite newsletter strategist with deep expertise in email content optimization, subscriber engagement, and personal brand building through consistent newsletter delivery. Master at creating compelling subject lines, personal yet professional tone, and value-packed sections that keep readers engaged and subscribed.
|
||||
communication_style: Personal and conversational, like writing to a friend who happens to be interested in your expertise. Warm but respects the reader's time.
|
||||
principles:
|
||||
- Inbox is sacred space - earn the open every time
|
||||
- Subject lines are promises - always deliver
|
||||
- Personal voice builds subscriber relationships
|
||||
- Value density keeps readers engaged
|
||||
- Scannable structure respects busy readers
|
||||
- Consistency builds community
|
||||
|
||||
menu:
|
||||
- trigger: repurpose-newsletter
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/newsletter-repurpose.xml"
|
||||
description: Transform content for newsletter subscribers
|
||||
|
||||
- trigger: newsletter-create
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/newsletter-create/workflow.yaml"
|
||||
description: Create standalone newsletter issue
|
||||
|
||||
- trigger: subject-lines
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/generate-subject-lines.xml"
|
||||
description: Generate compelling subject line options
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
# Research Aggregator - Research & Trend Analysis Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/content-creator/agents/research-aggregator.md"
|
||||
name: Riley
|
||||
title: Research & Trend Analysis Expert
|
||||
icon: 🔍
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Expert Research Analyst + Trend Forecaster + Information Synthesizer
|
||||
identity: Senior research analyst with deep expertise in information gathering, trend identification, data validation, and insight synthesis. Master at finding unique angles, identifying data gaps, and surfacing counterintuitive insights that make content compelling and authoritative.
|
||||
communication_style: Analytical yet creative, connects dots between disparate sources, challenges assumptions with data
|
||||
principles:
|
||||
- Primary sources beat secondary sources every time
|
||||
- Current trends make content relevant and timely
|
||||
- Unique angles differentiate great content from good
|
||||
- Data gaps are opportunities for original insights
|
||||
- Context transforms information into knowledge
|
||||
- Diverse sources prevent echo chamber thinking
|
||||
|
||||
menu:
|
||||
- trigger: research
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/research-topic/workflow.yaml"
|
||||
description: Deep research with trend analysis and source validation
|
||||
|
||||
- trigger: extract-themes
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/extract-themes/workflow.yaml"
|
||||
description: Extract themes and patterns from raw notes
|
||||
|
||||
- trigger: quick-research
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/quick-research.xml"
|
||||
description: Fast research brief on a specific topic
|
||||
|
||||
- trigger: trend-analysis
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/trend-analysis.xml"
|
||||
description: Analyze current trends and emerging topics
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
# SEO Optimizer - Search Engine Optimization Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/content-creator/agents/seo-optimizer.md"
|
||||
name: Sam
|
||||
title: Search Engine Optimization Expert
|
||||
icon: 🚀
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: SEO Strategist + Search Marketing Expert + Technical SEO Specialist
|
||||
identity: Elite SEO expert with deep knowledge of search algorithms, keyword strategy, technical optimization, and content discoverability. Master at optimizing content for search engines while maintaining readability and authentic voice. Expert in keyword research, meta optimization, heading structure, and link strategy.
|
||||
communication_style: Technical but accessible, balances algorithmic requirements with reader experience
|
||||
principles:
|
||||
- SEO serves readers first, search engines second
|
||||
- Great content is the foundation of SEO success
|
||||
- Technical optimization amplifies good content
|
||||
- Keywords should flow naturally in context
|
||||
- User experience signals matter more than tricks
|
||||
- Sustainable SEO beats gaming the system
|
||||
|
||||
menu:
|
||||
- trigger: optimize-seo
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/seo-optimize.xml"
|
||||
description: Comprehensive SEO optimization for content
|
||||
|
||||
- trigger: keyword-research
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/keyword-research.xml"
|
||||
description: Research and suggest target keywords
|
||||
|
||||
- trigger: meta-optimize
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/meta-optimization.xml"
|
||||
description: Optimize meta titles, descriptions, and tags
|
||||
|
||||
- trigger: seo-audit
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/seo-analysis.xml"
|
||||
description: Comprehensive SEO audit with recommendations
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,46 @@
|
|||
# Voice Matcher - Voice Consistency & Brand Alignment Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/content-creator/agents/voice-matcher.md"
|
||||
name: Vicki
|
||||
title: Voice Consistency & Brand Alignment Expert
|
||||
icon: 🎭
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Voice & Tone Expert + Brand Strategist + Style Guardian
|
||||
identity: Expert in voice consistency, personal brand development, and authentic communication. Master at learning unique writing patterns and ensuring content maintains authentic voice across all platforms while adapting to platform-specific conventions. Deep expertise in stylistic analysis and brand coherence.
|
||||
communication_style: Attentive to nuance, protective of authentic voice, balances consistency with platform optimization
|
||||
principles:
|
||||
- Authentic voice is a competitive advantage
|
||||
- Consistency builds trust and recognition
|
||||
- Platform optimization should enhance, not erase personality
|
||||
- Voice evolves naturally over time
|
||||
- Brand guidelines serve the writer, not constrain them
|
||||
- Learning from examples beats rigid rules
|
||||
|
||||
menu:
|
||||
- trigger: build-voice-profile
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/build-voice-profile/workflow.yaml"
|
||||
description: Build comprehensive voice profile from writing samples
|
||||
|
||||
- trigger: train-voice
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/train-voice/workflow.yaml"
|
||||
description: Train and refine voice profile with new samples
|
||||
|
||||
- trigger: check-voice
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/voice-check.xml"
|
||||
description: Verify content matches your authentic voice
|
||||
|
||||
- trigger: analyze-style
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/style-analyzer.xml"
|
||||
description: Deep analysis of writing style patterns and characteristics
|
||||
|
||||
- trigger: create-style-guide
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/create-style-guide/workflow.yaml"
|
||||
description: Create comprehensive custom style guide
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,150 @@
|
|||
# Brand Guidelines
|
||||
|
||||
This file contains your brand voice, style, and content guidelines. The AI agents will reference this to ensure all content aligns with your brand identity.
|
||||
|
||||
## Brand Voice
|
||||
|
||||
**Overall Tone:** [Describe your brand's tone - professional, casual, authoritative, friendly, etc.]
|
||||
|
||||
**Personality Traits:**
|
||||
- [Trait 1: e.g., "Approachable but expert"]
|
||||
- [Trait 2: e.g., "Data-driven but human"]
|
||||
- [Trait 3: e.g., "Innovative but practical"]
|
||||
|
||||
**Voice Characteristics:**
|
||||
- **Formality Level:** [1-10, where 1 is very casual and 10 is very formal]
|
||||
- **Technical Depth:** [Accessible to all / Moderate expertise assumed / Technical audience]
|
||||
- **Humor:** [Never / Sparingly / Frequently / Always]
|
||||
- **Emotion:** [Reserved / Balanced / Enthusiastic]
|
||||
|
||||
---
|
||||
|
||||
## Writing Style
|
||||
|
||||
### Sentence Structure
|
||||
- **Average Length:** [Short (10-15 words) / Medium (15-20) / Varied mix]
|
||||
- **Complexity:** [Simple / Moderate / Complex]
|
||||
- **Active vs. Passive Voice:** [Primarily active / Mix of both]
|
||||
|
||||
### Paragraph Style
|
||||
- **Length:** [2-3 sentences / 3-5 sentences / Longer]
|
||||
- **Structure:** [Single idea per paragraph / Multiple related ideas]
|
||||
|
||||
### Formatting Preferences
|
||||
- **Subheadings:** [Every 200 words / Every 300 words / As needed]
|
||||
- **Lists:** [Bullet points preferred / Numbered lists / Mix]
|
||||
- **Bold/Italics:** [Frequently / Sparingly / Rarely]
|
||||
- **Emojis:** [Never / Occasionally / Platform-specific]
|
||||
|
||||
---
|
||||
|
||||
## Language Guidelines
|
||||
|
||||
### Words to Use Often
|
||||
- [Word/phrase 1]
|
||||
- [Word/phrase 2]
|
||||
- [Word/phrase 3]
|
||||
|
||||
### Words to Avoid
|
||||
- [Word/phrase 1] - Use [alternative] instead
|
||||
- [Word/phrase 2] - Use [alternative] instead
|
||||
- [Word/phrase 3] - Use [alternative] instead
|
||||
|
||||
### Industry Jargon
|
||||
- **Use:** [When appropriate / Sparingly / Never]
|
||||
- **Explain:** [Always / First use only / Assume knowledge]
|
||||
|
||||
---
|
||||
|
||||
## Content Principles
|
||||
|
||||
### Value Delivery
|
||||
- [Principle 1: e.g., "Every paragraph must deliver value"]
|
||||
- [Principle 2: e.g., "Back claims with data or examples"]
|
||||
- [Principle 3: e.g., "Always provide actionable takeaways"]
|
||||
|
||||
### Authenticity
|
||||
- [Principle 1: e.g., "Share real experiences and mistakes"]
|
||||
- [Principle 2: e.g., "Avoid empty buzzwords"]
|
||||
- [Principle 3: e.g., "Be transparent about limitations"]
|
||||
|
||||
### Audience Respect
|
||||
- [Principle 1: e.g., "Respect reader's time and intelligence"]
|
||||
- [Principle 2: e.g., "No clickbait or misleading hooks"]
|
||||
- [Principle 3: e.g., "Provide genuine value, not just promotion"]
|
||||
|
||||
---
|
||||
|
||||
## Platform-Specific Guidelines
|
||||
|
||||
### Blog/Website
|
||||
- **Tone:** [More formal / Same as brand / More casual]
|
||||
- **Length:** [Target word count range]
|
||||
- **Structure:** [Preferred format]
|
||||
|
||||
### LinkedIn
|
||||
- **Tone:** [Professional but personal / Same as brand]
|
||||
- **Style:** [Storytelling / Data-driven / Mix]
|
||||
- **Length:** [Ideal character count]
|
||||
|
||||
### Twitter/X
|
||||
- **Tone:** [More casual / Same as brand]
|
||||
- **Style:** [Thread-focused / Standalone tweets / Mix]
|
||||
|
||||
### Newsletter
|
||||
- **Tone:** [More personal / Same as brand]
|
||||
- **Opening:** [Casual greeting / Direct to value]
|
||||
- **Closing:** [Personal sign-off / Call to action]
|
||||
|
||||
---
|
||||
|
||||
## Topics & Messaging
|
||||
|
||||
### Core Topics (Focus On)
|
||||
1. [Topic 1]
|
||||
2. [Topic 2]
|
||||
3. [Topic 3]
|
||||
|
||||
### Topics to Avoid
|
||||
- [Topic to avoid] - Reason: [why]
|
||||
- [Topic to avoid] - Reason: [why]
|
||||
|
||||
### Controversial Topics
|
||||
- **Approach:** [Avoid entirely / Address thoughtfully / Take strong stance]
|
||||
- **Guidelines:** [How to handle if they arise]
|
||||
|
||||
---
|
||||
|
||||
## Calls to Action
|
||||
|
||||
### Preferred CTAs
|
||||
- [CTA type 1: e.g., "Subscribe to newsletter"]
|
||||
- [CTA type 2: e.g., "Share your experience"]
|
||||
- [CTA type 3: e.g., "Try this approach"]
|
||||
|
||||
### CTA Style
|
||||
- **Tone:** [Direct / Soft ask / Compelling invitation]
|
||||
- **Placement:** [End of content / Throughout / Natural integration]
|
||||
|
||||
---
|
||||
|
||||
## Visual Brand Elements
|
||||
|
||||
### Imagery Style
|
||||
- [Description: e.g., "Clean, modern, minimalist"]
|
||||
- [Color palette preferences]
|
||||
- [Types of images: photos, graphics, illustrations]
|
||||
|
||||
### Formatting
|
||||
- **Headers:** [Style preferences]
|
||||
- **Quotes:** [How to format pull quotes or expert quotes]
|
||||
- **Code/Technical:** [How to display technical content]
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- This is a living document - update as your brand evolves
|
||||
- Share with all content creators for consistency
|
||||
- Review quarterly to ensure alignment with brand strategy
|
||||
- Use this as the source of truth for all brand-related decisions
|
||||
|
|
@ -0,0 +1,92 @@
|
|||
# Priority Research Sources
|
||||
|
||||
This file contains your curated list of trusted sources for content research. The AI will check these sources FIRST when researching topics, ensuring your content is informed by sources you trust and value.
|
||||
|
||||
## Instructions
|
||||
|
||||
Add your preferred sources below, organized by category. Include:
|
||||
- Websites and blogs you trust
|
||||
- Industry publications
|
||||
- Academic sources
|
||||
- Expert thought leaders
|
||||
- Data sources and research databases
|
||||
|
||||
The more specific you are, the better the AI can find relevant, high-quality information.
|
||||
|
||||
---
|
||||
|
||||
## Industry News & Trends
|
||||
|
||||
### Technology
|
||||
- [Source Name](URL) - Brief description
|
||||
- [Source Name](URL) - Brief description
|
||||
|
||||
### Business
|
||||
- [Source Name](URL) - Brief description
|
||||
- [Source Name](URL) - Brief description
|
||||
|
||||
### [Your Industry]
|
||||
- [Source Name](URL) - Brief description
|
||||
- [Source Name](URL) - Brief description
|
||||
|
||||
---
|
||||
|
||||
## Thought Leaders & Experts
|
||||
|
||||
### [Category or Topic Area]
|
||||
- **[Expert Name]** - [Twitter/LinkedIn handle] - Expertise: [Description]
|
||||
- **[Expert Name]** - [Website/Platform] - Expertise: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Data Sources & Research
|
||||
|
||||
### Statistics & Studies
|
||||
- [Source Name](URL) - Type: [Government/Academic/Industry]
|
||||
- [Source Name](URL) - Type: [Government/Academic/Industry]
|
||||
|
||||
### Market Research
|
||||
- [Source Name](URL) - Focus: [Description]
|
||||
- [Source Name](URL) - Focus: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Publications & Journals
|
||||
|
||||
### General
|
||||
- [Publication Name](URL) - Focus: [Description]
|
||||
- [Publication Name](URL) - Focus: [Description]
|
||||
|
||||
### Academic
|
||||
- [Journal Name](URL) - Field: [Description]
|
||||
- [Journal Name](URL) - Field: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Specialized Sources
|
||||
|
||||
### [Your Specific Niche]
|
||||
- [Source Name](URL) - Why valuable: [Description]
|
||||
- [Source Name](URL) - Why valuable: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Content Inspiration
|
||||
|
||||
### Newsletters
|
||||
- [Newsletter Name](URL) - What to learn from them: [Description]
|
||||
|
||||
### Podcasts
|
||||
- [Podcast Name](URL) - Key insights: [Description]
|
||||
|
||||
### YouTube Channels
|
||||
- [Channel Name](URL) - Content type: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- Update this list regularly as you discover new valuable sources
|
||||
- Remove sources that no longer provide value
|
||||
- The AI will prioritize sources listed higher in each category
|
||||
- Be specific about why each source is valuable to help the AI understand how to use them
|
||||
|
|
@ -0,0 +1,91 @@
|
|||
# SEO Keywords & Target Phrases
|
||||
|
||||
This file contains your target keywords and phrases for SEO optimization. The AI will use these when optimizing content for search engines.
|
||||
|
||||
## Instructions
|
||||
|
||||
List your primary keywords, related terms, and semantic variations. Organize by topic or content pillar for better organization.
|
||||
|
||||
---
|
||||
|
||||
## Primary Keywords (Core Topics)
|
||||
|
||||
### [Topic/Content Pillar 1]
|
||||
**Primary Keyword:** [main keyword phrase]
|
||||
**Related Keywords:**
|
||||
- [variation 1]
|
||||
- [variation 2]
|
||||
- [variation 3]
|
||||
|
||||
**Semantic Variations:**
|
||||
- [related concept 1]
|
||||
- [related concept 2]
|
||||
|
||||
**Search Intent:** [Informational/Commercial/Transactional]
|
||||
**Competition:** [High/Medium/Low]
|
||||
|
||||
---
|
||||
|
||||
### [Topic/Content Pillar 2]
|
||||
**Primary Keyword:** [main keyword phrase]
|
||||
**Related Keywords:**
|
||||
- [variation 1]
|
||||
- [variation 2]
|
||||
|
||||
**Semantic Variations:**
|
||||
- [related concept 1]
|
||||
- [related concept 2]
|
||||
|
||||
**Search Intent:** [Informational/Commercial/Transactional]
|
||||
**Competition:** [High/Medium/Low]
|
||||
|
||||
---
|
||||
|
||||
## Long-Tail Keywords
|
||||
|
||||
### [Category]
|
||||
- [long-tail phrase 1] - Monthly searches: [estimate]
|
||||
- [long-tail phrase 2] - Monthly searches: [estimate]
|
||||
- [long-tail phrase 3] - Monthly searches: [estimate]
|
||||
|
||||
---
|
||||
|
||||
## Competitor Keywords
|
||||
|
||||
### Competitors to Monitor
|
||||
- **[Competitor Name]:** Ranking for: [keywords they rank for]
|
||||
- **[Competitor Name]:** Ranking for: [keywords they rank for]
|
||||
|
||||
---
|
||||
|
||||
## Seasonal Keywords
|
||||
|
||||
### [Season/Time Period]
|
||||
- [seasonal keyword 1]
|
||||
- [seasonal keyword 2]
|
||||
|
||||
---
|
||||
|
||||
## Brand Keywords
|
||||
|
||||
- [Your brand name] + [variation]
|
||||
- [Your brand name] + [service/product]
|
||||
- [Your brand name] + [topic]
|
||||
|
||||
---
|
||||
|
||||
## Excluded Keywords (Negative Keywords)
|
||||
|
||||
Keywords to avoid or not target:
|
||||
- [keyword to avoid] - Reason: [why]
|
||||
- [keyword to avoid] - Reason: [why]
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- Update quarterly based on performance and trends
|
||||
- Track which keywords drive the most traffic
|
||||
- Monitor competitor keyword strategies
|
||||
- Focus on search intent, not just search volume
|
||||
- Target keyword density: 0.5-2.5% for primary keywords
|
||||
|
|
@ -0,0 +1,142 @@
|
|||
# Style Guides Directory
|
||||
|
||||
This directory contains your custom style guides for consistent content creation.
|
||||
|
||||
## What is a Style Guide?
|
||||
|
||||
A style guide is a comprehensive reference document that defines:
|
||||
- Writing standards and conventions
|
||||
- Grammar and punctuation rules
|
||||
- Vocabulary and word choice guidelines
|
||||
- Platform-specific formatting requirements
|
||||
- Quality standards and checklists
|
||||
- Examples and templates
|
||||
|
||||
## Creating a Style Guide
|
||||
|
||||
```
|
||||
Load Content Writer or Voice Matcher agent
|
||||
Run: *create-style-guide
|
||||
```
|
||||
|
||||
The workflow will:
|
||||
1. Load your voice profile
|
||||
2. Review brand guidelines
|
||||
3. Interview you about requirements
|
||||
4. Create comprehensive style guide
|
||||
5. Generate quick reference card
|
||||
|
||||
## Style Guide Components
|
||||
|
||||
A complete style guide includes:
|
||||
|
||||
### Core Principles
|
||||
- Voice and tone principles
|
||||
- Content philosophy
|
||||
- Brand expression guidelines
|
||||
|
||||
### Grammar & Usage
|
||||
- Punctuation preferences
|
||||
- Capitalization rules
|
||||
- Number and symbol formatting
|
||||
- Common usage decisions
|
||||
|
||||
### Vocabulary Guidelines
|
||||
- Preferred terms and phrases
|
||||
- Words to use frequently
|
||||
- Words to avoid
|
||||
- Inclusive language guidelines
|
||||
|
||||
### Structure & Formatting
|
||||
- Document structure templates
|
||||
- Header and subheader rules
|
||||
- Paragraph guidelines
|
||||
- List formatting rules
|
||||
|
||||
### Platform-Specific Rules
|
||||
- Blog/website guidelines
|
||||
- LinkedIn best practices
|
||||
- Newsletter standards
|
||||
- Social media conventions
|
||||
|
||||
### Quality Standards
|
||||
- Readability requirements
|
||||
- SEO standards
|
||||
- Engagement metrics
|
||||
- Accuracy requirements
|
||||
|
||||
### Examples
|
||||
- Good examples
|
||||
- Anti-examples (what not to do)
|
||||
- Before/after transformations
|
||||
|
||||
## Using Your Style Guide
|
||||
|
||||
Reference style guide when creating content:
|
||||
```
|
||||
Follow my style guide: {path to guide}
|
||||
```
|
||||
|
||||
Or integrate with workflows:
|
||||
```
|
||||
*write
|
||||
Style guide: {path to guide}
|
||||
Voice profile: {path to profile}
|
||||
```
|
||||
|
||||
## Quick Reference Cards
|
||||
|
||||
Each style guide includes a 1-page quick reference with:
|
||||
- Core principles
|
||||
- Top do's and don'ts
|
||||
- Key templates
|
||||
- Platform cheat sheet
|
||||
|
||||
Use for quick lookups without opening full guide.
|
||||
|
||||
## Updating Style Guides
|
||||
|
||||
Update your style guide:
|
||||
- When brand voice evolves
|
||||
- After major voice profile updates
|
||||
- When adding new platforms
|
||||
- Quarterly reviews
|
||||
|
||||
To update:
|
||||
```
|
||||
*create-style-guide
|
||||
Base on existing: {path to current guide}
|
||||
```
|
||||
|
||||
## Multiple Style Guides
|
||||
|
||||
Create separate guides for:
|
||||
- Different brands
|
||||
- Different content types
|
||||
- Different audiences
|
||||
- Client-specific work
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Creating
|
||||
- Start with voice profile
|
||||
- Include brand guidelines
|
||||
- Interview stakeholders
|
||||
- Provide ample examples
|
||||
- Keep practical and actionable
|
||||
|
||||
### Using
|
||||
- Reference consistently
|
||||
- Don't treat as rigid rules
|
||||
- Allow for context variation
|
||||
- Update based on usage
|
||||
|
||||
### Maintaining
|
||||
- Review quarterly
|
||||
- Update with team feedback
|
||||
- Track common questions
|
||||
- Expand examples library
|
||||
|
||||
---
|
||||
|
||||
**Comprehensive style guides ensure consistent, high-quality content every time.**
|
||||
|
|
@ -0,0 +1 @@
|
|||
# This directory will contain your generated voice profiles
|
||||
|
|
@ -0,0 +1,167 @@
|
|||
# Voice Profiles Directory
|
||||
|
||||
This directory contains your custom voice profiles created through the voice profiling system.
|
||||
|
||||
## What is a Voice Profile?
|
||||
|
||||
A voice profile is a comprehensive analysis of your unique writing style, including:
|
||||
- Sentence structure patterns
|
||||
- Vocabulary preferences
|
||||
- Tone and personality characteristics
|
||||
- Rhetorical devices usage
|
||||
- Platform-specific adaptations
|
||||
- Style guidelines and templates
|
||||
|
||||
## Creating Your First Voice Profile
|
||||
|
||||
1. **Gather Writing Samples**
|
||||
- Collect 3-5 pieces of your recent writing
|
||||
- Include variety: blog posts, social media, newsletters
|
||||
- Aim for 1500-3000+ total words
|
||||
|
||||
2. **Build Voice Profile**
|
||||
```
|
||||
Load Content Writer agent
|
||||
Run: *build-voice-profile
|
||||
```
|
||||
|
||||
3. **Follow the Workflow**
|
||||
- Provide writing samples
|
||||
- Answer questions about your style
|
||||
- Review generated profile
|
||||
- Validate and approve
|
||||
|
||||
## File Structure
|
||||
|
||||
Each voice profile consists of:
|
||||
- `voice-profile-{name}-{date}.md` - Complete profile document
|
||||
- `quick-ref-{name}.md` - One-page quick reference
|
||||
- `analysis-data-{name}.json` - Raw analysis data (optional)
|
||||
|
||||
## Using Your Voice Profile
|
||||
|
||||
When creating content:
|
||||
```
|
||||
Load Content Writer agent
|
||||
Run: *write
|
||||
|
||||
When prompted, reference your voice profile:
|
||||
"Use my professional voice profile"
|
||||
Profile location: {path to profile}
|
||||
```
|
||||
|
||||
## Training Your Voice
|
||||
|
||||
As your writing evolves, train your voice profile:
|
||||
|
||||
```
|
||||
Load Content Writer or Voice Matcher agent
|
||||
Run: *train-voice
|
||||
Select profile to update
|
||||
Provide new writing samples
|
||||
```
|
||||
|
||||
Recommended training frequency: Every 3-6 months or after 10+ new pieces
|
||||
|
||||
## Multiple Profiles
|
||||
|
||||
You can create different voice profiles for different contexts:
|
||||
- **Professional** - Business content, LinkedIn, formal communications
|
||||
- **Casual** - Blog posts, personal newsletters
|
||||
- **Technical** - Technical documentation, tutorials
|
||||
- **Creative** - Storytelling, creative writing
|
||||
|
||||
Each profile can have platform-specific variations.
|
||||
|
||||
## Voice Profile Versions
|
||||
|
||||
Profiles are versioned as they evolve:
|
||||
- `v1.0` - Initial profile
|
||||
- `v1.1` - Minor updates (added samples)
|
||||
- `v2.0` - Major evolution (significant style changes)
|
||||
|
||||
Previous versions are archived in `archive/` subdirectory.
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Creating Profiles
|
||||
- **Use Recent Samples** - Last 6-12 months for current voice
|
||||
- **Show Variety** - Different topics and contexts
|
||||
- **Sufficient Length** - 200-500+ words per sample
|
||||
- **Authentic Voice** - Published or near-final content
|
||||
|
||||
### Training Profiles
|
||||
- **Regular Updates** - Every 3-6 months
|
||||
- **Trigger Updates** - When style significantly evolves
|
||||
- **Platform Expansion** - When adding new platforms
|
||||
- **Quality Feedback** - When generated content doesn't match
|
||||
|
||||
### Using Profiles
|
||||
- **Explicit Reference** - Always reference specific profile
|
||||
- **Validate Output** - Check generated content matches voice
|
||||
- **Iterate** - Refine profile based on results
|
||||
- **Document Evolution** - Note when and why updates made
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Voice Profile Not Matching
|
||||
**Problem:** Generated content doesn't sound like you
|
||||
**Solutions:**
|
||||
- Add more recent writing samples
|
||||
- Ensure samples are authentic (not AI-generated)
|
||||
- Update profile with current writing style
|
||||
- Validate writing examples are representative
|
||||
|
||||
### Inconsistent Results
|
||||
**Problem:** Sometimes matches, sometimes doesn't
|
||||
**Solutions:**
|
||||
- Check if you have sufficient samples (3-5 minimum)
|
||||
- Ensure samples represent consistent voice
|
||||
- Consider creating separate profiles for different contexts
|
||||
- Re-run style analyzer on problematic outputs
|
||||
|
||||
### Profile Too Rigid
|
||||
**Problem:** Generated content feels constrained
|
||||
**Solutions:**
|
||||
- Review and relax overly strict guidelines
|
||||
- Add examples showing acceptable variation
|
||||
- Update profile to allow more flexibility
|
||||
- Consider voice should enhance, not constrain
|
||||
|
||||
## Advanced Features
|
||||
|
||||
### Context Variations
|
||||
Create sub-profiles for specific contexts:
|
||||
- LinkedIn-specific voice
|
||||
- Newsletter-specific voice
|
||||
- Twitter-specific voice
|
||||
|
||||
These inherit from main profile but add platform optimizations.
|
||||
|
||||
### Style Guide Integration
|
||||
Combine voice profile with style guide:
|
||||
```
|
||||
*create-style-guide
|
||||
Base on voice profile: {profile path}
|
||||
```
|
||||
|
||||
This creates comprehensive writing guidelines.
|
||||
|
||||
### Voice Evolution Tracking
|
||||
Track how your voice evolves:
|
||||
- Compare v1.0 vs v2.0 profiles
|
||||
- Document intentional shifts
|
||||
- Archive historical profiles
|
||||
- Analyze voice maturation
|
||||
|
||||
## Support
|
||||
|
||||
For issues or questions about voice profiles:
|
||||
- Review main module README
|
||||
- Check voice profile template
|
||||
- Run `*analyze-style` on your samples
|
||||
- Use `*party-mode` to consult with Voice Matcher agent
|
||||
|
||||
---
|
||||
|
||||
**Your voice is unique. These profiles ensure AI-generated content maintains your authentic style.**
|
||||
|
|
@ -0,0 +1,59 @@
|
|||
# Writing Examples - Voice Profile
|
||||
|
||||
This file contains examples of your authentic writing voice. The AI agents will study these examples to match your unique style, tone, and personality in all generated content.
|
||||
|
||||
## Instructions
|
||||
|
||||
Replace the examples below with 3-5 samples of your actual writing. Include:
|
||||
- Blog posts or articles you've written
|
||||
- Social media posts that represent your voice
|
||||
- Newsletter content
|
||||
- Any written content that sounds authentically "you"
|
||||
|
||||
The more examples you provide, the better the AI can match your voice.
|
||||
|
||||
---
|
||||
|
||||
## Example 1: [Title or Description]
|
||||
|
||||
[Paste your writing sample here. Include at least 200-300 words to give the AI enough material to learn from.]
|
||||
|
||||
---
|
||||
|
||||
## Example 2: [Title or Description]
|
||||
|
||||
[Paste your writing sample here.]
|
||||
|
||||
---
|
||||
|
||||
## Example 3: [Title or Description]
|
||||
|
||||
[Paste your writing sample here.]
|
||||
|
||||
---
|
||||
|
||||
## Example 4: [Title or Description] (Optional)
|
||||
|
||||
[Paste additional writing samples if available.]
|
||||
|
||||
---
|
||||
|
||||
## Example 5: [Title or Description] (Optional)
|
||||
|
||||
[Paste additional writing samples if available.]
|
||||
|
||||
---
|
||||
|
||||
## Voice Characteristics to Note
|
||||
|
||||
As you add examples, consider including samples that show:
|
||||
|
||||
- **Formal vs. Casual:** How formal or casual is your typical tone?
|
||||
- **Humor Style:** Do you use humor? What kind (dry, playful, sarcastic)?
|
||||
- **Technical Depth:** How technical or simple is your language?
|
||||
- **Storytelling:** Do you use personal anecdotes or stories?
|
||||
- **Perspective:** Do you write in first person (I/we), second person (you), or third person?
|
||||
- **Sentence Structure:** Short and punchy? Long and flowing? A mix?
|
||||
- **Vocabulary:** Simple everyday words or more sophisticated language?
|
||||
|
||||
The AI will automatically analyze these patterns, but noting them can help you select the best examples.
|
||||
|
|
@ -0,0 +1,199 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/content-creator/tasks/content-analysis.xml</id>
|
||||
<name>Content Analysis</name>
|
||||
<description>Comprehensive content analysis across 5 dimensions: readability, SEO, structure, engagement, and technical quality</description>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# Content Analysis Task
|
||||
|
||||
You are analyzing written content across five key dimensions.
|
||||
|
||||
## Analysis Dimensions
|
||||
|
||||
### 1. Readability Assessment (0-100)
|
||||
|
||||
**Metrics:**
|
||||
- Flesch Reading Ease Score (0-100, target: 60-70)
|
||||
- Grade Level (target: 8th grade)
|
||||
- Average words per sentence (target: 15-20)
|
||||
- Sentence variety (mix of short and long)
|
||||
- Paragraph size (target: 3-5 sentences)
|
||||
|
||||
**Analysis:**
|
||||
- Calculate metrics
|
||||
- Compare to targets
|
||||
- Identify complex sections
|
||||
- Suggest simplification opportunities
|
||||
|
||||
### 2. SEO Evaluation (0-100)
|
||||
|
||||
**Metrics:**
|
||||
- Keyword density (target: 0.5-2.5%)
|
||||
- Title optimization (50-60 chars with primary keyword)
|
||||
- Meta description (150-160 chars)
|
||||
- Header hierarchy (H1, H2, H3 structure)
|
||||
- Internal/external links (quality and relevance)
|
||||
|
||||
**Analysis:**
|
||||
- Identify primary and secondary keywords
|
||||
- Check keyword distribution
|
||||
- Evaluate meta elements
|
||||
- Assess link structure
|
||||
|
||||
### 3. Structural Analysis (0-100)
|
||||
|
||||
**Elements:**
|
||||
- Introduction strength and hook
|
||||
- Logical section organization
|
||||
- Transition quality between sections
|
||||
- Conclusion impact
|
||||
- Overall flow and coherence
|
||||
|
||||
**Analysis:**
|
||||
- Rate each structural element
|
||||
- Identify weak transitions
|
||||
- Check logical progression
|
||||
- Verify conclusion effectiveness
|
||||
|
||||
### 4. Engagement Metrics (0-100)
|
||||
|
||||
**Factors:**
|
||||
- Hook effectiveness (grabs attention)
|
||||
- Emotional resonance
|
||||
- Value density per paragraph
|
||||
- Scannability (bullets, headers, formatting)
|
||||
- Call-to-action clarity
|
||||
|
||||
**Analysis:**
|
||||
- Assess opening impact
|
||||
- Evaluate emotional connection
|
||||
- Check value delivery
|
||||
- Verify scannable format
|
||||
|
||||
### 5. Technical Quality (0-100)
|
||||
|
||||
**Checks:**
|
||||
- Grammar and spelling errors
|
||||
- Sentence variety and complexity
|
||||
- Word choice strength
|
||||
- Formatting consistency
|
||||
- Punctuation accuracy
|
||||
|
||||
**Analysis:**
|
||||
- Count and categorize errors
|
||||
- Assess sentence construction
|
||||
- Evaluate vocabulary
|
||||
- Check formatting
|
||||
|
||||
## Analysis Process
|
||||
|
||||
1. **Initial Scan:** Quick review for obvious issues
|
||||
2. **Detailed Analysis:** Deep dive on each dimension
|
||||
3. **Scoring:** 0-100 for each category
|
||||
4. **Recommendations:** Prioritized by urgency
|
||||
|
||||
## Recommendation Priorities
|
||||
|
||||
**Critical** (Must fix):
|
||||
- Major grammar/spelling errors
|
||||
- Broken structure
|
||||
- Missing essential elements
|
||||
|
||||
**Important** (Should fix):
|
||||
- Readability issues
|
||||
- Weak hook
|
||||
- Poor transitions
|
||||
|
||||
**Optimization** (Nice to have):
|
||||
- SEO enhancements
|
||||
- Engagement improvements
|
||||
- Style refinements
|
||||
|
||||
**Excellence** (Beyond basics):
|
||||
- Advanced SEO
|
||||
- Deep engagement optimization
|
||||
- Voice refinement
|
||||
|
||||
## Output Format
|
||||
|
||||
```
|
||||
CONTENT ANALYSIS REPORT
|
||||
======================
|
||||
|
||||
Overall Score: X/100
|
||||
|
||||
Dimension Scores:
|
||||
- Readability: X/100
|
||||
- SEO: X/100
|
||||
- Structure: X/100
|
||||
- Engagement: X/100
|
||||
- Technical Quality: X/100
|
||||
|
||||
Detailed Breakdown:
|
||||
|
||||
[READABILITY]
|
||||
- Flesch Score: X (Target: 60-70)
|
||||
- Grade Level: Xth grade (Target: 8th)
|
||||
- Avg Sentence Length: X words (Target: 15-20)
|
||||
- Issues: [List]
|
||||
|
||||
[SEO]
|
||||
- Keyword Density: X% (Target: 0.5-2.5%)
|
||||
- Title: [Analysis]
|
||||
- Headers: [Analysis]
|
||||
- Issues: [List]
|
||||
|
||||
[STRUCTURE]
|
||||
- Hook: [Rating and feedback]
|
||||
- Flow: [Rating and feedback]
|
||||
- Conclusion: [Rating and feedback]
|
||||
- Issues: [List]
|
||||
|
||||
[ENGAGEMENT]
|
||||
- Hook Effectiveness: [Rating]
|
||||
- Value Density: [Rating]
|
||||
- Scannability: [Rating]
|
||||
- Issues: [List]
|
||||
|
||||
[TECHNICAL]
|
||||
- Errors Found: X
|
||||
- Sentence Variety: [Rating]
|
||||
- Word Choice: [Rating]
|
||||
- Issues: [List]
|
||||
|
||||
RECOMMENDATIONS:
|
||||
|
||||
Critical:
|
||||
1. [Action item]
|
||||
|
||||
Important:
|
||||
1. [Action item]
|
||||
|
||||
Optimization:
|
||||
1. [Action item]
|
||||
|
||||
Excellence:
|
||||
1. [Action item]
|
||||
|
||||
Strengths:
|
||||
- [Strength 1]
|
||||
- [Strength 2]
|
||||
|
||||
Next Steps:
|
||||
1. [Priority action]
|
||||
2. [Priority action]
|
||||
```
|
||||
|
||||
## Integration
|
||||
|
||||
This analysis feeds into:
|
||||
- Quality check processes
|
||||
- Optimization workflows
|
||||
- Performance tracking
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,92 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/content-creator/tasks/linkedin-repurpose.xml</id>
|
||||
<name>LinkedIn Repurpose</name>
|
||||
<description>Transform content for LinkedIn professional audience</description>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# LinkedIn Repurpose Task
|
||||
|
||||
Transform article or content into high-engagement LinkedIn post.
|
||||
|
||||
## LinkedIn Optimization Strategy
|
||||
|
||||
### 1. Content Analysis
|
||||
- Extract 1-2 core insights from source
|
||||
- Identify most compelling angle for professional audience
|
||||
- Find data points or examples that resonate
|
||||
|
||||
### 2. Hook Creation (Critical)
|
||||
Use proven LinkedIn hooks:
|
||||
- Counterintuitive professional truth
|
||||
- Transformation story
|
||||
- Industry secret or insight
|
||||
- Mistake confession (vulnerability)
|
||||
- Data revelation
|
||||
|
||||
Hook must grab attention in first 1-2 lines.
|
||||
|
||||
### 3. Body Structure (900-1300 characters)
|
||||
- Short paragraphs (1-2 sentences max)
|
||||
- Generous line breaks for mobile
|
||||
- 3-5 key points maximum
|
||||
- Mix insights, data, examples
|
||||
- Professional storytelling tone
|
||||
|
||||
### 4. Engagement Elements
|
||||
- End with thought-provoking question OR
|
||||
- Call for experiences/opinions OR
|
||||
- Request for shares if valuable
|
||||
- Include 3-5 relevant hashtags
|
||||
|
||||
### 5. Formatting Optimization
|
||||
- Line breaks every 1-2 sentences
|
||||
- Bullet points for lists
|
||||
- Bold key phrases (sparingly)
|
||||
- Emojis only if matches voice
|
||||
|
||||
### 6. Voice Balance
|
||||
- Professional yet personal
|
||||
- Authentic, not corporate
|
||||
- Show expertise without bragging
|
||||
- Be human and vulnerable
|
||||
|
||||
## Output Format
|
||||
|
||||
```
|
||||
[COMPELLING HOOK - 1-2 lines that grab attention]
|
||||
|
||||
[Insight or context paragraph]
|
||||
|
||||
[Line break]
|
||||
|
||||
[Key point 1 - short paragraph]
|
||||
|
||||
[Line break]
|
||||
|
||||
[Key point 2 - short paragraph]
|
||||
|
||||
[Line break]
|
||||
|
||||
[Key point 3 or example]
|
||||
|
||||
[Line break]
|
||||
|
||||
[Conclusion with engagement question]
|
||||
|
||||
[Line break]
|
||||
|
||||
#RelevantHashtag #HashtagTwo #HashtagThree
|
||||
|
||||
---
|
||||
Character count: X/1300
|
||||
Engagement elements: ✅ Hook, ✅ Question, ✅ Hashtags
|
||||
```
|
||||
|
||||
Save to: {drafts_folder}/linkedin-{{topic-slug}}-{{date}}.md
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,139 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/content-creator/tasks/quality-check.xml</id>
|
||||
<name>Quality Check</name>
|
||||
<description>Comprehensive quality check on content before saving or publishing</description>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# Quality Check Task
|
||||
|
||||
You are performing a comprehensive quality check on content.
|
||||
|
||||
## Configuration
|
||||
|
||||
**Readability Target:** Grade {readability_target}
|
||||
**Strict Mode:** {strict_quality_mode}
|
||||
**Minimum Pass Score:** 70
|
||||
|
||||
## Quality Check Process
|
||||
|
||||
### 1. Readability Analysis
|
||||
|
||||
Calculate and assess:
|
||||
- **Flesch Reading Ease Score** (0-100, target: 60-70)
|
||||
- **Grade Level** (target: {readability_target})
|
||||
- **Average Sentence Length** (target: <25 words)
|
||||
- **Paragraph Length** (target: 3-5 sentences)
|
||||
|
||||
**Scoring:** 0-100 based on targets
|
||||
|
||||
### 2. Grammar & Spelling
|
||||
|
||||
Check for:
|
||||
- Spelling errors
|
||||
- Grammar mistakes
|
||||
- Punctuation issues
|
||||
- Word choice problems
|
||||
|
||||
**Scoring:** Deduct 5 points per error, minimum 0
|
||||
|
||||
### 3. Structure Validation
|
||||
|
||||
Verify:
|
||||
- Title present and compelling
|
||||
- Clear introduction
|
||||
- Logical section flow
|
||||
- Proper heading hierarchy (H1 > H2 > H3)
|
||||
- Strong conclusion
|
||||
|
||||
**Scoring:** 0-100 based on completeness
|
||||
|
||||
### 4. Voice Consistency (if voice examples available)
|
||||
|
||||
Analyze:
|
||||
- Tone matches voice profile
|
||||
- Vocabulary level consistent
|
||||
- Sentence structure patterns match
|
||||
- Personality comes through
|
||||
|
||||
**Scoring:** 0-100 based on similarity
|
||||
|
||||
## Platform-Specific Requirements
|
||||
|
||||
### Articles (Blog/Main Content)
|
||||
- Minimum 800 words
|
||||
- 3+ main sections with headers
|
||||
- Clear introduction and conclusion
|
||||
- Supporting examples or data
|
||||
|
||||
### LinkedIn Posts
|
||||
- 900-1300 characters
|
||||
- Engagement hook in opening
|
||||
- Professional yet personal tone
|
||||
- Clear value proposition
|
||||
|
||||
### Newsletter
|
||||
- Compelling subject line (30-50 chars)
|
||||
- Personal greeting
|
||||
- Scannable sections
|
||||
- Personal sign-off
|
||||
|
||||
### Social Media
|
||||
- Platform-appropriate length
|
||||
- Strong hook in first line
|
||||
- Call-to-action or engagement question
|
||||
|
||||
## Scoring & Decision Matrix
|
||||
|
||||
Calculate overall score (0-100):
|
||||
- Readability: 30%
|
||||
- Grammar/Technical: 25%
|
||||
- Structure: 25%
|
||||
- Voice: 20%
|
||||
|
||||
**Decision:**
|
||||
- **80-100 (PASS)** → ✅ Save/publish normally with success confirmation
|
||||
- **60-79 (WARN)** → ⚠️ Save with warnings, show issues and suggestions
|
||||
- **<60 (BLOCK)** → ❌ If strict_mode=true, prevent save; otherwise save with prominent warnings
|
||||
|
||||
## Output Format
|
||||
|
||||
Provide:
|
||||
|
||||
```
|
||||
QUALITY CHECK RESULTS
|
||||
====================
|
||||
|
||||
Overall Score: X/100 [PASS/WARN/BLOCK]
|
||||
|
||||
Breakdown:
|
||||
- Readability: X/100
|
||||
- Grammar & Technical: X/100
|
||||
- Structure: X/100
|
||||
- Voice Consistency: X/100
|
||||
|
||||
Issues Found:
|
||||
[If any]
|
||||
- [Issue 1 with severity]
|
||||
- [Issue 2 with severity]
|
||||
|
||||
Recommendations:
|
||||
[Prioritized by urgency]
|
||||
1. [Critical fix]
|
||||
2. [Important improvement]
|
||||
3. [Optimization suggestion]
|
||||
|
||||
Status: [APPROVED/APPROVED WITH WARNINGS/BLOCKED]
|
||||
```
|
||||
|
||||
## Performance
|
||||
|
||||
- Target execution time: <2 seconds
|
||||
- Cache results for 5 minutes
|
||||
- Can be bypassed with --skip-quality-check flag
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,67 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/content-creator/tasks/seo-optimize.xml</id>
|
||||
<name>SEO Optimization</name>
|
||||
<description>Comprehensive SEO optimization for content discoverability</description>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# SEO Optimization Task
|
||||
|
||||
Optimize content for search engines while maintaining readability and authentic voice.
|
||||
|
||||
## Optimization Process
|
||||
|
||||
### 1. Keyword Analysis
|
||||
- Identify primary keyword (from user or infer from content)
|
||||
- Find related keywords and semantic variations
|
||||
- Calculate current keyword density
|
||||
- Target: 0.5-2.5% for primary keyword
|
||||
|
||||
### 2. Title Optimization
|
||||
- Length: 50-60 characters
|
||||
- Include primary keyword (preferably near start)
|
||||
- Make compelling and click-worthy
|
||||
- Match search intent
|
||||
|
||||
### 3. Meta Description
|
||||
- Length: 150-160 characters
|
||||
- Include primary keyword naturally
|
||||
- Summarize value proposition
|
||||
- Include call-to-action
|
||||
|
||||
### 4. Heading Structure
|
||||
- H1: Article title (only one, with primary keyword)
|
||||
- H2: Main sections (3-5, include keywords naturally)
|
||||
- H3: Subsections as needed
|
||||
- Logical hierarchy maintained
|
||||
|
||||
### 5. Content Optimization
|
||||
- Integrate keywords naturally (never force)
|
||||
- Use semantic variations throughout
|
||||
- First 100 words should include primary keyword
|
||||
- Maintain natural reading flow
|
||||
|
||||
### 6. Internal/External Links
|
||||
- 2-3 relevant external authority links
|
||||
- 1-2 internal links (if applicable)
|
||||
- Descriptive anchor text (not "click here")
|
||||
- Open external links in new tab
|
||||
|
||||
### 7. Image Optimization (if applicable)
|
||||
- Descriptive alt text with keywords
|
||||
- Descriptive file names
|
||||
- Appropriate image sizes
|
||||
|
||||
## Output
|
||||
|
||||
Provide optimized content with:
|
||||
- SEO score improvement (before/after)
|
||||
- Keyword density report
|
||||
- Meta elements (title, description)
|
||||
- Recommended changes summary
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,267 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/content-creator/tasks/style-analyzer.xml</id>
|
||||
<name>Style Analyzer</name>
|
||||
<description>Deep analysis of writing style patterns, characteristics, and unique voice markers</description>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# Style Analyzer Task
|
||||
|
||||
You are a writing style analysis expert performing deep analysis of writing samples to extract detailed style characteristics.
|
||||
|
||||
## Analysis Process
|
||||
|
||||
### 1. Input Processing
|
||||
- Accept writing sample (text or file path)
|
||||
- Validate minimum length (200+ words)
|
||||
- Clean and prepare text for analysis
|
||||
|
||||
### 2. Quantitative Analysis
|
||||
|
||||
**Sentence Metrics:**
|
||||
- Total sentences
|
||||
- Average words per sentence
|
||||
- Shortest/longest sentences
|
||||
- Sentence length distribution
|
||||
- Standard deviation (consistency measure)
|
||||
|
||||
**Word Metrics:**
|
||||
- Total words
|
||||
- Unique words
|
||||
- Type-Token Ratio (vocabulary diversity)
|
||||
- Average word length
|
||||
- Syllables per word average
|
||||
|
||||
**Readability Scores:**
|
||||
- Flesch Reading Ease
|
||||
- Flesch-Kincaid Grade Level
|
||||
- Gunning Fog Index
|
||||
- SMOG Index
|
||||
|
||||
**Structural Metrics:**
|
||||
- Total paragraphs
|
||||
- Average sentences per paragraph
|
||||
- Average words per paragraph
|
||||
- Paragraph length variance
|
||||
|
||||
### 3. Qualitative Analysis
|
||||
|
||||
**Sentence Structure:**
|
||||
Analyze sentence types:
|
||||
- Simple: [% of total]
|
||||
- Compound: [% of total]
|
||||
- Complex: [% of total]
|
||||
- Compound-complex: [% of total]
|
||||
|
||||
Identify patterns:
|
||||
- Common sentence starters
|
||||
- Sentence connectors used
|
||||
- Parallel structure usage
|
||||
- Fragment usage (if any)
|
||||
|
||||
**Vocabulary Analysis:**
|
||||
Extract and categorize:
|
||||
- Most frequent words (excluding stop words)
|
||||
- Power words and strong verbs
|
||||
- Adjectives and adverbs usage
|
||||
- Transitional phrases
|
||||
- Technical terminology
|
||||
- Industry jargon
|
||||
- Unique expressions
|
||||
|
||||
**Tone Indicators:**
|
||||
Identify markers for:
|
||||
- Formality level (vocabulary, contractions, slang)
|
||||
- Expertise level (technical depth, explanations)
|
||||
- Confidence (hedging vs. assertive language)
|
||||
- Empathy (inclusive language, understanding)
|
||||
- Enthusiasm (exclamations, superlatives)
|
||||
|
||||
**Voice Elements:**
|
||||
Analyze usage of:
|
||||
- First person (I, we, my, our)
|
||||
- Second person (you, your)
|
||||
- Third person (he, she, they, it)
|
||||
- Active vs. passive voice ratio
|
||||
- Questions (types and frequency)
|
||||
- Imperatives (commands)
|
||||
|
||||
**Rhetorical Devices:**
|
||||
Identify usage of:
|
||||
- Metaphors and similes
|
||||
- Analogies
|
||||
- Repetition for emphasis
|
||||
- Alliteration
|
||||
- Rhetorical questions
|
||||
- Anecdotes and stories
|
||||
- Data and statistics
|
||||
- Examples and illustrations
|
||||
|
||||
**Formatting Patterns:**
|
||||
Document preferences for:
|
||||
- List usage (bullets, numbers, both)
|
||||
- Emphasis markers (bold, italics, caps)
|
||||
- Parenthetical asides
|
||||
- Dash usage (em dash, en dash)
|
||||
- Colon and semicolon usage
|
||||
- Quotation usage
|
||||
|
||||
### 4. Pattern Recognition
|
||||
|
||||
**Signature Patterns:**
|
||||
Identify unique characteristics:
|
||||
- Repeated phrases or expressions
|
||||
- Characteristic opening/closing patterns
|
||||
- Favorite transitional devices
|
||||
- Unique structural choices
|
||||
- Idiosyncratic word choices
|
||||
|
||||
**Stylistic Fingerprints:**
|
||||
Document what makes this voice unique:
|
||||
- Unusual word combinations
|
||||
- Distinctive rhythm or cadence
|
||||
- Unique perspective or framing
|
||||
- Memorable turns of phrase
|
||||
|
||||
### 5. Contextual Analysis
|
||||
|
||||
**Content Type Indicators:**
|
||||
Determine if sample is:
|
||||
- Informative/educational
|
||||
- Persuasive/argumentative
|
||||
- Narrative/storytelling
|
||||
- Descriptive/analytical
|
||||
- Conversational/personal
|
||||
|
||||
**Audience Level:**
|
||||
Infer intended audience:
|
||||
- General public
|
||||
- Industry professionals
|
||||
- Experts/specialists
|
||||
- Academic
|
||||
- Mixed
|
||||
|
||||
**Purpose Indicators:**
|
||||
Identify primary purpose:
|
||||
- Teach/educate
|
||||
- Persuade/convince
|
||||
- Entertain/engage
|
||||
- Inform/update
|
||||
- Inspire/motivate
|
||||
|
||||
## Output Format
|
||||
|
||||
```
|
||||
STYLE ANALYSIS REPORT
|
||||
====================
|
||||
|
||||
Sample: [Title/Source]
|
||||
Words: [X] | Sentences: [X] | Paragraphs: [X]
|
||||
|
||||
--- QUANTITATIVE METRICS ---
|
||||
|
||||
Sentence Metrics:
|
||||
- Avg Length: [X] words (Range: [min]-[max])
|
||||
- Consistency: [Low/Medium/High] (SD: [X])
|
||||
- Complexity: Simple [X]%, Compound [X]%, Complex [X]%
|
||||
|
||||
Vocabulary Metrics:
|
||||
- Unique Words: [X] ([X]% of total)
|
||||
- Type-Token Ratio: [X]
|
||||
- Avg Word Length: [X] characters
|
||||
- Sophistication: [X]/10
|
||||
|
||||
Readability:
|
||||
- Flesch Reading Ease: [X] ([interpretation])
|
||||
- Grade Level: [X]
|
||||
- Gunning Fog: [X]
|
||||
|
||||
--- QUALITATIVE ANALYSIS ---
|
||||
|
||||
Voice & Perspective:
|
||||
- First Person: [X]%
|
||||
- Second Person: [X]%
|
||||
- Active Voice: [X]%
|
||||
- Formality: [X]/10
|
||||
|
||||
Tone Characteristics:
|
||||
- Authoritative: [Low/Med/High]
|
||||
- Empathetic: [Low/Med/High]
|
||||
- Enthusiastic: [Low/Med/High]
|
||||
- Analytical: [Low/Med/High]
|
||||
|
||||
Vocabulary Profile:
|
||||
- Power Words: [word1, word2, word3...]
|
||||
- Transitional Phrases: [phrase1, phrase2...]
|
||||
- Technical Terms: [term1, term2...]
|
||||
- Signature Expressions: ["phrase1", "phrase2"]
|
||||
|
||||
Rhetorical Devices:
|
||||
- Metaphors/Analogies: [Frequency]
|
||||
- Questions: [Frequency] ([types])
|
||||
- Data/Statistics: [Frequency]
|
||||
- Storytelling: [Rare/Occasional/Frequent]
|
||||
|
||||
--- SIGNATURE PATTERNS ---
|
||||
|
||||
Unique Characteristics:
|
||||
1. [Pattern 1]
|
||||
2. [Pattern 2]
|
||||
3. [Pattern 3]
|
||||
|
||||
Opening Style: [Description]
|
||||
Closing Style: [Description]
|
||||
Paragraph Flow: [Description]
|
||||
|
||||
--- STYLE FINGERPRINT ---
|
||||
|
||||
This voice is characterized by:
|
||||
- [Defining trait 1]
|
||||
- [Defining trait 2]
|
||||
- [Defining trait 3]
|
||||
|
||||
Most distinctive elements:
|
||||
- [Element 1]
|
||||
- [Element 2]
|
||||
|
||||
--- RECOMMENDATIONS ---
|
||||
|
||||
To match this style:
|
||||
1. [Recommendation 1]
|
||||
2. [Recommendation 2]
|
||||
3. [Recommendation 3]
|
||||
|
||||
To avoid:
|
||||
- [Anti-pattern 1]
|
||||
- [Anti-pattern 2]
|
||||
|
||||
--- SIMILARITY MARKERS ---
|
||||
|
||||
To validate AI-generated content matches this style, check for:
|
||||
✓ [Marker 1]
|
||||
✓ [Marker 2]
|
||||
✓ [Marker 3]
|
||||
✓ [Marker 4]
|
||||
✓ [Marker 5]
|
||||
```
|
||||
|
||||
## Integration
|
||||
|
||||
This analysis feeds into:
|
||||
- Voice profile building
|
||||
- Voice matching validation
|
||||
- Style guide creation
|
||||
- Content generation instructions
|
||||
|
||||
## Performance
|
||||
|
||||
- Target completion: <5 seconds per sample
|
||||
- Minimum sample size: 200 words
|
||||
- Recommended sample size: 500+ words
|
||||
- Optimal sample size: 1000+ words
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,82 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/content-creator/tasks/voice-check.xml</id>
|
||||
<name>Voice Consistency Check</name>
|
||||
<description>Verify content matches authentic voice and brand guidelines</description>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# Voice Consistency Check
|
||||
|
||||
Verify content maintains authentic voice across all elements.
|
||||
|
||||
## Voice Analysis
|
||||
|
||||
### 1. Load Voice Profile
|
||||
Reference: {writing_examples}
|
||||
Extract patterns:
|
||||
- Sentence structure (short vs long, simple vs complex)
|
||||
- Vocabulary level
|
||||
- Use of humor, metaphors, analogies
|
||||
- Formality level
|
||||
- Perspective (1st/2nd/3rd person)
|
||||
- Rhetorical devices
|
||||
|
||||
### 2. Content Analysis
|
||||
Analyze current content for:
|
||||
- Sentence patterns
|
||||
- Word choices
|
||||
- Tone and style
|
||||
- Personality expression
|
||||
|
||||
### 3. Similarity Scoring (0-100)
|
||||
Compare content to voice profile:
|
||||
- Structure similarity: 30%
|
||||
- Vocabulary match: 25%
|
||||
- Tone consistency: 25%
|
||||
- Style alignment: 20%
|
||||
|
||||
Target: 65+ for approval
|
||||
|
||||
### 4. Deviation Detection
|
||||
Identify sections that don't match:
|
||||
- Inconsistent tone
|
||||
- Out-of-character phrasing
|
||||
- Vocabulary mismatches
|
||||
- Style breaks
|
||||
|
||||
### 5. Recommendations
|
||||
Suggest improvements:
|
||||
- Specific phrases to revise
|
||||
- Tone adjustments
|
||||
- Style corrections
|
||||
- Examples from voice profile
|
||||
|
||||
## Output
|
||||
|
||||
```
|
||||
VOICE CONSISTENCY CHECK
|
||||
=====================
|
||||
|
||||
Similarity Score: X/100
|
||||
|
||||
Analysis:
|
||||
- Structure Match: X/100
|
||||
- Vocabulary Match: X/100
|
||||
- Tone Consistency: X/100
|
||||
- Style Alignment: X/100
|
||||
|
||||
Deviations Found:
|
||||
[Section/line] - [Issue] - [Suggestion]
|
||||
|
||||
Status: [CONSISTENT/NEEDS ADJUSTMENT/SIGNIFICANT DEVIATION]
|
||||
|
||||
Recommendations:
|
||||
1. [Priority adjustment]
|
||||
2. [Priority adjustment]
|
||||
```
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,116 @@
|
|||
# Article Pipeline Quality Checklist
|
||||
|
||||
## Research Phase
|
||||
|
||||
- [ ] Topic clearly defined with specific focus
|
||||
- [ ] Target audience identified and understood
|
||||
- [ ] 5+ priority sources checked from {research_sources}
|
||||
- [ ] 3-5 current data points found and sourced
|
||||
- [ ] 2-3 unique angles or insights identified
|
||||
- [ ] Research brief created and saved
|
||||
|
||||
## Outline Phase
|
||||
|
||||
- [ ] Compelling hook strategy defined
|
||||
- [ ] 3-5 main sections planned with clear focus
|
||||
- [ ] Logical flow established between sections
|
||||
- [ ] Voice examples reviewed from {writing_examples}
|
||||
- [ ] Outline includes specific research insights
|
||||
|
||||
## Writing Phase
|
||||
|
||||
- [ ] Hook grabs attention in first 2 sentences
|
||||
- [ ] Clear value proposition in opening paragraph
|
||||
- [ ] 3-5 data points integrated with sources
|
||||
- [ ] 2-3 real-world examples included
|
||||
- [ ] Voice matches {writing_examples}
|
||||
- [ ] Reading level appropriate for audience
|
||||
- [ ] Smooth transitions between sections
|
||||
- [ ] Strong, actionable conclusion
|
||||
|
||||
## Technical Quality
|
||||
|
||||
- [ ] No grammar or spelling errors
|
||||
- [ ] Proper punctuation throughout
|
||||
- [ ] Consistent formatting
|
||||
- [ ] Heading hierarchy correct (H1 > H2 > H3)
|
||||
- [ ] Paragraphs well-sized (3-5 sentences)
|
||||
- [ ] Bullet points and lists used for scannability
|
||||
- [ ] Active voice used predominantly
|
||||
|
||||
## SEO Optimization (if enabled)
|
||||
|
||||
- [ ] Title optimized (50-60 chars with keyword)
|
||||
- [ ] Meta description written (150-160 chars)
|
||||
- [ ] Primary keyword density 0.5-2.5%
|
||||
- [ ] Keywords integrated naturally
|
||||
- [ ] Heading structure includes keywords
|
||||
- [ ] 2-3 external authority links included
|
||||
- [ ] Descriptive anchor text used
|
||||
|
||||
## Quality Scores
|
||||
|
||||
- [ ] Readability score: 60-70 (Flesch)
|
||||
- [ ] Structure score: ≥80
|
||||
- [ ] Engagement score: ≥75
|
||||
- [ ] Technical quality score: ≥90
|
||||
- [ ] Voice consistency score: ≥65
|
||||
- [ ] **Overall quality score: ≥70** (REQUIRED)
|
||||
|
||||
## Platform Repurposing
|
||||
|
||||
### LinkedIn Version
|
||||
- [ ] 900-1300 characters
|
||||
- [ ] Professional yet personal tone
|
||||
- [ ] Compelling hook for LinkedIn audience
|
||||
- [ ] 3-5 relevant hashtags
|
||||
- [ ] Engagement question included
|
||||
- [ ] Formatting optimized (short paragraphs, line breaks)
|
||||
|
||||
### Newsletter Version
|
||||
- [ ] Compelling subject line (30-50 chars)
|
||||
- [ ] Personal greeting included
|
||||
- [ ] Scannable sections with headers
|
||||
- [ ] Personal sign-off
|
||||
- [ ] Clear CTA
|
||||
- [ ] More conversational than main article
|
||||
|
||||
### Social Media Version
|
||||
- [ ] Twitter thread: 5-8 tweets
|
||||
- [ ] Strong hook in first tweet
|
||||
- [ ] Each tweet self-contained but builds narrative
|
||||
- [ ] Thread numbers included (1/8, 2/8, etc.)
|
||||
- [ ] Final tweet has CTA or question
|
||||
- [ ] Alternative formats created if needed
|
||||
|
||||
## All Platform Versions
|
||||
|
||||
- [ ] Core message maintained across all versions
|
||||
- [ ] Platform conventions followed
|
||||
- [ ] Authentic voice preserved
|
||||
- [ ] Appropriate length for each platform
|
||||
- [ ] Platform-specific engagement elements included
|
||||
|
||||
## Publishing Preparation
|
||||
|
||||
- [ ] Asset recommendations documented
|
||||
- [ ] Publishing schedule suggested
|
||||
- [ ] Success metrics defined
|
||||
- [ ] All files saved in correct locations
|
||||
- [ ] Workflow summary created
|
||||
|
||||
## Final Validation
|
||||
|
||||
- [ ] All deliverables reviewed by user
|
||||
- [ ] Final revisions completed
|
||||
- [ ] Files organized in {drafts_folder}
|
||||
- [ ] Ready to move forward with publishing
|
||||
|
||||
---
|
||||
|
||||
**Minimum Requirements for Completion:**
|
||||
- ✅ Overall quality score ≥70
|
||||
- ✅ Main article complete and saved
|
||||
- ✅ At least 2 platform versions created
|
||||
- ✅ All quality checks passed
|
||||
- ✅ Workflow summary provided
|
||||
|
|
@ -0,0 +1,385 @@
|
|||
# Article Writing Pipeline
|
||||
|
||||
You are an expert content writer executing a comprehensive article creation workflow that transforms research into publish-ready content across multiple platforms.
|
||||
|
||||
## Workflow Configuration
|
||||
|
||||
**User:** {user_name}
|
||||
**Content Output:** {content_output_folder}
|
||||
**Writing Style:** {writing_style}
|
||||
**SEO Optimization:** {enable_seo}
|
||||
**Target Platforms:** {content_platforms}
|
||||
**Readability Target:** Grade {readability_target}
|
||||
**Date:** {date}
|
||||
|
||||
## Reference Materials
|
||||
|
||||
**Voice Examples:** {writing_examples}
|
||||
**Research Sources:** {research_sources}
|
||||
**Brand Guidelines:** {brand_guidelines}
|
||||
**SEO Keywords:** {seo_keywords}
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Research & Topic Development
|
||||
|
||||
### 1.1 Topic Analysis
|
||||
|
||||
Ask the user for:
|
||||
- Primary topic or research brief
|
||||
- Target audience and their level of expertise
|
||||
- Content goals (educate, persuade, inspire, inform)
|
||||
- Desired article length (suggest 1200-1500 words)
|
||||
- Optional: Target keyword for SEO
|
||||
|
||||
### 1.2 Research Execution
|
||||
|
||||
**Priority Research Sources:** Always check {research_sources} FIRST for curated, priority sources.
|
||||
|
||||
For each topic:
|
||||
1. **Current Trends** - What's happening NOW in this space?
|
||||
2. **Data Points** - Find recent statistics, studies, research
|
||||
3. **Expert Insights** - Locate quotes, opinions, perspectives from recognized authorities
|
||||
4. **Unique Angles** - Identify gaps, counterintuitive insights, fresh perspectives
|
||||
5. **Real-World Examples** - Case studies, success/failure stories, practical applications
|
||||
|
||||
**Research Brief Output:** Create a 300-500 word research brief documenting:
|
||||
- 5-7 key insights with sources
|
||||
- 3-5 relevant data points
|
||||
- 2-3 unique angles or counterintuitive findings
|
||||
- Emerging trends related to topic
|
||||
- Potential controversies or debates
|
||||
|
||||
Save research brief to: `{content_output_folder}/research/research-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Article Outline Creation
|
||||
|
||||
### 2.1 Structure Planning
|
||||
|
||||
Create compelling outline with:
|
||||
|
||||
**Hook/Opening** (100-150 words)
|
||||
- Counterintuitive truth, transformation story, industry secret, mistake confession, OR data revelation
|
||||
- Must grab attention in first 2 sentences
|
||||
- Establish credibility and relevance
|
||||
|
||||
**Body Sections** (3-5 main sections, 900-1200 words total)
|
||||
- Each section: Clear heading, 2-3 subsections
|
||||
- Logical flow with smooth transitions
|
||||
- Mix of: insights, data, examples, stories
|
||||
- Include: bullet points, numbered lists for scannability
|
||||
|
||||
**Conclusion** (100-150 words)
|
||||
- Synthesize key takeaways
|
||||
- Provide clear next action
|
||||
- Forward-looking perspective or thought-provoking question
|
||||
|
||||
### 2.2 Voice Calibration
|
||||
|
||||
**CRITICAL:** Review {writing_examples} to calibrate voice before writing.
|
||||
|
||||
Identify and match:
|
||||
- Sentence structure patterns (short vs. long, simple vs. complex)
|
||||
- Vocabulary level and word choices
|
||||
- Use of humor, metaphors, analogies
|
||||
- Formality level
|
||||
- Perspective (first person, second person, third person)
|
||||
- Rhetorical devices used
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Article Drafting
|
||||
|
||||
### 3.1 Writing Execution
|
||||
|
||||
**Writing Style Reference:** {writing_style}
|
||||
|
||||
Write the complete article following these principles:
|
||||
|
||||
**Content Integration:**
|
||||
- Weave in current trends from research
|
||||
- Include 3-5 specific data points with sources
|
||||
- Add 2-3 real-world examples or case studies
|
||||
- Reference 2-3 expert perspectives
|
||||
- Challenge 1-2 conventional assumptions
|
||||
|
||||
**Voice Consistency:**
|
||||
- Match patterns from {writing_examples}
|
||||
- Maintain authentic voice throughout
|
||||
- Let personality shine through
|
||||
- Don't force voice - let it flow naturally
|
||||
|
||||
**Readability Optimization:**
|
||||
- Target Grade {readability_target} reading level
|
||||
- Average 15-20 words per sentence
|
||||
- Mix short punchy sentences with longer complex ones
|
||||
- Use active voice predominantly
|
||||
- Break up long paragraphs (3-5 sentences max)
|
||||
|
||||
**Structure Enhancement:**
|
||||
- Add subheadings every 200-300 words
|
||||
- Use bullet points for lists
|
||||
- Bold key phrases (sparingly)
|
||||
- Include smooth transitions between sections
|
||||
|
||||
### 3.2 Draft Review
|
||||
|
||||
Self-check against these criteria:
|
||||
- ✅ Hook grabs attention immediately
|
||||
- ✅ Clear value proposition in first 100 words
|
||||
- ✅ Logical flow and smooth transitions
|
||||
- ✅ Research insights integrated naturally
|
||||
- ✅ Voice matches examples
|
||||
- ✅ Actionable takeaways provided
|
||||
- ✅ Strong conclusion that resonates
|
||||
|
||||
**Save Article:** `{default_output_file}`
|
||||
|
||||
---
|
||||
|
||||
## Step 4: SEO Optimization
|
||||
|
||||
{if enable_seo == "yes"}
|
||||
|
||||
### 4.1 SEO Analysis
|
||||
|
||||
Reference: {seo_keywords}
|
||||
|
||||
Optimize for:
|
||||
|
||||
**Title Optimization** (50-60 characters)
|
||||
- Include primary keyword
|
||||
- Make compelling and click-worthy
|
||||
- Front-load important words
|
||||
|
||||
**Meta Description** (150-160 characters)
|
||||
- Summarize value proposition
|
||||
- Include primary keyword naturally
|
||||
- Include call-to-action
|
||||
|
||||
**Heading Structure**
|
||||
- H1: Article title (only one)
|
||||
- H2: Main section headings (3-5)
|
||||
- H3: Subsections as needed
|
||||
- Include keywords naturally in H2s
|
||||
|
||||
**Keyword Integration** (Target: 0.5-2.5% density)
|
||||
- Primary keyword: 3-5 mentions
|
||||
- Related keywords: 5-10 mentions
|
||||
- Semantic variations throughout
|
||||
- NEVER force keywords unnaturally
|
||||
|
||||
**Internal/External Links**
|
||||
- 2-3 relevant external authority links
|
||||
- 1-2 internal links (if applicable)
|
||||
- Descriptive anchor text
|
||||
|
||||
### 4.2 SEO Quality Check
|
||||
|
||||
Run SEO analysis and document:
|
||||
- Keyword density score
|
||||
- Title/meta optimization score
|
||||
- Heading structure score
|
||||
- Link quality score
|
||||
- Overall SEO score (0-100)
|
||||
|
||||
**Save SEO Report:** `{content_output_folder}/research/seo-report-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
{/if}
|
||||
|
||||
---
|
||||
|
||||
## Step 5: Quality Validation
|
||||
|
||||
### 5.1 Comprehensive Quality Check
|
||||
|
||||
**CRITICAL:** Article must score ≥70 to proceed.
|
||||
|
||||
Evaluate across 5 dimensions:
|
||||
|
||||
**Readability** (Target: 60-70 Flesch Score)
|
||||
- Check reading level matches target
|
||||
- Verify sentence complexity
|
||||
- Assess paragraph flow
|
||||
|
||||
**Structure** (Target: 80+)
|
||||
- Strong hook present
|
||||
- Logical section flow
|
||||
- Clear transitions
|
||||
- Impactful conclusion
|
||||
|
||||
**Engagement** (Target: 75+)
|
||||
- Compelling opening
|
||||
- Value density throughout
|
||||
- Emotional resonance
|
||||
- Scannable format
|
||||
|
||||
**Technical Quality** (Target: 90+)
|
||||
- No grammar/spelling errors
|
||||
- Consistent formatting
|
||||
- Proper punctuation
|
||||
- Strong word choices
|
||||
|
||||
**Voice Consistency** (Target: 65+)
|
||||
- Matches {writing_examples}
|
||||
- Authentic throughout
|
||||
- Appropriate for audience
|
||||
- Maintains personality
|
||||
|
||||
### 5.2 Revision Process
|
||||
|
||||
If score < 70:
|
||||
- Document specific issues
|
||||
- Prioritize critical fixes
|
||||
- Revise and re-check
|
||||
- Must pass before proceeding
|
||||
|
||||
**Save Quality Report:** `{content_output_folder}/research/quality-report-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
---
|
||||
|
||||
## Step 6: Multi-Platform Repurposing
|
||||
|
||||
### 6.1 Platform Adaptation
|
||||
|
||||
For each selected platform in {content_platforms}:
|
||||
|
||||
#### LinkedIn Version (if "linkedin" in platforms)
|
||||
|
||||
**Transformation Strategy:**
|
||||
- Extract 1-2 core insights from article
|
||||
- Create professional storytelling hook
|
||||
- Include 900-1300 characters
|
||||
- Add relevant hashtags (3-5)
|
||||
- Include engagement question at end
|
||||
- Maintain professional yet personal tone
|
||||
|
||||
**Formatting:**
|
||||
- Short paragraphs (1-2 sentences)
|
||||
- Use line breaks generously
|
||||
- Include bullet points for key points
|
||||
- Add emojis sparingly (if matches voice)
|
||||
|
||||
**Save:** `{drafts_folder}/linkedin-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
#### Newsletter Version (if "newsletter" in platforms)
|
||||
|
||||
**Transformation Strategy:**
|
||||
- Create compelling subject line (30-50 chars)
|
||||
- Add personal opening greeting
|
||||
- Break into scannable sections with headers
|
||||
- Include "Why this matters" context
|
||||
- Add personal sign-off
|
||||
- More conversational than article
|
||||
|
||||
**Structure:**
|
||||
- Subject line + 2 alternative options
|
||||
- Personal greeting
|
||||
- 2-3 key sections with headers
|
||||
- Conclusion with clear CTA
|
||||
- Personal signature
|
||||
|
||||
**Save:** `{drafts_folder}/newsletter-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
#### Social Media Version (if "twitter" OR "social" in platforms)
|
||||
|
||||
**Transformation Strategy:**
|
||||
- Twitter thread: 5-8 tweets, hook-driven
|
||||
- Each tweet: self-contained but builds narrative
|
||||
- Include thread numbers (1/8, 2/8, etc.)
|
||||
- Final tweet: CTA or thought-provoking question
|
||||
|
||||
**Alternative Social Formats:**
|
||||
- Instagram caption version
|
||||
- Short-form video script (TikTok/Reels)
|
||||
- Podcast talking points
|
||||
|
||||
**Save:** `{drafts_folder}/social-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
### 6.2 Repurposing Quality Check
|
||||
|
||||
For each platform version:
|
||||
- ✅ Maintains core message and insights
|
||||
- ✅ Optimized for platform conventions
|
||||
- ✅ Maintains authentic voice
|
||||
- ✅ Appropriate length for platform
|
||||
- ✅ Includes platform-specific engagement elements
|
||||
|
||||
---
|
||||
|
||||
## Step 7: Publishing Preparation
|
||||
|
||||
### 7.1 Asset Suggestions
|
||||
|
||||
Recommend supporting assets:
|
||||
- **Featured Image:** Style/subject suggestions
|
||||
- **In-Article Images:** 2-3 visual break points
|
||||
- **Social Graphics:** Quote cards, stat cards
|
||||
- **Video/Audio:** Podcast or video segment ideas
|
||||
|
||||
### 7.2 Publishing Schedule
|
||||
|
||||
Suggest optimal publishing timeline:
|
||||
- **Blog/Main Article:** Best day/time based on audience
|
||||
- **LinkedIn:** Within 24-48 hours of blog
|
||||
- **Newsletter:** Next scheduled send date
|
||||
- **Social Media:** Staggered over 5-7 days
|
||||
|
||||
### 7.3 Analytics Setup
|
||||
|
||||
Define success metrics:
|
||||
- **Traffic:** Target page views, time on page
|
||||
- **Engagement:** Comments, shares, saves
|
||||
- **SEO:** Target keyword rankings
|
||||
- **Conversions:** Email signups, link clicks
|
||||
|
||||
---
|
||||
|
||||
## Step 8: Workflow Summary & Next Steps
|
||||
|
||||
### 8.1 Deliverables Summary
|
||||
|
||||
Provide complete summary:
|
||||
|
||||
**Created Files:**
|
||||
- Main article: [link]
|
||||
- LinkedIn version: [link]
|
||||
- Newsletter version: [link]
|
||||
- Social version: [link]
|
||||
- Research brief: [link]
|
||||
- Quality report: [link]
|
||||
- SEO report: [link] (if applicable)
|
||||
|
||||
**Quality Scores:**
|
||||
- Overall quality: X/100
|
||||
- Readability: X/100
|
||||
- SEO: X/100 (if applicable)
|
||||
- Voice consistency: X/100
|
||||
|
||||
### 8.2 Recommended Next Steps
|
||||
|
||||
1. **Review & Refine:** Read through all versions, make final tweaks
|
||||
2. **Create Assets:** Commission or create recommended images/graphics
|
||||
3. **Schedule Publishing:** Use suggested timeline or adjust
|
||||
4. **Setup Analytics:** Ensure tracking in place
|
||||
5. **Prepare Engagement:** Plan responses to comments/questions
|
||||
|
||||
### 8.3 Archive & Learn
|
||||
|
||||
- Move final versions to {published_folder} when published
|
||||
- Archive research materials for future reference
|
||||
- Update {writing_examples} if this represents voice evolution
|
||||
- Document what worked well for future content
|
||||
|
||||
---
|
||||
|
||||
## Completion
|
||||
|
||||
✅ Article pipeline complete!
|
||||
✅ All platform versions created
|
||||
✅ Quality validated
|
||||
✅ Ready for review and publishing
|
||||
|
||||
**User, your content is ready!** Review all versions in {drafts_folder} and let me know if you need any revisions or additional platform versions.
|
||||
|
|
@ -0,0 +1,94 @@
|
|||
# [Article Title]
|
||||
|
||||
**Author:** {user_name}
|
||||
**Date:** {date}
|
||||
**Target Audience:** [Define audience]
|
||||
**Content Goal:** [Educate/Persuade/Inspire/Inform]
|
||||
**Reading Time:** ~X minutes
|
||||
|
||||
---
|
||||
|
||||
## Research Brief
|
||||
|
||||
**Topic:** [Topic name]
|
||||
**Primary Keyword:** [Keyword if applicable]
|
||||
|
||||
### Key Insights
|
||||
1. [Insight 1 with source]
|
||||
2. [Insight 2 with source]
|
||||
3. [Insight 3 with source]
|
||||
|
||||
### Data Points
|
||||
- [Statistic 1 with source]
|
||||
- [Statistic 2 with source]
|
||||
- [Statistic 3 with source]
|
||||
|
||||
### Unique Angles
|
||||
- [Angle 1]
|
||||
- [Angle 2]
|
||||
|
||||
---
|
||||
|
||||
## Article Content
|
||||
|
||||
### [Compelling Hook / Opening]
|
||||
|
||||
[Introduction paragraph - grab attention immediately]
|
||||
|
||||
[Context and relevance]
|
||||
|
||||
### [Section 1 Heading]
|
||||
|
||||
[Content for section 1]
|
||||
|
||||
#### [Subsection 1.1]
|
||||
|
||||
[Subsection content]
|
||||
|
||||
### [Section 2 Heading]
|
||||
|
||||
[Content for section 2]
|
||||
|
||||
### [Section 3 Heading]
|
||||
|
||||
[Content for section 3]
|
||||
|
||||
### [Conclusion Heading]
|
||||
|
||||
[Wrap up key points]
|
||||
|
||||
[Call to action or next steps]
|
||||
|
||||
---
|
||||
|
||||
## Metadata
|
||||
|
||||
**Word Count:** [Count]
|
||||
**Readability Score:** [Score]
|
||||
**SEO Score:** [Score if applicable]
|
||||
**Quality Score:** [Overall score]
|
||||
|
||||
**Tags:** [tag1, tag2, tag3]
|
||||
**Categories:** [category1, category2]
|
||||
|
||||
---
|
||||
|
||||
## Platform Versions
|
||||
|
||||
- **Blog/Main:** {default_output_file}
|
||||
- **LinkedIn:** {drafts_folder}/linkedin-{{topic-slug}}-{{date}}.md
|
||||
- **Newsletter:** {drafts_folder}/newsletter-{{topic-slug}}-{{date}}.md
|
||||
- **Social:** {drafts_folder}/social-{{topic-slug}}-{{date}}.md
|
||||
|
||||
---
|
||||
|
||||
## Publishing Checklist
|
||||
|
||||
- [ ] Main article reviewed and finalized
|
||||
- [ ] All platform versions created
|
||||
- [ ] Quality checks passed
|
||||
- [ ] SEO optimization complete (if enabled)
|
||||
- [ ] Images/assets created or sourced
|
||||
- [ ] Publishing scheduled
|
||||
- [ ] Analytics tracking configured
|
||||
- [ ] Promotional posts planned
|
||||
|
|
@ -0,0 +1,44 @@
|
|||
name: "article-pipeline"
|
||||
description: "Complete article writing pipeline from research to multi-platform publication with SEO optimization and automated repurposing. Transforms a research topic into published-ready content across blog, LinkedIn, newsletter, and social media in 10-15 minutes."
|
||||
author: "Content Creator Module"
|
||||
|
||||
# Configuration variables
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_output_folder: "{config_source}:content_output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
writing_style: "{config_source}:default_writing_style"
|
||||
enable_seo: "{config_source}:enable_seo_optimization"
|
||||
content_platforms: "{config_source}:content_platforms"
|
||||
readability_target: "{config_source}:readability_target_grade"
|
||||
date: system-generated
|
||||
|
||||
# Workflow paths
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/article-pipeline"
|
||||
template: "{installed_path}/template.md"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
checklist: "{installed_path}/checklist.md"
|
||||
|
||||
# Data files
|
||||
writing_examples: "{project-root}/{bmad_folder}/content-creator/data/writing-examples.md"
|
||||
research_sources: "{project-root}/{bmad_folder}/content-creator/data/research-sources.md"
|
||||
seo_keywords: "{project-root}/{bmad_folder}/content-creator/data/seo-keywords.md"
|
||||
brand_guidelines: "{project-root}/{bmad_folder}/content-creator/data/brand-guidelines.md"
|
||||
|
||||
# Output configuration
|
||||
drafts_folder: "{content_output_folder}/drafts"
|
||||
published_folder: "{content_output_folder}/published"
|
||||
default_output_file: "{drafts_folder}/article-{{topic-slug}}-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
||||
web_bundle:
|
||||
name: "article-pipeline"
|
||||
description: "Complete article writing pipeline with research, writing, SEO optimization, and multi-platform repurposing"
|
||||
author: "Content Creator"
|
||||
web_bundle_files:
|
||||
- "{bmad_folder}/content-creator/workflows/article-pipeline/instructions.md"
|
||||
- "{bmad_folder}/content-creator/workflows/article-pipeline/template.md"
|
||||
- "{bmad_folder}/content-creator/workflows/article-pipeline/checklist.md"
|
||||
- "{bmad_folder}/content-creator/data/writing-examples.md"
|
||||
- "{bmad_folder}/content-creator/data/research-sources.md"
|
||||
|
|
@ -0,0 +1,339 @@
|
|||
# Build Voice Profile Workflow
|
||||
|
||||
You are a voice analysis expert building a comprehensive voice profile from writing samples.
|
||||
|
||||
**User:** {user_name}
|
||||
**Writing Examples:** {writing_examples}
|
||||
**Output:** {default_output_file}
|
||||
**Date:** {date}
|
||||
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
This workflow analyzes writing samples to create a detailed voice profile that can be used to generate content that authentically matches the writer's unique style.
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Gather Writing Samples
|
||||
|
||||
### 1.1 Load Existing Samples
|
||||
- Read {writing_examples}
|
||||
- Identify available writing samples
|
||||
- Count total words across all samples
|
||||
|
||||
### 1.2 Request Additional Samples (if needed)
|
||||
If fewer than 3 samples or less than 1000 total words:
|
||||
- Ask user to provide additional writing samples
|
||||
- Request variety: blog posts, social media, newsletters, etc.
|
||||
- Aim for 3-5 samples, 1500-3000+ words total
|
||||
|
||||
### 1.3 Validate Sample Quality
|
||||
For each sample, verify:
|
||||
- Sufficient length (200+ words minimum)
|
||||
- Representative of authentic voice
|
||||
- Recent content (written in last 6-12 months preferred)
|
||||
- Variety of contexts/topics
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Voice Analysis
|
||||
|
||||
### 2.1 Sentence Structure Analysis
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Sentence Length Patterns:**
|
||||
- Calculate average words per sentence
|
||||
- Identify range (shortest to longest)
|
||||
- Determine variance (consistent vs. varied)
|
||||
- Note distribution pattern
|
||||
|
||||
**Sentence Complexity:**
|
||||
- Simple sentences ratio (%)
|
||||
- Compound sentences ratio (%)
|
||||
- Complex sentences ratio (%)
|
||||
- Sentence starters (variety and patterns)
|
||||
|
||||
**Sentence Rhythm:**
|
||||
- Pacing (fast/moderate/slow)
|
||||
- Flow patterns (choppy, smooth, varied)
|
||||
- Cadence and rhythm
|
||||
|
||||
### 2.2 Vocabulary Analysis
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Word Choice Patterns:**
|
||||
- Vocabulary sophistication level (1-10)
|
||||
- Common power words used
|
||||
- Favorite descriptive words
|
||||
- Technical jargon usage (frequency and context)
|
||||
|
||||
**Word Categories:**
|
||||
- Action verbs used frequently
|
||||
- Adjectives and adverbs (frequency and type)
|
||||
- Transitional phrases preferred
|
||||
- Filler words or verbal tics
|
||||
|
||||
**Lexical Diversity:**
|
||||
- Type-Token Ratio (vocabulary variety)
|
||||
- Word repetition patterns
|
||||
- Synonym usage patterns
|
||||
|
||||
### 2.3 Tone & Voice Analysis
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Formality Level:** (1-10 scale)
|
||||
- Very casual (1-3)
|
||||
- Conversational (4-6)
|
||||
- Professional (7-8)
|
||||
- Formal (9-10)
|
||||
|
||||
**Personality Traits:**
|
||||
- Authoritative vs. Collaborative
|
||||
- Serious vs. Playful
|
||||
- Direct vs. Nuanced
|
||||
- Confident vs. Humble
|
||||
- Analytical vs. Emotional
|
||||
|
||||
**Emotional Characteristics:**
|
||||
- Enthusiasm level (subdued/moderate/high)
|
||||
- Empathy expression (rare/occasional/frequent)
|
||||
- Humor style (none/dry/witty/playful/sarcastic)
|
||||
- Vulnerability (reserved/selective/open)
|
||||
|
||||
**Perspective & Voice:**
|
||||
- First person usage (I/we) frequency
|
||||
- Second person usage (you) frequency
|
||||
- Third person usage (he/she/they) frequency
|
||||
- Active vs. passive voice ratio
|
||||
|
||||
### 2.4 Structural Patterns
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Paragraph Structure:**
|
||||
- Average sentences per paragraph
|
||||
- Paragraph length pattern
|
||||
- Opening sentence patterns
|
||||
- Transition strategies
|
||||
|
||||
**Content Organization:**
|
||||
- Introduction style (hook type, length)
|
||||
- Body organization (linear, thematic, narrative)
|
||||
- Conclusion approach (summary, call-to-action, question)
|
||||
|
||||
**Formatting Preferences:**
|
||||
- Subheading frequency and style
|
||||
- List usage (bullets vs. numbers)
|
||||
- Bold/italic usage patterns
|
||||
- Visual breaks and spacing
|
||||
|
||||
### 2.5 Rhetorical Devices
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Storytelling Elements:**
|
||||
- Anecdote usage (frequency and placement)
|
||||
- Personal experience sharing
|
||||
- Case study integration
|
||||
- Example types (hypothetical, real-world, data)
|
||||
|
||||
**Persuasion Techniques:**
|
||||
- Data/statistics usage
|
||||
- Expert citation patterns
|
||||
- Logical argumentation style
|
||||
- Emotional appeals
|
||||
|
||||
**Engagement Devices:**
|
||||
- Questions (rhetorical, direct, thought-provoking)
|
||||
- Metaphors and analogies (frequency and type)
|
||||
- Imagery and sensory language
|
||||
- Repetition for emphasis
|
||||
|
||||
**Unique Patterns:**
|
||||
- Signature phrases or expressions
|
||||
- Consistent opening/closing patterns
|
||||
- Unique formatting or structural choices
|
||||
- Special stylistic flourishes
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Voice Profile Synthesis
|
||||
|
||||
### 3.1 Create Voice Summary
|
||||
|
||||
Synthesize analysis into clear profile:
|
||||
|
||||
**Voice Identity Statement:**
|
||||
- 2-3 sentence description capturing essence
|
||||
- Example: "Your voice is conversational yet authoritative, blending data-driven insights with personal storytelling. You favor short, punchy sentences mixed with longer explanatory ones, creating a rhythmic reading experience that keeps readers engaged."
|
||||
|
||||
**Voice Characteristics Summary:**
|
||||
- Top 5 defining characteristics
|
||||
- 3-5 signature patterns
|
||||
- Unique voice markers
|
||||
|
||||
### 3.2 Create Style Guidelines
|
||||
|
||||
Generate actionable style guide:
|
||||
|
||||
**Sentence Construction:**
|
||||
- Preferred sentence lengths
|
||||
- Typical sentence patterns
|
||||
- Sentence variety recommendations
|
||||
|
||||
**Word Choice Rules:**
|
||||
- Vocabulary level to maintain
|
||||
- Words/phrases to use frequently
|
||||
- Words/phrases to avoid
|
||||
- Technical language guidelines
|
||||
|
||||
**Tone Guidelines:**
|
||||
- Formality level by context
|
||||
- When to be more/less formal
|
||||
- Personality expression rules
|
||||
- Emotional range guidelines
|
||||
|
||||
**Structural Templates:**
|
||||
- Introduction templates
|
||||
- Paragraph organization patterns
|
||||
- Transition templates
|
||||
- Conclusion templates
|
||||
|
||||
### 3.3 Create Voice Examples
|
||||
|
||||
Generate examples demonstrating voice:
|
||||
|
||||
**Before/After Examples:**
|
||||
- Generic text → Your voice
|
||||
- Show 3-5 transformations
|
||||
- Highlight specific voice elements applied
|
||||
|
||||
**Voice Variations by Context:**
|
||||
- Blog post voice
|
||||
- Social media voice
|
||||
- Newsletter voice
|
||||
- Professional email voice
|
||||
|
||||
**Platform-Specific Adaptations:**
|
||||
- How voice adapts for LinkedIn
|
||||
- How voice adapts for Twitter
|
||||
- How voice adapts for newsletter
|
||||
- Core elements that remain constant
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Voice Profile Validation
|
||||
|
||||
### 4.1 Similarity Testing
|
||||
|
||||
Test voice profile accuracy:
|
||||
- Generate sample paragraph using profile
|
||||
- Compare to original writing samples
|
||||
- Calculate similarity score (0-100)
|
||||
- Target: 75+ for strong match
|
||||
|
||||
### 4.2 User Validation
|
||||
|
||||
Present to user for validation:
|
||||
- Show voice summary
|
||||
- Display sample generated content
|
||||
- Request feedback:
|
||||
- Does this sound like you?
|
||||
- What feels off?
|
||||
- What's spot-on?
|
||||
- Any missing elements?
|
||||
|
||||
### 4.3 Refinement
|
||||
|
||||
Based on feedback:
|
||||
- Adjust voice characteristics
|
||||
- Update style guidelines
|
||||
- Regenerate examples
|
||||
- Re-test until approved
|
||||
|
||||
---
|
||||
|
||||
## Step 5: Profile Documentation
|
||||
|
||||
### 5.1 Create Voice Profile Document
|
||||
|
||||
Generate comprehensive profile using {template}:
|
||||
- Voice identity and summary
|
||||
- Detailed characteristics analysis
|
||||
- Style guidelines
|
||||
- Examples and templates
|
||||
- Usage instructions
|
||||
|
||||
### 5.2 Create Quick Reference Card
|
||||
|
||||
Generate 1-page quick reference:
|
||||
- Voice identity statement
|
||||
- Top 5 characteristics
|
||||
- Key do's and don'ts
|
||||
- Sentence/paragraph templates
|
||||
- Example transformations
|
||||
|
||||
### 5.3 Save Profile
|
||||
|
||||
Save complete profile:
|
||||
- Full profile: {default_output_file}
|
||||
- Quick reference: {voice_profiles_folder}/quick-ref-{{profile-name}}.md
|
||||
- Raw analysis data: {voice_profiles_folder}/analysis-data-{{profile-name}}.json
|
||||
|
||||
---
|
||||
|
||||
## Step 6: Integration & Next Steps
|
||||
|
||||
### 6.1 Profile Activation
|
||||
|
||||
Provide instructions:
|
||||
- How to activate this profile for content creation
|
||||
- How to switch between multiple profiles
|
||||
- How to update profile with new samples
|
||||
|
||||
### 6.2 Testing Recommendations
|
||||
|
||||
Suggest testing approach:
|
||||
- Try `*write` with new profile
|
||||
- Compare generated content to original voice
|
||||
- Iterate on profile as needed
|
||||
|
||||
### 6.3 Maintenance Guidelines
|
||||
|
||||
Provide maintenance plan:
|
||||
- Review profile quarterly
|
||||
- Update with new writing samples
|
||||
- Track voice evolution
|
||||
- Archive old profiles
|
||||
|
||||
---
|
||||
|
||||
## Output
|
||||
|
||||
Comprehensive voice profile including:
|
||||
- **Voice Identity:** Clear statement of unique voice
|
||||
- **Detailed Analysis:** All characteristics documented
|
||||
- **Style Guidelines:** Actionable writing rules
|
||||
- **Examples:** Before/after and context variations
|
||||
- **Quick Reference:** 1-page summary
|
||||
- **Integration Instructions:** How to use profile
|
||||
|
||||
Save complete profile to: {default_output_file}
|
||||
|
||||
---
|
||||
|
||||
## Success Criteria
|
||||
|
||||
✅ 3+ writing samples analyzed (1500+ words total)
|
||||
✅ Complete analysis across all 5 dimensions
|
||||
✅ Voice similarity score 75+
|
||||
✅ User validation approved
|
||||
✅ Profile document created
|
||||
✅ Quick reference generated
|
||||
✅ Ready for content generation
|
||||
|
||||
**Your voice profile is ready to ensure all AI-generated content sounds authentically like you!**
|
||||
|
|
@ -0,0 +1,334 @@
|
|||
# Voice Profile: [Profile Name]
|
||||
|
||||
**Created For:** {user_name}
|
||||
**Date Created:** {date}
|
||||
**Samples Analyzed:** [Number] samples, [Total] words
|
||||
**Profile Version:** 1.0
|
||||
|
||||
---
|
||||
|
||||
## Voice Identity
|
||||
|
||||
**Voice Summary:**
|
||||
[2-3 sentence description capturing the essence of the writing voice]
|
||||
|
||||
**Voice Type:** [e.g., "Conversational Expert", "Data-Driven Storyteller", "Professional Educator"]
|
||||
|
||||
**Best Described As:**
|
||||
- [Characteristic 1]
|
||||
- [Characteristic 2]
|
||||
- [Characteristic 3]
|
||||
|
||||
---
|
||||
|
||||
## Voice Characteristics
|
||||
|
||||
### Sentence Structure
|
||||
- **Average Length:** [X] words per sentence
|
||||
- **Length Range:** [Min]-[Max] words
|
||||
- **Variance:** [Consistent/Varied/Highly Varied]
|
||||
- **Complexity Mix:**
|
||||
- Simple: [X]%
|
||||
- Compound: [X]%
|
||||
- Complex: [X]%
|
||||
- **Rhythm:** [Choppy/Flowing/Varied/Dynamic]
|
||||
|
||||
### Vocabulary Profile
|
||||
- **Sophistication Level:** [X]/10
|
||||
- **Lexical Diversity:** [Low/Medium/High]
|
||||
- **Technical Jargon:** [Rare/Occasional/Frequent]
|
||||
- **Power Words Used:**
|
||||
- [Word 1], [Word 2], [Word 3]
|
||||
- **Signature Phrases:**
|
||||
- "[Phrase 1]"
|
||||
- "[Phrase 2]"
|
||||
|
||||
### Tone & Personality
|
||||
- **Formality Level:** [X]/10 ([Very Casual/Conversational/Professional/Formal])
|
||||
- **Personality Traits:**
|
||||
- Authoritative: [Low/Medium/High]
|
||||
- Playful: [Low/Medium/High]
|
||||
- Empathetic: [Low/Medium/High]
|
||||
- Analytical: [Low/Medium/High]
|
||||
- Confident: [Low/Medium/High]
|
||||
- **Emotional Expression:**
|
||||
- Enthusiasm: [Subdued/Moderate/High]
|
||||
- Humor: [None/Dry/Witty/Playful/Sarcastic]
|
||||
- Vulnerability: [Reserved/Selective/Open]
|
||||
|
||||
### Perspective & Voice
|
||||
- **First Person (I/we):** [X]%
|
||||
- **Second Person (you):** [X]%
|
||||
- **Third Person:** [X]%
|
||||
- **Active Voice:** [X]%
|
||||
- **Passive Voice:** [X]%
|
||||
|
||||
### Structural Patterns
|
||||
- **Paragraph Length:** [X] sentences average
|
||||
- **Opening Style:** [Description]
|
||||
- **Body Organization:** [Linear/Thematic/Narrative/Mix]
|
||||
- **Conclusion Style:** [Summary/CTA/Question/Reflection]
|
||||
- **Subheading Frequency:** Every [X] words
|
||||
- **List Preference:** [Bullets/Numbers/Both]
|
||||
|
||||
### Rhetorical Devices
|
||||
- **Storytelling:** [Rare/Occasional/Frequent]
|
||||
- **Personal Anecdotes:** [Never/Rare/Sometimes/Often]
|
||||
- **Data/Statistics:** [Rare/Occasional/Frequent]
|
||||
- **Metaphors/Analogies:** [Rare/Occasional/Frequent]
|
||||
- **Questions:** [Rare/Occasional/Frequent]
|
||||
- **Repetition for Emphasis:** [Rare/Occasional/Frequent]
|
||||
|
||||
---
|
||||
|
||||
## Style Guidelines
|
||||
|
||||
### DO: Core Voice Elements
|
||||
|
||||
**Sentence Construction:**
|
||||
1. [Guideline 1]
|
||||
2. [Guideline 2]
|
||||
3. [Guideline 3]
|
||||
|
||||
**Word Choice:**
|
||||
1. [Guideline 1]
|
||||
2. [Guideline 2]
|
||||
3. [Guideline 3]
|
||||
|
||||
**Tone Management:**
|
||||
1. [Guideline 1]
|
||||
2. [Guideline 2]
|
||||
3. [Guideline 3]
|
||||
|
||||
**Structure & Flow:**
|
||||
1. [Guideline 1]
|
||||
2. [Guideline 2]
|
||||
3. [Guideline 3]
|
||||
|
||||
### DON'T: Voice Violations
|
||||
|
||||
**Avoid:**
|
||||
- [Anti-pattern 1]
|
||||
- [Anti-pattern 2]
|
||||
- [Anti-pattern 3]
|
||||
|
||||
**Words/Phrases to Avoid:**
|
||||
- [Word/phrase 1] - Use [alternative] instead
|
||||
- [Word/phrase 2] - Use [alternative] instead
|
||||
|
||||
---
|
||||
|
||||
## Voice Examples
|
||||
|
||||
### Example 1: Blog Post Opening
|
||||
|
||||
**Generic Version:**
|
||||
[Generic text example]
|
||||
|
||||
**Your Voice:**
|
||||
[Same content in authentic voice]
|
||||
|
||||
**Voice Elements Applied:**
|
||||
- [Element 1]
|
||||
- [Element 2]
|
||||
- [Element 3]
|
||||
|
||||
---
|
||||
|
||||
### Example 2: Key Point Explanation
|
||||
|
||||
**Generic Version:**
|
||||
[Generic text example]
|
||||
|
||||
**Your Voice:**
|
||||
[Same content in authentic voice]
|
||||
|
||||
**Voice Elements Applied:**
|
||||
- [Element 1]
|
||||
- [Element 2]
|
||||
|
||||
---
|
||||
|
||||
### Example 3: Conclusion
|
||||
|
||||
**Generic Version:**
|
||||
[Generic text example]
|
||||
|
||||
**Your Voice:**
|
||||
[Same content in authentic voice]
|
||||
|
||||
**Voice Elements Applied:**
|
||||
- [Element 1]
|
||||
- [Element 2]
|
||||
|
||||
---
|
||||
|
||||
## Platform Adaptations
|
||||
|
||||
### Blog/Website
|
||||
**Voice Adjustments:**
|
||||
- [Adjustment 1]
|
||||
- [Adjustment 2]
|
||||
**Example Opening:** "[Example first paragraph]"
|
||||
|
||||
### LinkedIn
|
||||
**Voice Adjustments:**
|
||||
- [Adjustment 1]
|
||||
- [Adjustment 2]
|
||||
**Example Opening:** "[Example LinkedIn hook]"
|
||||
|
||||
### Newsletter
|
||||
**Voice Adjustments:**
|
||||
- [Adjustment 1]
|
||||
- [Adjustment 2]
|
||||
**Example Opening:** "[Example newsletter greeting]"
|
||||
|
||||
### Twitter/Social
|
||||
**Voice Adjustments:**
|
||||
- [Adjustment 1]
|
||||
- [Adjustment 2]
|
||||
**Example Post:** "[Example tweet]"
|
||||
|
||||
---
|
||||
|
||||
## Content Templates
|
||||
|
||||
### Introduction Template
|
||||
```
|
||||
[Hook pattern]
|
||||
|
||||
[Context/relevance pattern]
|
||||
|
||||
[Value proposition pattern]
|
||||
```
|
||||
|
||||
### Body Paragraph Template
|
||||
```
|
||||
[Topic sentence pattern]
|
||||
|
||||
[Supporting detail pattern]
|
||||
|
||||
[Example/data pattern]
|
||||
|
||||
[Transition pattern]
|
||||
```
|
||||
|
||||
### Conclusion Template
|
||||
```
|
||||
[Summary pattern]
|
||||
|
||||
[Key takeaway pattern]
|
||||
|
||||
[Call-to-action/closing pattern]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Voice Validation
|
||||
|
||||
**Similarity Score:** [X]/100
|
||||
|
||||
**Validation Results:**
|
||||
- ✅ Sentence structure matches
|
||||
- ✅ Vocabulary level appropriate
|
||||
- ✅ Tone consistent
|
||||
- ✅ Personality comes through
|
||||
- ✅ User approved
|
||||
|
||||
**Sample Generated Content:**
|
||||
[Paragraph generated using this profile]
|
||||
|
||||
**User Feedback:**
|
||||
- What works: [Feedback]
|
||||
- What to adjust: [Feedback]
|
||||
- Overall rating: [X]/10
|
||||
|
||||
---
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
### Activating This Profile
|
||||
|
||||
When requesting content creation:
|
||||
```
|
||||
Use my [profile-name] voice profile for this content.
|
||||
Profile: {default_output_file}
|
||||
```
|
||||
|
||||
### Profile Switching
|
||||
|
||||
To switch between profiles:
|
||||
```
|
||||
Switch to [profile-name] voice profile
|
||||
```
|
||||
|
||||
### Profile Updates
|
||||
|
||||
To update profile with new samples:
|
||||
```
|
||||
*train-voice
|
||||
Select profile: [profile-name]
|
||||
Add new samples: [paths or paste]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Maintenance
|
||||
|
||||
**Next Review Date:** [3 months from creation]
|
||||
|
||||
**Update Triggers:**
|
||||
- Significant voice evolution
|
||||
- New content types added
|
||||
- Platform expansion
|
||||
- User dissatisfaction with output
|
||||
|
||||
**Update Process:**
|
||||
1. Add new writing samples to {writing_examples}
|
||||
2. Run `*build-voice-profile` again
|
||||
3. Compare old vs new profile
|
||||
4. Merge or replace as appropriate
|
||||
|
||||
---
|
||||
|
||||
## Analysis Data
|
||||
|
||||
**Samples Analyzed:**
|
||||
1. [Sample 1 title/source] - [word count] words
|
||||
2. [Sample 2 title/source] - [word count] words
|
||||
3. [Sample 3 title/source] - [word count] words
|
||||
|
||||
**Total Analysis:**
|
||||
- Total words: [X]
|
||||
- Total sentences: [X]
|
||||
- Total paragraphs: [X]
|
||||
- Unique words: [X]
|
||||
- Type-Token Ratio: [X]
|
||||
|
||||
---
|
||||
|
||||
## Quick Reference
|
||||
|
||||
**Top 5 Voice Characteristics:**
|
||||
1. [Characteristic 1]
|
||||
2. [Characteristic 2]
|
||||
3. [Characteristic 3]
|
||||
4. [Characteristic 4]
|
||||
5. [Characteristic 5]
|
||||
|
||||
**Voice Identity in One Sentence:**
|
||||
[Single sentence capturing entire voice]
|
||||
|
||||
**Key Do's:**
|
||||
- [Do 1]
|
||||
- [Do 2]
|
||||
- [Do 3]
|
||||
|
||||
**Key Don'ts:**
|
||||
- [Don't 1]
|
||||
- [Don't 2]
|
||||
- [Don't 3]
|
||||
|
||||
---
|
||||
|
||||
**This voice profile ensures all AI-generated content authentically sounds like you across every platform and context.**
|
||||
|
|
@ -0,0 +1,19 @@
|
|||
name: "build-voice-profile"
|
||||
description: "Build a comprehensive voice profile by analyzing your writing samples and creating a detailed style guide"
|
||||
author: "Content Creator Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_output_folder: "{config_source}:content_output_folder"
|
||||
content_data_path: "{config_source}:content_data_path"
|
||||
user_name: "{config_source}:user_name"
|
||||
date: system-generated
|
||||
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/build-voice-profile"
|
||||
template: "{installed_path}/template.md"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
|
||||
writing_examples: "{content_data_path}/writing-examples.md"
|
||||
voice_profiles_folder: "{content_data_path}/voice-profiles"
|
||||
default_output_file: "{voice_profiles_folder}/voice-profile-{{profile-name}}-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,329 @@
|
|||
# Create Style Guide Workflow
|
||||
|
||||
You are a style guide expert creating comprehensive writing guidelines.
|
||||
|
||||
**User:** {user_name}
|
||||
**Voice Profiles:** {voice_profiles_folder}
|
||||
**Brand Guidelines:** {brand_guidelines}
|
||||
**Output:** {default_output_file}
|
||||
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
Create a comprehensive style guide that combines:
|
||||
- Voice profile characteristics
|
||||
- Brand guidelines
|
||||
- Platform-specific rules
|
||||
- Grammar and usage preferences
|
||||
- Formatting standards
|
||||
|
||||
This becomes the definitive reference for all content creation.
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Gather Foundation Materials
|
||||
|
||||
### 1.1 Load Voice Profile
|
||||
- Read existing voice profile
|
||||
- Extract core characteristics
|
||||
- Identify voice patterns
|
||||
- Note unique elements
|
||||
|
||||
### 1.2 Load Brand Guidelines
|
||||
- Read {brand_guidelines}
|
||||
- Extract brand voice
|
||||
- Note brand restrictions
|
||||
- Identify brand values
|
||||
|
||||
### 1.3 Interview User
|
||||
Ask about:
|
||||
- Content goals and strategy
|
||||
- Audience demographics
|
||||
- Platform priorities
|
||||
- Special requirements
|
||||
- Common challenges
|
||||
- Content types produced
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Define Core Style Principles
|
||||
|
||||
### 2.1 Voice & Tone Principles
|
||||
Based on voice profile and brand:
|
||||
- Core voice characteristics
|
||||
- Tone spectrum (formal ↔ casual)
|
||||
- When to adjust tone
|
||||
- Non-negotiables
|
||||
|
||||
### 2.2 Content Philosophy
|
||||
Define approach to:
|
||||
- Value delivery
|
||||
- Audience respect
|
||||
- Authenticity standards
|
||||
- Quality expectations
|
||||
- Research requirements
|
||||
- Accuracy standards
|
||||
|
||||
### 2.3 Brand Expression
|
||||
How brand shows up:
|
||||
- Brand personality in writing
|
||||
- Brand values expression
|
||||
- Brand differentiation
|
||||
- Consistency requirements
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Grammar & Usage Rules
|
||||
|
||||
### 3.1 Punctuation Preferences
|
||||
- Oxford comma: [Always/Never/Context]
|
||||
- Em dash vs. en dash usage
|
||||
- Ellipsis usage
|
||||
- Quotation marks (single vs. double)
|
||||
- Apostrophe in contractions
|
||||
- Hyphenation rules
|
||||
|
||||
### 3.2 Capitalization
|
||||
- Title capitalization style
|
||||
- Headers and subheaders
|
||||
- Proper nouns
|
||||
- Brand terms
|
||||
- Acronyms and abbreviations
|
||||
|
||||
### 3.3 Numbers & Symbols
|
||||
- When to spell out numbers
|
||||
- Percentage format
|
||||
- Currency display
|
||||
- Date and time format
|
||||
- Special symbols usage
|
||||
|
||||
### 3.4 Common Usage Decisions
|
||||
- Active vs. passive voice preference
|
||||
- Person (1st, 2nd, 3rd) by context
|
||||
- Singular "they" policy
|
||||
- Contractions policy
|
||||
- Sentence fragments policy
|
||||
- Serial comma in lists
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Vocabulary & Word Choice
|
||||
|
||||
### 4.1 Preferred Terms
|
||||
- Industry terminology
|
||||
- Company-specific terms
|
||||
- Product names and capitalization
|
||||
- Branded terms
|
||||
|
||||
### 4.2 Words to Use
|
||||
- Power words aligned with voice
|
||||
- Transition words preferred
|
||||
- Strong verbs list
|
||||
- Descriptive words
|
||||
|
||||
### 4.3 Words to Avoid
|
||||
- Jargon to avoid
|
||||
- Clichés and buzzwords
|
||||
- Overused phrases
|
||||
- Offensive or exclusive language
|
||||
- Competitor terminology
|
||||
|
||||
### 4.4 Inclusive Language
|
||||
- Gender-neutral alternatives
|
||||
- Accessibility terminology
|
||||
- Cultural sensitivity
|
||||
- Age-inclusive language
|
||||
- Ability-inclusive language
|
||||
|
||||
---
|
||||
|
||||
## Step 5: Structure & Formatting
|
||||
|
||||
### 5.1 Document Structure
|
||||
- Standard outline template
|
||||
- Introduction requirements
|
||||
- Body organization
|
||||
- Conclusion requirements
|
||||
- Call-to-action placement
|
||||
|
||||
### 5.2 Headers & Subheaders
|
||||
- Heading hierarchy (H1-H6)
|
||||
- Heading format and style
|
||||
- Frequency guidelines
|
||||
- Keyword integration
|
||||
|
||||
### 5.3 Paragraph Guidelines
|
||||
- Target length
|
||||
- Single idea focus
|
||||
- Opening sentence style
|
||||
- Transition requirements
|
||||
|
||||
### 5.4 Lists & Bullets
|
||||
- When to use bullets vs. numbers
|
||||
- List item capitalization
|
||||
- Punctuation in lists
|
||||
- Parallel structure requirements
|
||||
- Nesting guidelines
|
||||
|
||||
### 5.5 Emphasis & Highlighting
|
||||
- Bold usage guidelines
|
||||
- Italic usage guidelines
|
||||
- Underline policy
|
||||
- ALL CAPS policy
|
||||
- Color usage (if applicable)
|
||||
|
||||
---
|
||||
|
||||
## Step 6: Platform-Specific Guidelines
|
||||
|
||||
For each platform, define:
|
||||
|
||||
### 6.1 Blog/Website
|
||||
- Optimal length
|
||||
- SEO requirements
|
||||
- Meta description format
|
||||
- Heading structure
|
||||
- Image requirements
|
||||
- Internal linking rules
|
||||
|
||||
### 6.2 LinkedIn
|
||||
- Character limits
|
||||
- Hook requirements
|
||||
- Hashtag strategy (number, placement)
|
||||
- Emoji policy
|
||||
- Line break strategy
|
||||
- Engagement question placement
|
||||
|
||||
### 6.3 Newsletter
|
||||
- Subject line rules
|
||||
- Greeting format
|
||||
- Section structure
|
||||
- Length guidelines
|
||||
- Sign-off format
|
||||
- CTA requirements
|
||||
|
||||
### 6.4 Twitter/X
|
||||
- Thread structure
|
||||
- Tweet length
|
||||
- Hashtag usage
|
||||
- Mention strategy
|
||||
- Quote tweet policy
|
||||
|
||||
### 6.5 Other Platforms
|
||||
- [Platform-specific rules for each]
|
||||
|
||||
---
|
||||
|
||||
## Step 7: Content Types & Templates
|
||||
|
||||
### 7.1 Article/Blog Post
|
||||
- Structure template
|
||||
- Word count range
|
||||
- Required elements
|
||||
- Quality checklist
|
||||
|
||||
### 7.2 Social Media Post
|
||||
- Hook templates
|
||||
- Body structure
|
||||
- CTA templates
|
||||
- Hashtag formula
|
||||
|
||||
### 7.3 Newsletter
|
||||
- Section templates
|
||||
- Subject line formulas
|
||||
- Content blocks
|
||||
- Sign-off templates
|
||||
|
||||
### 7.4 [Other Content Types]
|
||||
- Templates for each
|
||||
|
||||
---
|
||||
|
||||
## Step 8: Quality Standards
|
||||
|
||||
### 8.1 Readability Requirements
|
||||
- Target Flesch score range
|
||||
- Grade level target
|
||||
- Sentence length limits
|
||||
- Paragraph length limits
|
||||
|
||||
### 8.2 SEO Standards
|
||||
- Keyword density targets
|
||||
- Meta requirements
|
||||
- Header optimization
|
||||
- Link requirements
|
||||
|
||||
### 8.3 Engagement Standards
|
||||
- Hook strength requirements
|
||||
- Value density expectations
|
||||
- CTA clarity requirements
|
||||
- Scannability requirements
|
||||
|
||||
### 8.4 Accuracy Standards
|
||||
- Fact-checking requirements
|
||||
- Source citation rules
|
||||
- Data freshness requirements
|
||||
- Expert validation needs
|
||||
|
||||
---
|
||||
|
||||
## Step 9: Examples & Anti-Examples
|
||||
|
||||
### 9.1 Good Examples
|
||||
For each content type:
|
||||
- Exemplar piece
|
||||
- Why it works
|
||||
- Key elements highlighted
|
||||
- Checklist of what makes it great
|
||||
|
||||
### 9.2 Bad Examples
|
||||
For each content type:
|
||||
- What not to do
|
||||
- Why it fails
|
||||
- How to fix
|
||||
- Learning points
|
||||
|
||||
### 9.3 Before/After Transformations
|
||||
- Generic → Your style
|
||||
- Multiple examples
|
||||
- Annotated with changes
|
||||
- Rationale explained
|
||||
|
||||
---
|
||||
|
||||
## Step 10: Workflow & Processes
|
||||
|
||||
### 10.1 Content Creation Process
|
||||
1. [Step 1 of process]
|
||||
2. [Step 2 of process]
|
||||
3. [etc.]
|
||||
|
||||
### 10.2 Quality Assurance
|
||||
- Review checklist
|
||||
- Approval process
|
||||
- Revision protocol
|
||||
- Final checks
|
||||
|
||||
### 10.3 Update Procedures
|
||||
- When to update guide
|
||||
- How to suggest changes
|
||||
- Approval process
|
||||
- Version control
|
||||
|
||||
---
|
||||
|
||||
## Output
|
||||
|
||||
Comprehensive style guide using {template} including:
|
||||
- Executive summary
|
||||
- Core principles
|
||||
- Detailed guidelines
|
||||
- Platform-specific rules
|
||||
- Templates and examples
|
||||
- Quality standards
|
||||
- Quick reference card
|
||||
|
||||
Save to: {default_output_file}
|
||||
|
||||
**Your complete style guide ensuring consistent, high-quality content across all platforms!**
|
||||
|
|
@ -0,0 +1,18 @@
|
|||
name: "create-style-guide"
|
||||
description: "Create a comprehensive custom style guide for consistent content creation across all platforms"
|
||||
author: "Content Creator Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_data_path: "{config_source}:content_data_path"
|
||||
user_name: "{config_source}:user_name"
|
||||
date: system-generated
|
||||
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/create-style-guide"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
template: "{installed_path}/template.md"
|
||||
|
||||
voice_profiles_folder: "{content_data_path}/voice-profiles"
|
||||
brand_guidelines: "{content_data_path}/brand-guidelines.md"
|
||||
default_output_file: "{content_data_path}/style-guides/style-guide-{{style-name}}-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,49 @@
|
|||
# Extract Themes Workflow
|
||||
|
||||
Analyze raw notes to identify recurring themes, patterns, and content opportunities.
|
||||
|
||||
**User:** {user_name}
|
||||
**Raw Notes:** {rawnotes_folder}
|
||||
**Output:** {default_output_file}
|
||||
|
||||
## Process
|
||||
|
||||
### 1. Gather Raw Notes
|
||||
- Locate all files in {rawnotes_folder}
|
||||
- Ask user which notes to analyze (or all)
|
||||
- Load and review all content
|
||||
|
||||
### 2. Pattern Recognition
|
||||
- Identify recurring topics and themes
|
||||
- Find repeated concepts across notes
|
||||
- Spot emerging interests
|
||||
- Detect evolution of thinking
|
||||
|
||||
### 3. Theme Categorization
|
||||
- Group related ideas
|
||||
- Create theme categories
|
||||
- Identify sub-themes
|
||||
- Note frequency and emphasis
|
||||
|
||||
### 4. Unique Angle Discovery
|
||||
- Find counterintuitive insights
|
||||
- Identify fresh perspectives
|
||||
- Spot gaps in coverage
|
||||
- Discover untold stories
|
||||
|
||||
### 5. Content Opportunities
|
||||
- Suggest article topics from themes
|
||||
- Recommend content series ideas
|
||||
- Identify platform-specific opportunities
|
||||
- Prioritize by potential impact
|
||||
|
||||
## Output
|
||||
|
||||
Theme analysis report including:
|
||||
- 5-10 major themes identified
|
||||
- Sub-themes and categories
|
||||
- Unique angles and insights
|
||||
- Content opportunities ranked
|
||||
- Recommended next steps
|
||||
|
||||
Save to: {default_output_file}
|
||||
|
|
@ -0,0 +1,59 @@
|
|||
# Theme Analysis Report
|
||||
|
||||
**Analyst:** {user_name}
|
||||
**Date:** {date}
|
||||
**Notes Analyzed:** [Number of files]
|
||||
|
||||
---
|
||||
|
||||
## Major Themes Identified
|
||||
|
||||
### Theme 1: [Theme Name]
|
||||
**Frequency:** [High/Medium/Low]
|
||||
**Notes:** [Count]
|
||||
|
||||
**Key Concepts:**
|
||||
- [Concept 1]
|
||||
- [Concept 2]
|
||||
- [Concept 3]
|
||||
|
||||
**Unique Angles:**
|
||||
- [Angle 1]
|
||||
- [Angle 2]
|
||||
|
||||
---
|
||||
|
||||
[Repeat for 5-10 themes]
|
||||
|
||||
---
|
||||
|
||||
## Content Opportunities
|
||||
|
||||
### High Priority
|
||||
1. **[Topic 1]**
|
||||
- Based on: [Theme(s)]
|
||||
- Format: [Article/Series/etc]
|
||||
- Unique angle: [Angle]
|
||||
- Why now: [Rationale]
|
||||
|
||||
### Medium Priority
|
||||
[Additional opportunities]
|
||||
|
||||
### Future Exploration
|
||||
[Long-term ideas]
|
||||
|
||||
---
|
||||
|
||||
## Recommendations
|
||||
|
||||
**Immediate Actions:**
|
||||
1. [Action 1]
|
||||
2. [Action 2]
|
||||
|
||||
**Content Series Ideas:**
|
||||
- [Series 1]
|
||||
- [Series 2]
|
||||
|
||||
**Research Needed:**
|
||||
- [Research area 1]
|
||||
- [Research area 2]
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
name: "extract-themes"
|
||||
description: "Extract recurring themes, patterns, and unique angles from raw notes and ideas"
|
||||
author: "Content Creator Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_output_folder: "{config_source}:content_output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
date: system-generated
|
||||
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/extract-themes"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
template: "{installed_path}/template.md"
|
||||
|
||||
rawnotes_folder: "{content_output_folder}/rawnotes"
|
||||
default_output_file: "{content_output_folder}/research/themes-analysis-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,59 @@
|
|||
# Optimize Content Workflow
|
||||
|
||||
Improve existing content across readability, SEO, engagement, and voice.
|
||||
|
||||
**Readability Target:** Grade {readability_target}
|
||||
**SEO Enabled:** {enable_seo}
|
||||
**Voice Reference:** {writing_examples}
|
||||
**SEO Keywords:** {seo_keywords}
|
||||
|
||||
## Process
|
||||
|
||||
### 1. Content Input
|
||||
- Get content to optimize (file path or paste)
|
||||
- Identify optimization goals
|
||||
- Understand target platform
|
||||
|
||||
### 2. Analysis
|
||||
Run comprehensive analysis:
|
||||
- **Readability:** Flesch score, grade level, sentence complexity
|
||||
- **SEO:** Keyword usage, meta tags, structure (if enabled)
|
||||
- **Engagement:** Hook strength, value density, scannability
|
||||
- **Voice:** Consistency with {writing_examples}
|
||||
- **Technical:** Grammar, spelling, formatting
|
||||
|
||||
### 3. Prioritized Recommendations
|
||||
Organize issues by urgency:
|
||||
- **Critical:** Must fix (grammar errors, major structure issues)
|
||||
- **Important:** Should fix (readability, voice consistency)
|
||||
- **Optimization:** Nice to have (SEO, engagement tweaks)
|
||||
|
||||
### 4. Optimization
|
||||
Apply fixes:
|
||||
- Improve hook if weak
|
||||
- Simplify complex sentences
|
||||
- Add subheadings for scannability
|
||||
- Integrate keywords naturally (if SEO enabled)
|
||||
- Fix grammar/spelling errors
|
||||
- Align voice with examples
|
||||
- Enhance transitions
|
||||
|
||||
### 5. Validation
|
||||
Re-score optimized content:
|
||||
- Compare before/after scores
|
||||
- Verify improvements
|
||||
- Check nothing broke
|
||||
|
||||
### 6. Output
|
||||
Provide:
|
||||
- Optimized content
|
||||
- Before/after comparison
|
||||
- Score improvements
|
||||
- Remaining recommendations
|
||||
|
||||
## Target Scores
|
||||
- Readability: 60-70 Flesch
|
||||
- SEO: 80+ (if enabled)
|
||||
- Engagement: 75+
|
||||
- Technical: 90+
|
||||
- Voice: 65+
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
name: "optimize-content"
|
||||
description: "Optimize existing content for SEO, readability, engagement, and platform performance"
|
||||
author: "Content Creator Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_output_folder: "{config_source}:content_output_folder"
|
||||
readability_target: "{config_source}:readability_target_grade"
|
||||
enable_seo: "{config_source}:enable_seo_optimization"
|
||||
date: system-generated
|
||||
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/optimize-content"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
|
||||
seo_keywords: "{project-root}/{bmad_folder}/content-creator/data/seo-keywords.md"
|
||||
writing_examples: "{project-root}/{bmad_folder}/content-creator/data/writing-examples.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
# Quick Post Workflow
|
||||
|
||||
Create fast, engaging content for social media and short-form platforms.
|
||||
|
||||
**User:** {user_name}
|
||||
**Style:** {writing_style}
|
||||
**Voice Reference:** {writing_examples}
|
||||
**Output:** {default_output_file}
|
||||
|
||||
## Process
|
||||
|
||||
### 1. Post Requirements
|
||||
Ask user:
|
||||
- Platform (LinkedIn, Twitter, Instagram, etc.)
|
||||
- Topic or main idea
|
||||
- Goal (educate, inspire, entertain, promote)
|
||||
- Length preference
|
||||
|
||||
### 2. Voice Calibration
|
||||
- Review {writing_examples}
|
||||
- Match tone and style
|
||||
- Adapt for platform
|
||||
|
||||
### 3. Hook Creation
|
||||
Create compelling hook:
|
||||
- Counterintuitive statement
|
||||
- Provocative question
|
||||
- Surprising data point
|
||||
- Personal story opening
|
||||
- Bold claim
|
||||
|
||||
### 4. Content Development
|
||||
- Build on hook naturally
|
||||
- Include 1-2 key points
|
||||
- Add value in every line
|
||||
- Keep scannable
|
||||
|
||||
### 5. Engagement Optimization
|
||||
- Add call-to-action or question
|
||||
- Include relevant hashtags (if applicable)
|
||||
- Optimize formatting for platform
|
||||
- Check length requirements
|
||||
|
||||
### 6. Quality Check
|
||||
- Matches voice
|
||||
- Hook grabs attention
|
||||
- Value clearly delivered
|
||||
- Platform-appropriate
|
||||
- Error-free
|
||||
|
||||
## Platform Guidelines
|
||||
|
||||
**LinkedIn:** 900-1300 chars, professional yet personal
|
||||
**Twitter:** Thread of 3-8 tweets OR single tweet
|
||||
**Instagram:** Caption 125-150 words, hook in first line
|
||||
**General Social:** Short paragraphs, line breaks, emojis if matches voice
|
||||
|
||||
Save to: {default_output_file}
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
name: "quick-post"
|
||||
description: "Fast content creation for social media, quick posts, and short-form content"
|
||||
author: "Content Creator Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_output_folder: "{config_source}:content_output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
writing_style: "{config_source}:default_writing_style"
|
||||
date: system-generated
|
||||
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/quick-post"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
|
||||
writing_examples: "{project-root}/{bmad_folder}/content-creator/data/writing-examples.md"
|
||||
default_output_file: "{content_output_folder}/drafts/quick-post-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
# Research Topic Workflow
|
||||
|
||||
You are an expert research analyst conducting deep research on a topic.
|
||||
|
||||
**User:** {user_name}
|
||||
**Output:** {default_output_file}
|
||||
**Date:** {date}
|
||||
|
||||
**Priority Sources:** {research_sources}
|
||||
|
||||
## Process
|
||||
|
||||
### 1. Topic Definition
|
||||
- Get topic from user
|
||||
- Clarify scope and focus
|
||||
- Identify target audience
|
||||
- Define research goals
|
||||
|
||||
### 2. Source Discovery
|
||||
- **Check {research_sources} FIRST** for curated sources
|
||||
- Identify authoritative sources
|
||||
- Find recent publications (last 6-12 months)
|
||||
- Locate expert perspectives
|
||||
|
||||
### 3. Trend Analysis
|
||||
- Current trends in the space
|
||||
- Emerging developments
|
||||
- Industry shifts
|
||||
- Future predictions
|
||||
|
||||
### 4. Data Gathering
|
||||
- Recent statistics and research
|
||||
- Survey results
|
||||
- Case studies
|
||||
- Performance benchmarks
|
||||
|
||||
### 5. Unique Angles
|
||||
- Identify gaps in existing coverage
|
||||
- Find counterintuitive insights
|
||||
- Discover controversial perspectives
|
||||
- Uncover untold stories
|
||||
|
||||
### 6. Synthesis
|
||||
- Organize findings into categories
|
||||
- Highlight key insights
|
||||
- Prioritize most valuable information
|
||||
- Create actionable research brief
|
||||
|
||||
## Output
|
||||
|
||||
Research brief (300-500 words) including:
|
||||
- 5-7 key insights with sources
|
||||
- 3-5 relevant data points
|
||||
- 2-3 unique angles
|
||||
- Emerging trends
|
||||
- Recommended focus areas
|
||||
|
||||
Save to: {default_output_file}
|
||||
|
|
@ -0,0 +1,82 @@
|
|||
# Research Brief: [Topic]
|
||||
|
||||
**Researcher:** {user_name}
|
||||
**Date:** {date}
|
||||
**Research Goal:** [Define goal]
|
||||
|
||||
---
|
||||
|
||||
## Key Insights
|
||||
|
||||
1. **[Insight 1]**
|
||||
- Source: [Source]
|
||||
- Why it matters: [Context]
|
||||
|
||||
2. **[Insight 2]**
|
||||
- Source: [Source]
|
||||
- Why it matters: [Context]
|
||||
|
||||
[Continue for 5-7 insights]
|
||||
|
||||
---
|
||||
|
||||
## Data Points & Statistics
|
||||
|
||||
- **[Statistic 1]**: [Value] from [Source, Date]
|
||||
- **[Statistic 2]**: [Value] from [Source, Date]
|
||||
- **[Statistic 3]**: [Value] from [Source, Date]
|
||||
|
||||
[3-5 total data points]
|
||||
|
||||
---
|
||||
|
||||
## Unique Angles & Insights
|
||||
|
||||
### [Angle 1: Title]
|
||||
[Description of unique perspective]
|
||||
|
||||
### [Angle 2: Title]
|
||||
[Description of counterintuitive finding]
|
||||
|
||||
[2-3 unique angles]
|
||||
|
||||
---
|
||||
|
||||
## Current Trends
|
||||
|
||||
- **Trend 1:** [Description]
|
||||
- **Trend 2:** [Description]
|
||||
- **Trend 3:** [Description]
|
||||
|
||||
---
|
||||
|
||||
## Expert Perspectives
|
||||
|
||||
- **[Expert Name, Title]:** "[Quote or perspective]"
|
||||
- **[Expert Name, Title]:** "[Quote or perspective]"
|
||||
|
||||
---
|
||||
|
||||
## Content Recommendations
|
||||
|
||||
**Recommended Focus:**
|
||||
- [Focus area 1]
|
||||
- [Focus area 2]
|
||||
- [Focus area 3]
|
||||
|
||||
**Audience Considerations:**
|
||||
- [Consideration 1]
|
||||
- [Consideration 2]
|
||||
|
||||
**Potential Controversies:**
|
||||
- [Controversy or debate to address]
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
1. [Source 1 - Full citation]
|
||||
2. [Source 2 - Full citation]
|
||||
3. [Source 3 - Full citation]
|
||||
|
||||
[All sources referenced]
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
name: "research-topic"
|
||||
description: "Deep research on a topic with trend analysis, data gathering, source validation, and unique angle identification"
|
||||
author: "Content Creator Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_output_folder: "{config_source}:content_output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
date: system-generated
|
||||
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/research-topic"
|
||||
template: "{installed_path}/template.md"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
|
||||
research_sources: "{project-root}/{bmad_folder}/content-creator/data/research-sources.md"
|
||||
default_output_file: "{content_output_folder}/research/research-{{topic-slug}}-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,328 @@
|
|||
# Train Voice Workflow
|
||||
|
||||
You are a voice training specialist helping refine and evolve a voice profile with new writing samples.
|
||||
|
||||
**User:** {user_name}
|
||||
**Voice Profiles:** {voice_profiles_folder}
|
||||
**Writing Examples:** {writing_examples}
|
||||
**Date:** {date}
|
||||
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
This workflow allows you to continuously improve your voice profile by:
|
||||
- Adding new writing samples
|
||||
- Analyzing voice evolution
|
||||
- Updating voice characteristics
|
||||
- Refining style guidelines
|
||||
- Validating consistency
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Profile Selection
|
||||
|
||||
### 1.1 Identify Existing Profiles
|
||||
- List all voice profiles in {voice_profiles_folder}
|
||||
- Display profile names and creation dates
|
||||
- Show profile summaries
|
||||
|
||||
### 1.2 Select Profile to Train
|
||||
Ask user:
|
||||
- Which profile to update?
|
||||
- OR create new profile variation?
|
||||
|
||||
If creating variation:
|
||||
- Base on existing profile
|
||||
- Name the variation (e.g., "professional-linkedin", "casual-blog")
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Gather New Samples
|
||||
|
||||
### 2.1 Request New Writing
|
||||
Ask user to provide:
|
||||
- Recent writing (last 3-6 months)
|
||||
- Variety of contexts/platforms
|
||||
- Different content types
|
||||
- Minimum 500 words total
|
||||
|
||||
Options for providing samples:
|
||||
- Paste text directly
|
||||
- Provide file paths
|
||||
- Point to URLs (if accessible)
|
||||
|
||||
### 2.2 Analyze New Samples
|
||||
For each new sample:
|
||||
- Run style analysis (use style-analyzer task)
|
||||
- Extract key characteristics
|
||||
- Compare to existing profile
|
||||
- Note differences and evolution
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Voice Evolution Analysis
|
||||
|
||||
### 3.1 Compare Old vs New
|
||||
|
||||
**Sentence Structure:**
|
||||
- Old average length: [X] words
|
||||
- New average length: [Y] words
|
||||
- Change: [±X]%
|
||||
- Verdict: [Consistent/Evolved/Significant Change]
|
||||
|
||||
**Vocabulary:**
|
||||
- Old sophistication: [X]/10
|
||||
- New sophistication: [Y]/10
|
||||
- New power words: [list new additions]
|
||||
- Dropped patterns: [list if any]
|
||||
|
||||
**Tone & Style:**
|
||||
- Formality: Old [X]/10 → New [Y]/10
|
||||
- Personality shifts: [description]
|
||||
- New characteristics: [list]
|
||||
|
||||
**Structural Patterns:**
|
||||
- Paragraph length: Old [X] → New [Y]
|
||||
- Organization: [changes noted]
|
||||
- Formatting: [new patterns]
|
||||
|
||||
### 3.2 Identify Voice Drift
|
||||
|
||||
Assess changes:
|
||||
- **Natural Evolution** - Voice maturing/refining (good)
|
||||
- **Context Variation** - Different content types (expected)
|
||||
- **Inconsistency** - Random drift (needs attention)
|
||||
- **Intentional Shift** - Deliberate style change (validate with user)
|
||||
|
||||
### 3.3 Determine Update Strategy
|
||||
|
||||
Based on analysis:
|
||||
- **Minor Update** - Add new samples, slight refinement
|
||||
- **Moderate Update** - Update guidelines, add variations
|
||||
- **Major Update** - Significant evolution, create new version
|
||||
- **Split Profile** - Create separate profiles for different contexts
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Profile Update
|
||||
|
||||
### 4.1 Update Voice Characteristics
|
||||
|
||||
For each characteristic dimension:
|
||||
|
||||
**Sentence Structure:**
|
||||
- Recalculate averages including new samples
|
||||
- Update range and variance
|
||||
- Refine complexity distribution
|
||||
- Note new patterns
|
||||
|
||||
**Vocabulary Profile:**
|
||||
- Add new power words
|
||||
- Update signature phrases
|
||||
- Refine sophistication level
|
||||
- Note word preferences
|
||||
|
||||
**Tone & Personality:**
|
||||
- Recalibrate formality level
|
||||
- Update personality trait scores
|
||||
- Refine emotional expression ranges
|
||||
- Note tone evolution
|
||||
|
||||
**Structural Patterns:**
|
||||
- Update paragraph templates
|
||||
- Refine organization patterns
|
||||
- Note new formatting preferences
|
||||
- Update transition strategies
|
||||
|
||||
**Rhetorical Devices:**
|
||||
- Note new device usage
|
||||
- Update frequency metrics
|
||||
- Add new examples
|
||||
- Refine device guidelines
|
||||
|
||||
### 4.2 Update Style Guidelines
|
||||
|
||||
Revise guidelines based on new patterns:
|
||||
|
||||
**DO Updates:**
|
||||
- Add new best practices
|
||||
- Refine existing guidelines
|
||||
- Remove outdated patterns
|
||||
- Add new examples
|
||||
|
||||
**DON'T Updates:**
|
||||
- Add new anti-patterns
|
||||
- Remove restrictions if style evolved
|
||||
- Update alternatives
|
||||
- Clarify boundaries
|
||||
|
||||
### 4.3 Update Examples
|
||||
|
||||
Create new examples:
|
||||
- Generate using updated profile
|
||||
- Show voice evolution
|
||||
- Demonstrate new patterns
|
||||
- Provide context variations
|
||||
|
||||
---
|
||||
|
||||
## Step 5: Validation & Testing
|
||||
|
||||
### 5.1 Generate Test Content
|
||||
|
||||
Using updated profile:
|
||||
- Generate sample paragraph (200 words)
|
||||
- Apply all new characteristics
|
||||
- Match evolved tone and style
|
||||
|
||||
### 5.2 Compare to Recent Writing
|
||||
|
||||
Side-by-side comparison:
|
||||
- Generated content vs. recent sample
|
||||
- Similarity scoring
|
||||
- Element-by-element validation
|
||||
- Target: 75+ similarity score
|
||||
|
||||
### 5.3 User Validation
|
||||
|
||||
Present to user:
|
||||
- Show generated sample
|
||||
- Highlight new voice elements
|
||||
- Request feedback:
|
||||
- Does this still sound like you?
|
||||
- Captures recent evolution?
|
||||
- Any missing elements?
|
||||
- Approve for use?
|
||||
|
||||
---
|
||||
|
||||
## Step 6: Version Management
|
||||
|
||||
### 6.1 Version Control
|
||||
|
||||
Create version history:
|
||||
- Save previous version as archive
|
||||
- Name: `voice-profile-[name]-v[X]-[date].md`
|
||||
- Document changes in changelog
|
||||
- Maintain version history
|
||||
|
||||
### 6.2 Update Active Profile
|
||||
|
||||
Replace or update:
|
||||
- Update main profile with new version
|
||||
- Increment version number
|
||||
- Update last-trained date
|
||||
- Document training session
|
||||
|
||||
### 6.3 Sync Writing Examples
|
||||
|
||||
Update {writing_examples}:
|
||||
- Add new samples to examples file
|
||||
- Organize by date
|
||||
- Tag by context/platform
|
||||
- Maintain sample variety
|
||||
|
||||
---
|
||||
|
||||
## Step 7: Profile Enhancement
|
||||
|
||||
### 7.1 Create Context Variations (Optional)
|
||||
|
||||
If significant variation by context:
|
||||
- Extract platform-specific patterns
|
||||
- Create sub-profiles:
|
||||
- LinkedIn voice variation
|
||||
- Newsletter voice variation
|
||||
- Blog voice variation
|
||||
- Social media variation
|
||||
- Link to main profile
|
||||
- Document adaptation rules
|
||||
|
||||
### 7.2 Create Quick Reference Updates
|
||||
|
||||
Update 1-page quick reference:
|
||||
- New top characteristics
|
||||
- Updated do's and don'ts
|
||||
- Fresh examples
|
||||
- Evolution notes
|
||||
|
||||
### 7.3 Update Integration Instructions
|
||||
|
||||
Revise usage instructions:
|
||||
- How to use updated profile
|
||||
- New context variations
|
||||
- When to use which variation
|
||||
- Update commands
|
||||
|
||||
---
|
||||
|
||||
## Step 8: Training Summary & Next Steps
|
||||
|
||||
### 8.1 Training Summary
|
||||
|
||||
Provide comprehensive summary:
|
||||
|
||||
**Training Session:**
|
||||
- Date: {date}
|
||||
- Samples added: [X] ([total words])
|
||||
- Changes made: [summary]
|
||||
- Version: v[X] → v[Y]
|
||||
|
||||
**Key Updates:**
|
||||
- [Update 1]
|
||||
- [Update 2]
|
||||
- [Update 3]
|
||||
|
||||
**Voice Evolution:**
|
||||
- [Evolution note 1]
|
||||
- [Evolution note 2]
|
||||
|
||||
**Similarity Score:**
|
||||
- Pre-training: [X]/100
|
||||
- Post-training: [Y]/100
|
||||
- Improvement: [±X]
|
||||
|
||||
### 8.2 Testing Recommendations
|
||||
|
||||
Suggest testing:
|
||||
- Try `*write` with updated profile
|
||||
- Generate different content types
|
||||
- Validate across platforms
|
||||
- Compare to recent writing
|
||||
|
||||
### 8.3 Maintenance Schedule
|
||||
|
||||
Recommend next training:
|
||||
- **Frequency:** Every 3-6 months OR after 10+ new pieces
|
||||
- **Next Review:** [Date 3 months out]
|
||||
- **Triggers for sooner:**
|
||||
- Significant style shift
|
||||
- New content type
|
||||
- Platform expansion
|
||||
- User dissatisfaction
|
||||
|
||||
---
|
||||
|
||||
## Output
|
||||
|
||||
Updated voice profile with:
|
||||
- ✅ New samples analyzed and integrated
|
||||
- ✅ Voice characteristics updated
|
||||
- ✅ Style guidelines refined
|
||||
- ✅ New examples generated
|
||||
- ✅ Version history maintained
|
||||
- ✅ Quick reference updated
|
||||
- ✅ Validation passed
|
||||
|
||||
**Your voice profile is now trained with your latest writing and ready to generate more authentic content!**
|
||||
|
||||
---
|
||||
|
||||
## Integration
|
||||
|
||||
This workflow integrates with:
|
||||
- `*build-voice-profile` - Initial profile creation
|
||||
- `*check-voice` - Validation of generated content
|
||||
- `*analyze-style` - Deep style analysis
|
||||
- All content generation workflows
|
||||
|
|
@ -0,0 +1,16 @@
|
|||
name: "train-voice"
|
||||
description: "Train and refine your voice profile by adding new writing samples and updating style patterns"
|
||||
author: "Content Creator Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_data_path: "{config_source}:content_data_path"
|
||||
user_name: "{config_source}:user_name"
|
||||
date: system-generated
|
||||
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/train-voice"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
|
||||
voice_profiles_folder: "{content_data_path}/voice-profiles"
|
||||
writing_examples: "{content_data_path}/writing-examples.md"
|
||||
|
||||
standalone: true
|
||||
Loading…
Reference in New Issue