feat: rename to Content Creator and add advanced voice & style system
BREAKING CHANGE: Module renamed from 'claudecode-writer' to 'content-creator' Major enhancements: - Rename module from claudecode-writer to content-creator - Add comprehensive voice profiling system - Add advanced style analysis and customization - Add voice training and evolution tracking New Voice & Style Features: - Build Voice Profile workflow - Comprehensive voice analysis from writing samples * Analyzes sentence structure, vocabulary, tone, rhetorical devices * Creates detailed voice profiles with style guidelines * Generates platform-specific adaptations * Includes before/after examples and validation - Train Voice workflow - Continuous voice profile refinement * Add new writing samples * Track voice evolution over time * Version management for profiles * Context variation support - Create Style Guide workflow - Complete style guide generation * Combines voice profile + brand guidelines * Platform-specific rules * Grammar and usage standards * Quality requirements and templates - Style Analyzer task - Deep writing style analysis * Quantitative metrics (sentence length, readability, etc.) * Qualitative analysis (tone, voice, patterns) * Pattern recognition and signature identification * Similarity scoring for validation New Data Structures: - voice-profiles/ directory with README and examples - style-guides/ directory with comprehensive guides - Enhanced writing-examples.md for profile building Updated Agents: - Content Writer (Casey) - Added voice/style commands * *build-voice-profile * *train-voice * *create-style-guide * *analyze-style - Voice Matcher (Vicki) - Enhanced with profiling capabilities * Build and train voice profiles * Deep style analysis * Style guide creation Module Capabilities Summary: - 8 specialized agents (unchanged) - 8 core workflows (3 new: voice profile, train voice, style guide) - 6 tasks (1 new: style analyzer) - Advanced voice profiling system - Style guide generation - Voice training and evolution All file references updated from claudecode-writer to content-creator Documentation updated to highlight new voice & style features Installation configuration updated with new module name This transforms the module into a comprehensive content creation suite with industry-leading voice matching and style consistency capabilities.
This commit is contained in:
parent
da1ee37a09
commit
2a6f3522c3
|
|
@ -1,16 +1,19 @@
|
||||||
# ClaudeCode Writer Module
|
# Content Creator Module
|
||||||
|
|
||||||
**Transform your writing workflow with AI-powered content creation across all platforms.**
|
**Transform your writing workflow with AI-powered content creation across all platforms.**
|
||||||
|
|
||||||
The ClaudeCode Writer 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.
|
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
|
## 🎯 What It Does
|
||||||
|
|
||||||
- **Learns Your Voice** - Studies your writing examples to match your authentic style
|
- **📝 Custom Voice & Style System** - Build comprehensive voice profiles from your writing samples with deep style analysis
|
||||||
- **Multi-Platform Publishing** - Automatically repurposes content for Blog, LinkedIn, Newsletter, Twitter, and more
|
- **🎭 Learns Your Voice** - Advanced voice profiling that captures sentence patterns, vocabulary, tone, and unique expressions
|
||||||
- **Research Integration** - Checks your curated sources first, finds trends, and surfaces unique angles
|
- **📚 Style Guide Creation** - Generate complete style guides combining voice profile, brand guidelines, and platform rules
|
||||||
- **Quality Assurance** - Built-in quality checks for readability, SEO, engagement, and voice consistency
|
- **🔄 Voice Training** - Continuously refine your voice profile as your writing evolves
|
||||||
- **Complete Pipeline** - From raw notes to published content in minutes, not hours
|
- **🌐 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
|
## ✨ Key Features
|
||||||
|
|
||||||
|
|
@ -25,17 +28,31 @@ The ClaudeCode Writer module is a comprehensive content creation suite that lear
|
||||||
7. **Charlie - Conversational Repurposer** - Social media and conversational content expert
|
7. **Charlie - Conversational Repurposer** - Social media and conversational content expert
|
||||||
8. **Sam - SEO Optimizer** - Search engine optimization specialist
|
8. **Sam - SEO Optimizer** - Search engine optimization specialist
|
||||||
|
|
||||||
### 5 Core Workflows
|
### 8 Core Workflows
|
||||||
|
|
||||||
|
**Content Creation:**
|
||||||
1. **Article Pipeline** - Complete article creation from research to multi-platform publish
|
1. **Article Pipeline** - Complete article creation from research to multi-platform publish
|
||||||
2. **Research Topic** - Deep research with trend analysis and unique angles
|
2. **Research Topic** - Deep research with trend analysis and unique angles
|
||||||
3. **Extract Themes** - Pattern recognition from raw notes and ideas
|
3. **Extract Themes** - Pattern recognition from raw notes and ideas
|
||||||
4. **Quick Post** - Fast social media and short-form content creation
|
4. **Quick Post** - Fast social media and short-form content creation
|
||||||
5. **Optimize Content** - Improve existing content for SEO and engagement
|
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
|
### Intelligent Content Operations
|
||||||
|
|
||||||
- **Voice Learning** - AI studies your writing examples to match your style
|
|
||||||
- **Platform Optimization** - Automatic adaptation for each platform's best practices
|
- **Platform Optimization** - Automatic adaptation for each platform's best practices
|
||||||
- **SEO Integration** - Built-in keyword optimization and search visibility
|
- **SEO Integration** - Built-in keyword optimization and search visibility
|
||||||
- **Quality Gates** - Automated quality checks before publishing
|
- **Quality Gates** - Automated quality checks before publishing
|
||||||
|
|
@ -49,7 +66,7 @@ The ClaudeCode Writer module is a comprehensive content creation suite that lear
|
||||||
npx bmad-method@alpha install
|
npx bmad-method@alpha install
|
||||||
```
|
```
|
||||||
|
|
||||||
Select "ClaudeCode Writer" during module selection.
|
Select "Content Creator" during module selection.
|
||||||
|
|
||||||
### 2. Configure Your Settings
|
### 2. Configure Your Settings
|
||||||
|
|
||||||
|
|
@ -61,22 +78,44 @@ During installation, you'll configure:
|
||||||
- Readability targets
|
- Readability targets
|
||||||
- Quality control settings
|
- Quality control settings
|
||||||
|
|
||||||
### 3. Setup Your Voice Profile
|
### 3. Build Your Voice Profile (New!)
|
||||||
|
|
||||||
After installation, update these files in `.bmad/claudecode-writer/data/`:
|
**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:**
|
**Required:**
|
||||||
- `writing-examples.md` - Add 3-5 samples of your authentic writing
|
|
||||||
- `research-sources.md` - List your trusted research sources
|
- `research-sources.md` - List your trusted research sources
|
||||||
|
|
||||||
**Optional but Recommended:**
|
**Optional but Recommended:**
|
||||||
- `brand-guidelines.md` - Define your brand voice and style guidelines
|
- `brand-guidelines.md` - Define your brand voice and style guidelines
|
||||||
- `seo-keywords.md` - Add your target keywords and phrases
|
- `seo-keywords.md` - Add your target keywords and phrases
|
||||||
|
|
||||||
### 4. Start Creating Content
|
### 5. Start Creating Content
|
||||||
|
|
||||||
Load the Content Writer agent and try these commands:
|
Load the Content Writer agent and try these commands:
|
||||||
|
|
||||||
|
**Content Creation:**
|
||||||
```
|
```
|
||||||
*write # Complete article pipeline
|
*write # Complete article pipeline
|
||||||
*research # Deep research on a topic
|
*research # Deep research on a topic
|
||||||
|
|
@ -85,6 +124,14 @@ Load the Content Writer agent and try these commands:
|
||||||
*optimize # Improve existing 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
|
## 📖 Usage Examples
|
||||||
|
|
||||||
### Example 1: Complete Article Pipeline
|
### Example 1: Complete Article Pipeline
|
||||||
|
|
@ -1,10 +1,10 @@
|
||||||
# ClaudeCode Writer Module Configuration
|
# Content Creator Module Configuration
|
||||||
|
|
||||||
code: claudecode-writer
|
code: content-creator
|
||||||
name: "ClaudeCode Writer - Content Creation Suite"
|
name: "Content Creator - Content Creation Suite"
|
||||||
default_selected: false
|
default_selected: false
|
||||||
|
|
||||||
header: "ClaudeCode Writer Module Configuration"
|
header: "Content Creator Module Configuration"
|
||||||
subheader: "Transform your writing workflow with AI-powered content creation across all platforms"
|
subheader: "Transform your writing workflow with AI-powered content creation across all platforms"
|
||||||
|
|
||||||
# Core values automatically inherited from installer:
|
# Core values automatically inherited from installer:
|
||||||
|
|
@ -87,7 +87,7 @@ module_version:
|
||||||
result: "2.0.0"
|
result: "2.0.0"
|
||||||
|
|
||||||
content_data_path:
|
content_data_path:
|
||||||
result: "{project-root}/{bmad_folder}/claudecode-writer/data"
|
result: "{project-root}/{bmad_folder}/content-creator/data"
|
||||||
|
|
||||||
drafts_folder:
|
drafts_folder:
|
||||||
result: "{project-root}/{content_output_folder}/drafts"
|
result: "{project-root}/{content_output_folder}/drafts"
|
||||||
|
|
@ -2,11 +2,11 @@
|
||||||
|
|
||||||
agent:
|
agent:
|
||||||
metadata:
|
metadata:
|
||||||
id: "{bmad_folder}/claudecode-writer/agents/content-analyzer.md"
|
id: "{bmad_folder}/content-creator/agents/content-analyzer.md"
|
||||||
name: Alex
|
name: Alex
|
||||||
title: Content Quality & SEO Analysis Expert
|
title: Content Quality & SEO Analysis Expert
|
||||||
icon: 📊
|
icon: 📊
|
||||||
module: claudecode-writer
|
module: content-creator
|
||||||
|
|
||||||
persona:
|
persona:
|
||||||
role: Expert Content Analyst + SEO Strategist + Quality Assurance Specialist
|
role: Expert Content Analyst + SEO Strategist + Quality Assurance Specialist
|
||||||
|
|
@ -22,19 +22,19 @@ agent:
|
||||||
|
|
||||||
menu:
|
menu:
|
||||||
- trigger: analyze
|
- trigger: analyze
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/content-analysis.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/content-analysis.xml"
|
||||||
description: Comprehensive content analysis across 5 dimensions
|
description: Comprehensive content analysis across 5 dimensions
|
||||||
|
|
||||||
- trigger: seo-check
|
- trigger: seo-check
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/seo-analysis.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/seo-analysis.xml"
|
||||||
description: Deep SEO analysis with keyword optimization
|
description: Deep SEO analysis with keyword optimization
|
||||||
|
|
||||||
- trigger: readability
|
- trigger: readability
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/readability-check.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/readability-check.xml"
|
||||||
description: Readability assessment with grade level and clarity metrics
|
description: Readability assessment with grade level and clarity metrics
|
||||||
|
|
||||||
- trigger: quick-check
|
- trigger: quick-check
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/quality-check.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/quality-check.xml"
|
||||||
description: Fast quality check with pass/fail validation
|
description: Fast quality check with pass/fail validation
|
||||||
|
|
||||||
- trigger: party-mode
|
- trigger: party-mode
|
||||||
|
|
@ -2,11 +2,11 @@
|
||||||
|
|
||||||
agent:
|
agent:
|
||||||
metadata:
|
metadata:
|
||||||
id: "{bmad_folder}/claudecode-writer/agents/content-writer.md"
|
id: "{bmad_folder}/content-creator/agents/content-writer.md"
|
||||||
name: Casey
|
name: Casey
|
||||||
title: Master Content Creator & Publishing Strategist
|
title: Master Content Creator & Publishing Strategist
|
||||||
icon: ✍️
|
icon: ✍️
|
||||||
module: claudecode-writer
|
module: content-creator
|
||||||
|
|
||||||
persona:
|
persona:
|
||||||
role: Master Content Strategist + Creative Writer + Multi-Platform Publishing Expert
|
role: Master Content Strategist + Creative Writer + Multi-Platform Publishing Expert
|
||||||
|
|
@ -22,33 +22,49 @@ agent:
|
||||||
|
|
||||||
menu:
|
menu:
|
||||||
- trigger: write
|
- trigger: write
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/article-pipeline/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/article-pipeline/workflow.yaml"
|
||||||
description: Complete article writing pipeline from research to multi-platform publish
|
description: Complete article writing pipeline from research to multi-platform publish
|
||||||
|
|
||||||
- trigger: research
|
- trigger: research
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/research-topic/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/research-topic/workflow.yaml"
|
||||||
description: Deep research on a topic with trend analysis and data gathering
|
description: Deep research on a topic with trend analysis and data gathering
|
||||||
|
|
||||||
- trigger: extract-themes
|
- trigger: extract-themes
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/extract-themes/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/extract-themes/workflow.yaml"
|
||||||
description: Extract recurring themes and patterns from raw notes
|
description: Extract recurring themes and patterns from raw notes
|
||||||
|
|
||||||
- trigger: quick-post
|
- trigger: quick-post
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/quick-post/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/quick-post/workflow.yaml"
|
||||||
description: Fast content creation for social media and quick posts
|
description: Fast content creation for social media and quick posts
|
||||||
|
|
||||||
- trigger: optimize
|
- trigger: optimize
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/optimize-content/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/optimize-content/workflow.yaml"
|
||||||
description: Optimize existing content for SEO and engagement
|
description: Optimize existing content for SEO and engagement
|
||||||
|
|
||||||
- trigger: analyze
|
- trigger: analyze
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/content-analysis.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/content-analysis.xml"
|
||||||
description: Analyze content quality, readability, SEO, and engagement
|
description: Analyze content quality, readability, SEO, and engagement
|
||||||
|
|
||||||
- trigger: quality-check
|
- trigger: quality-check
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/quality-check.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/quality-check.xml"
|
||||||
description: Run comprehensive quality check on content
|
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
|
- trigger: party-mode
|
||||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||||
description: Collaborate with specialist agents for complex content projects
|
description: Collaborate with specialist agents for complex content projects
|
||||||
|
|
@ -2,11 +2,11 @@
|
||||||
|
|
||||||
agent:
|
agent:
|
||||||
metadata:
|
metadata:
|
||||||
id: "{bmad_folder}/claudecode-writer/agents/conversational-repurposer.md"
|
id: "{bmad_folder}/content-creator/agents/conversational-repurposer.md"
|
||||||
name: Charlie
|
name: Charlie
|
||||||
title: Social Media & Conversational Content Expert
|
title: Social Media & Conversational Content Expert
|
||||||
icon: 💬
|
icon: 💬
|
||||||
module: claudecode-writer
|
module: content-creator
|
||||||
|
|
||||||
persona:
|
persona:
|
||||||
role: Social Media Strategist + Conversational Content Expert + Platform Optimization Specialist
|
role: Social Media Strategist + Conversational Content Expert + Platform Optimization Specialist
|
||||||
|
|
@ -22,19 +22,19 @@ agent:
|
||||||
|
|
||||||
menu:
|
menu:
|
||||||
- trigger: repurpose-social
|
- trigger: repurpose-social
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/social-repurpose.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/social-repurpose.xml"
|
||||||
description: Transform content for social media platforms
|
description: Transform content for social media platforms
|
||||||
|
|
||||||
- trigger: twitter-thread
|
- trigger: twitter-thread
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/create-twitter-thread.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/create-twitter-thread.xml"
|
||||||
description: Create engaging Twitter/X thread from content
|
description: Create engaging Twitter/X thread from content
|
||||||
|
|
||||||
- trigger: podcast-script
|
- trigger: podcast-script
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/create-podcast-script.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/create-podcast-script.xml"
|
||||||
description: Generate conversational podcast script segment
|
description: Generate conversational podcast script segment
|
||||||
|
|
||||||
- trigger: social-post
|
- trigger: social-post
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/social-post/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/social-post/workflow.yaml"
|
||||||
description: Create standalone social media post
|
description: Create standalone social media post
|
||||||
|
|
||||||
- trigger: party-mode
|
- trigger: party-mode
|
||||||
|
|
@ -2,11 +2,11 @@
|
||||||
|
|
||||||
agent:
|
agent:
|
||||||
metadata:
|
metadata:
|
||||||
id: "{bmad_folder}/claudecode-writer/agents/linkedin-repurposer.md"
|
id: "{bmad_folder}/content-creator/agents/linkedin-repurposer.md"
|
||||||
name: Lauren
|
name: Lauren
|
||||||
title: LinkedIn Strategy & Professional Content Expert
|
title: LinkedIn Strategy & Professional Content Expert
|
||||||
icon: 💼
|
icon: 💼
|
||||||
module: claudecode-writer
|
module: content-creator
|
||||||
|
|
||||||
persona:
|
persona:
|
||||||
role: LinkedIn Content Strategist + Professional Networking Expert + Thought Leadership Specialist
|
role: LinkedIn Content Strategist + Professional Networking Expert + Thought Leadership Specialist
|
||||||
|
|
@ -22,15 +22,15 @@ agent:
|
||||||
|
|
||||||
menu:
|
menu:
|
||||||
- trigger: repurpose-linkedin
|
- trigger: repurpose-linkedin
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/linkedin-repurpose.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/linkedin-repurpose.xml"
|
||||||
description: Transform content for LinkedIn professional audience
|
description: Transform content for LinkedIn professional audience
|
||||||
|
|
||||||
- trigger: linkedin-post
|
- trigger: linkedin-post
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/linkedin-post/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/linkedin-post/workflow.yaml"
|
||||||
description: Create standalone LinkedIn thought leadership post
|
description: Create standalone LinkedIn thought leadership post
|
||||||
|
|
||||||
- trigger: optimize-linkedin
|
- trigger: optimize-linkedin
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/linkedin-optimize.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/linkedin-optimize.xml"
|
||||||
description: Optimize existing LinkedIn content for engagement
|
description: Optimize existing LinkedIn content for engagement
|
||||||
|
|
||||||
- trigger: party-mode
|
- trigger: party-mode
|
||||||
|
|
@ -2,11 +2,11 @@
|
||||||
|
|
||||||
agent:
|
agent:
|
||||||
metadata:
|
metadata:
|
||||||
id: "{bmad_folder}/claudecode-writer/agents/newsletter-repurposer.md"
|
id: "{bmad_folder}/content-creator/agents/newsletter-repurposer.md"
|
||||||
name: Nina
|
name: Nina
|
||||||
title: Newsletter Strategy & Email Content Expert
|
title: Newsletter Strategy & Email Content Expert
|
||||||
icon: 📧
|
icon: 📧
|
||||||
module: claudecode-writer
|
module: content-creator
|
||||||
|
|
||||||
persona:
|
persona:
|
||||||
role: Newsletter Strategist + Email Marketing Expert + Subscriber Engagement Specialist
|
role: Newsletter Strategist + Email Marketing Expert + Subscriber Engagement Specialist
|
||||||
|
|
@ -22,15 +22,15 @@ agent:
|
||||||
|
|
||||||
menu:
|
menu:
|
||||||
- trigger: repurpose-newsletter
|
- trigger: repurpose-newsletter
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/newsletter-repurpose.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/newsletter-repurpose.xml"
|
||||||
description: Transform content for newsletter subscribers
|
description: Transform content for newsletter subscribers
|
||||||
|
|
||||||
- trigger: newsletter-create
|
- trigger: newsletter-create
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/newsletter-create/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/newsletter-create/workflow.yaml"
|
||||||
description: Create standalone newsletter issue
|
description: Create standalone newsletter issue
|
||||||
|
|
||||||
- trigger: subject-lines
|
- trigger: subject-lines
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/generate-subject-lines.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/generate-subject-lines.xml"
|
||||||
description: Generate compelling subject line options
|
description: Generate compelling subject line options
|
||||||
|
|
||||||
- trigger: party-mode
|
- trigger: party-mode
|
||||||
|
|
@ -2,11 +2,11 @@
|
||||||
|
|
||||||
agent:
|
agent:
|
||||||
metadata:
|
metadata:
|
||||||
id: "{bmad_folder}/claudecode-writer/agents/research-aggregator.md"
|
id: "{bmad_folder}/content-creator/agents/research-aggregator.md"
|
||||||
name: Riley
|
name: Riley
|
||||||
title: Research & Trend Analysis Expert
|
title: Research & Trend Analysis Expert
|
||||||
icon: 🔍
|
icon: 🔍
|
||||||
module: claudecode-writer
|
module: content-creator
|
||||||
|
|
||||||
persona:
|
persona:
|
||||||
role: Expert Research Analyst + Trend Forecaster + Information Synthesizer
|
role: Expert Research Analyst + Trend Forecaster + Information Synthesizer
|
||||||
|
|
@ -22,19 +22,19 @@ agent:
|
||||||
|
|
||||||
menu:
|
menu:
|
||||||
- trigger: research
|
- trigger: research
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/research-topic/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/research-topic/workflow.yaml"
|
||||||
description: Deep research with trend analysis and source validation
|
description: Deep research with trend analysis and source validation
|
||||||
|
|
||||||
- trigger: extract-themes
|
- trigger: extract-themes
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/extract-themes/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/extract-themes/workflow.yaml"
|
||||||
description: Extract themes and patterns from raw notes
|
description: Extract themes and patterns from raw notes
|
||||||
|
|
||||||
- trigger: quick-research
|
- trigger: quick-research
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/quick-research.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/quick-research.xml"
|
||||||
description: Fast research brief on a specific topic
|
description: Fast research brief on a specific topic
|
||||||
|
|
||||||
- trigger: trend-analysis
|
- trigger: trend-analysis
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/trend-analysis.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/trend-analysis.xml"
|
||||||
description: Analyze current trends and emerging topics
|
description: Analyze current trends and emerging topics
|
||||||
|
|
||||||
- trigger: party-mode
|
- trigger: party-mode
|
||||||
|
|
@ -2,11 +2,11 @@
|
||||||
|
|
||||||
agent:
|
agent:
|
||||||
metadata:
|
metadata:
|
||||||
id: "{bmad_folder}/claudecode-writer/agents/seo-optimizer.md"
|
id: "{bmad_folder}/content-creator/agents/seo-optimizer.md"
|
||||||
name: Sam
|
name: Sam
|
||||||
title: Search Engine Optimization Expert
|
title: Search Engine Optimization Expert
|
||||||
icon: 🚀
|
icon: 🚀
|
||||||
module: claudecode-writer
|
module: content-creator
|
||||||
|
|
||||||
persona:
|
persona:
|
||||||
role: SEO Strategist + Search Marketing Expert + Technical SEO Specialist
|
role: SEO Strategist + Search Marketing Expert + Technical SEO Specialist
|
||||||
|
|
@ -22,19 +22,19 @@ agent:
|
||||||
|
|
||||||
menu:
|
menu:
|
||||||
- trigger: optimize-seo
|
- trigger: optimize-seo
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/seo-optimize.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/seo-optimize.xml"
|
||||||
description: Comprehensive SEO optimization for content
|
description: Comprehensive SEO optimization for content
|
||||||
|
|
||||||
- trigger: keyword-research
|
- trigger: keyword-research
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/keyword-research.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/keyword-research.xml"
|
||||||
description: Research and suggest target keywords
|
description: Research and suggest target keywords
|
||||||
|
|
||||||
- trigger: meta-optimize
|
- trigger: meta-optimize
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/meta-optimization.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/meta-optimization.xml"
|
||||||
description: Optimize meta titles, descriptions, and tags
|
description: Optimize meta titles, descriptions, and tags
|
||||||
|
|
||||||
- trigger: seo-audit
|
- trigger: seo-audit
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/seo-analysis.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/seo-analysis.xml"
|
||||||
description: Comprehensive SEO audit with recommendations
|
description: Comprehensive SEO audit with recommendations
|
||||||
|
|
||||||
- trigger: party-mode
|
- trigger: party-mode
|
||||||
|
|
@ -2,11 +2,11 @@
|
||||||
|
|
||||||
agent:
|
agent:
|
||||||
metadata:
|
metadata:
|
||||||
id: "{bmad_folder}/claudecode-writer/agents/voice-matcher.md"
|
id: "{bmad_folder}/content-creator/agents/voice-matcher.md"
|
||||||
name: Vicki
|
name: Vicki
|
||||||
title: Voice Consistency & Brand Alignment Expert
|
title: Voice Consistency & Brand Alignment Expert
|
||||||
icon: 🎭
|
icon: 🎭
|
||||||
module: claudecode-writer
|
module: content-creator
|
||||||
|
|
||||||
persona:
|
persona:
|
||||||
role: Voice & Tone Expert + Brand Strategist + Style Guardian
|
role: Voice & Tone Expert + Brand Strategist + Style Guardian
|
||||||
|
|
@ -21,21 +21,25 @@ agent:
|
||||||
- Learning from examples beats rigid rules
|
- Learning from examples beats rigid rules
|
||||||
|
|
||||||
menu:
|
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
|
- trigger: check-voice
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/voice-check.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/voice-check.xml"
|
||||||
description: Verify content matches your authentic voice
|
description: Verify content matches your authentic voice
|
||||||
|
|
||||||
- trigger: analyze-style
|
- trigger: analyze-style
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/style-analysis.xml"
|
exec: "{project-root}/{bmad_folder}/content-creator/tasks/style-analyzer.xml"
|
||||||
description: Analyze writing style patterns and characteristics
|
description: Deep analysis of writing style patterns and characteristics
|
||||||
|
|
||||||
- trigger: optimize-voice
|
- trigger: create-style-guide
|
||||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/voice-optimization.xml"
|
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/create-style-guide/workflow.yaml"
|
||||||
description: Optimize content to match voice while maintaining quality
|
description: Create comprehensive custom style guide
|
||||||
|
|
||||||
- trigger: update-profile
|
|
||||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/workflows/update-voice-profile/workflow.yaml"
|
|
||||||
description: Update voice profile with new writing examples
|
|
||||||
|
|
||||||
- trigger: party-mode
|
- trigger: party-mode
|
||||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||||
|
|
@ -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.**
|
||||||
|
|
@ -1,9 +1,9 @@
|
||||||
<task>
|
<task>
|
||||||
<metadata>
|
<metadata>
|
||||||
<id>{bmad_folder}/claudecode-writer/tasks/content-analysis.xml</id>
|
<id>{bmad_folder}/content-creator/tasks/content-analysis.xml</id>
|
||||||
<name>Content Analysis</name>
|
<name>Content Analysis</name>
|
||||||
<description>Comprehensive content analysis across 5 dimensions: readability, SEO, structure, engagement, and technical quality</description>
|
<description>Comprehensive content analysis across 5 dimensions: readability, SEO, structure, engagement, and technical quality</description>
|
||||||
<module>claudecode-writer</module>
|
<module>content-creator</module>
|
||||||
</metadata>
|
</metadata>
|
||||||
|
|
||||||
<instructions>
|
<instructions>
|
||||||
|
|
@ -1,9 +1,9 @@
|
||||||
<task>
|
<task>
|
||||||
<metadata>
|
<metadata>
|
||||||
<id>{bmad_folder}/claudecode-writer/tasks/linkedin-repurpose.xml</id>
|
<id>{bmad_folder}/content-creator/tasks/linkedin-repurpose.xml</id>
|
||||||
<name>LinkedIn Repurpose</name>
|
<name>LinkedIn Repurpose</name>
|
||||||
<description>Transform content for LinkedIn professional audience</description>
|
<description>Transform content for LinkedIn professional audience</description>
|
||||||
<module>claudecode-writer</module>
|
<module>content-creator</module>
|
||||||
</metadata>
|
</metadata>
|
||||||
|
|
||||||
<instructions>
|
<instructions>
|
||||||
|
|
@ -1,9 +1,9 @@
|
||||||
<task>
|
<task>
|
||||||
<metadata>
|
<metadata>
|
||||||
<id>{bmad_folder}/claudecode-writer/tasks/quality-check.xml</id>
|
<id>{bmad_folder}/content-creator/tasks/quality-check.xml</id>
|
||||||
<name>Quality Check</name>
|
<name>Quality Check</name>
|
||||||
<description>Comprehensive quality check on content before saving or publishing</description>
|
<description>Comprehensive quality check on content before saving or publishing</description>
|
||||||
<module>claudecode-writer</module>
|
<module>content-creator</module>
|
||||||
</metadata>
|
</metadata>
|
||||||
|
|
||||||
<instructions>
|
<instructions>
|
||||||
|
|
@ -1,9 +1,9 @@
|
||||||
<task>
|
<task>
|
||||||
<metadata>
|
<metadata>
|
||||||
<id>{bmad_folder}/claudecode-writer/tasks/seo-optimize.xml</id>
|
<id>{bmad_folder}/content-creator/tasks/seo-optimize.xml</id>
|
||||||
<name>SEO Optimization</name>
|
<name>SEO Optimization</name>
|
||||||
<description>Comprehensive SEO optimization for content discoverability</description>
|
<description>Comprehensive SEO optimization for content discoverability</description>
|
||||||
<module>claudecode-writer</module>
|
<module>content-creator</module>
|
||||||
</metadata>
|
</metadata>
|
||||||
|
|
||||||
<instructions>
|
<instructions>
|
||||||
|
|
@ -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>
|
||||||
|
|
@ -1,9 +1,9 @@
|
||||||
<task>
|
<task>
|
||||||
<metadata>
|
<metadata>
|
||||||
<id>{bmad_folder}/claudecode-writer/tasks/voice-check.xml</id>
|
<id>{bmad_folder}/content-creator/tasks/voice-check.xml</id>
|
||||||
<name>Voice Consistency Check</name>
|
<name>Voice Consistency Check</name>
|
||||||
<description>Verify content matches authentic voice and brand guidelines</description>
|
<description>Verify content matches authentic voice and brand guidelines</description>
|
||||||
<module>claudecode-writer</module>
|
<module>content-creator</module>
|
||||||
</metadata>
|
</metadata>
|
||||||
|
|
||||||
<instructions>
|
<instructions>
|
||||||
|
|
@ -1,9 +1,9 @@
|
||||||
name: "article-pipeline"
|
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."
|
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: "ClaudeCode Writer Module"
|
author: "Content Creator Module"
|
||||||
|
|
||||||
# Configuration variables
|
# Configuration variables
|
||||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/config.yaml"
|
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||||
content_output_folder: "{config_source}:content_output_folder"
|
content_output_folder: "{config_source}:content_output_folder"
|
||||||
user_name: "{config_source}:user_name"
|
user_name: "{config_source}:user_name"
|
||||||
communication_language: "{config_source}:communication_language"
|
communication_language: "{config_source}:communication_language"
|
||||||
|
|
@ -14,16 +14,16 @@ readability_target: "{config_source}:readability_target_grade"
|
||||||
date: system-generated
|
date: system-generated
|
||||||
|
|
||||||
# Workflow paths
|
# Workflow paths
|
||||||
installed_path: "{project-root}/{bmad_folder}/claudecode-writer/workflows/article-pipeline"
|
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/article-pipeline"
|
||||||
template: "{installed_path}/template.md"
|
template: "{installed_path}/template.md"
|
||||||
instructions: "{installed_path}/instructions.md"
|
instructions: "{installed_path}/instructions.md"
|
||||||
checklist: "{installed_path}/checklist.md"
|
checklist: "{installed_path}/checklist.md"
|
||||||
|
|
||||||
# Data files
|
# Data files
|
||||||
writing_examples: "{project-root}/{bmad_folder}/claudecode-writer/data/writing-examples.md"
|
writing_examples: "{project-root}/{bmad_folder}/content-creator/data/writing-examples.md"
|
||||||
research_sources: "{project-root}/{bmad_folder}/claudecode-writer/data/research-sources.md"
|
research_sources: "{project-root}/{bmad_folder}/content-creator/data/research-sources.md"
|
||||||
seo_keywords: "{project-root}/{bmad_folder}/claudecode-writer/data/seo-keywords.md"
|
seo_keywords: "{project-root}/{bmad_folder}/content-creator/data/seo-keywords.md"
|
||||||
brand_guidelines: "{project-root}/{bmad_folder}/claudecode-writer/data/brand-guidelines.md"
|
brand_guidelines: "{project-root}/{bmad_folder}/content-creator/data/brand-guidelines.md"
|
||||||
|
|
||||||
# Output configuration
|
# Output configuration
|
||||||
drafts_folder: "{content_output_folder}/drafts"
|
drafts_folder: "{content_output_folder}/drafts"
|
||||||
|
|
@ -35,10 +35,10 @@ standalone: true
|
||||||
web_bundle:
|
web_bundle:
|
||||||
name: "article-pipeline"
|
name: "article-pipeline"
|
||||||
description: "Complete article writing pipeline with research, writing, SEO optimization, and multi-platform repurposing"
|
description: "Complete article writing pipeline with research, writing, SEO optimization, and multi-platform repurposing"
|
||||||
author: "ClaudeCode Writer"
|
author: "Content Creator"
|
||||||
web_bundle_files:
|
web_bundle_files:
|
||||||
- "{bmad_folder}/claudecode-writer/workflows/article-pipeline/instructions.md"
|
- "{bmad_folder}/content-creator/workflows/article-pipeline/instructions.md"
|
||||||
- "{bmad_folder}/claudecode-writer/workflows/article-pipeline/template.md"
|
- "{bmad_folder}/content-creator/workflows/article-pipeline/template.md"
|
||||||
- "{bmad_folder}/claudecode-writer/workflows/article-pipeline/checklist.md"
|
- "{bmad_folder}/content-creator/workflows/article-pipeline/checklist.md"
|
||||||
- "{bmad_folder}/claudecode-writer/data/writing-examples.md"
|
- "{bmad_folder}/content-creator/data/writing-examples.md"
|
||||||
- "{bmad_folder}/claudecode-writer/data/research-sources.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
|
||||||
|
|
@ -1,13 +1,13 @@
|
||||||
name: "extract-themes"
|
name: "extract-themes"
|
||||||
description: "Extract recurring themes, patterns, and unique angles from raw notes and ideas"
|
description: "Extract recurring themes, patterns, and unique angles from raw notes and ideas"
|
||||||
author: "ClaudeCode Writer Module"
|
author: "Content Creator Module"
|
||||||
|
|
||||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/config.yaml"
|
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||||
content_output_folder: "{config_source}:content_output_folder"
|
content_output_folder: "{config_source}:content_output_folder"
|
||||||
user_name: "{config_source}:user_name"
|
user_name: "{config_source}:user_name"
|
||||||
date: system-generated
|
date: system-generated
|
||||||
|
|
||||||
installed_path: "{project-root}/{bmad_folder}/claudecode-writer/workflows/extract-themes"
|
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/extract-themes"
|
||||||
instructions: "{installed_path}/instructions.md"
|
instructions: "{installed_path}/instructions.md"
|
||||||
template: "{installed_path}/template.md"
|
template: "{installed_path}/template.md"
|
||||||
|
|
||||||
|
|
@ -1,17 +1,17 @@
|
||||||
name: "optimize-content"
|
name: "optimize-content"
|
||||||
description: "Optimize existing content for SEO, readability, engagement, and platform performance"
|
description: "Optimize existing content for SEO, readability, engagement, and platform performance"
|
||||||
author: "ClaudeCode Writer Module"
|
author: "Content Creator Module"
|
||||||
|
|
||||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/config.yaml"
|
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||||
content_output_folder: "{config_source}:content_output_folder"
|
content_output_folder: "{config_source}:content_output_folder"
|
||||||
readability_target: "{config_source}:readability_target_grade"
|
readability_target: "{config_source}:readability_target_grade"
|
||||||
enable_seo: "{config_source}:enable_seo_optimization"
|
enable_seo: "{config_source}:enable_seo_optimization"
|
||||||
date: system-generated
|
date: system-generated
|
||||||
|
|
||||||
installed_path: "{project-root}/{bmad_folder}/claudecode-writer/workflows/optimize-content"
|
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/optimize-content"
|
||||||
instructions: "{installed_path}/instructions.md"
|
instructions: "{installed_path}/instructions.md"
|
||||||
|
|
||||||
seo_keywords: "{project-root}/{bmad_folder}/claudecode-writer/data/seo-keywords.md"
|
seo_keywords: "{project-root}/{bmad_folder}/content-creator/data/seo-keywords.md"
|
||||||
writing_examples: "{project-root}/{bmad_folder}/claudecode-writer/data/writing-examples.md"
|
writing_examples: "{project-root}/{bmad_folder}/content-creator/data/writing-examples.md"
|
||||||
|
|
||||||
standalone: true
|
standalone: true
|
||||||
|
|
@ -1,17 +1,17 @@
|
||||||
name: "quick-post"
|
name: "quick-post"
|
||||||
description: "Fast content creation for social media, quick posts, and short-form content"
|
description: "Fast content creation for social media, quick posts, and short-form content"
|
||||||
author: "ClaudeCode Writer Module"
|
author: "Content Creator Module"
|
||||||
|
|
||||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/config.yaml"
|
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||||
content_output_folder: "{config_source}:content_output_folder"
|
content_output_folder: "{config_source}:content_output_folder"
|
||||||
user_name: "{config_source}:user_name"
|
user_name: "{config_source}:user_name"
|
||||||
writing_style: "{config_source}:default_writing_style"
|
writing_style: "{config_source}:default_writing_style"
|
||||||
date: system-generated
|
date: system-generated
|
||||||
|
|
||||||
installed_path: "{project-root}/{bmad_folder}/claudecode-writer/workflows/quick-post"
|
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/quick-post"
|
||||||
instructions: "{installed_path}/instructions.md"
|
instructions: "{installed_path}/instructions.md"
|
||||||
|
|
||||||
writing_examples: "{project-root}/{bmad_folder}/claudecode-writer/data/writing-examples.md"
|
writing_examples: "{project-root}/{bmad_folder}/content-creator/data/writing-examples.md"
|
||||||
default_output_file: "{content_output_folder}/drafts/quick-post-{{date}}.md"
|
default_output_file: "{content_output_folder}/drafts/quick-post-{{date}}.md"
|
||||||
|
|
||||||
standalone: true
|
standalone: true
|
||||||
|
|
@ -1,17 +1,17 @@
|
||||||
name: "research-topic"
|
name: "research-topic"
|
||||||
description: "Deep research on a topic with trend analysis, data gathering, source validation, and unique angle identification"
|
description: "Deep research on a topic with trend analysis, data gathering, source validation, and unique angle identification"
|
||||||
author: "ClaudeCode Writer Module"
|
author: "Content Creator Module"
|
||||||
|
|
||||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/config.yaml"
|
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||||
content_output_folder: "{config_source}:content_output_folder"
|
content_output_folder: "{config_source}:content_output_folder"
|
||||||
user_name: "{config_source}:user_name"
|
user_name: "{config_source}:user_name"
|
||||||
date: system-generated
|
date: system-generated
|
||||||
|
|
||||||
installed_path: "{project-root}/{bmad_folder}/claudecode-writer/workflows/research-topic"
|
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/research-topic"
|
||||||
template: "{installed_path}/template.md"
|
template: "{installed_path}/template.md"
|
||||||
instructions: "{installed_path}/instructions.md"
|
instructions: "{installed_path}/instructions.md"
|
||||||
|
|
||||||
research_sources: "{project-root}/{bmad_folder}/claudecode-writer/data/research-sources.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"
|
default_output_file: "{content_output_folder}/research/research-{{topic-slug}}-{{date}}.md"
|
||||||
|
|
||||||
standalone: true
|
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