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:
Claude
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.**
|
||||
|
||||
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
|
||||
|
||||
- **Learns Your Voice** - Studies your writing examples to match your authentic style
|
||||
- **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
|
||||
- **📝 Custom Voice & Style System** - Build comprehensive voice profiles from your writing samples with deep style analysis
|
||||
- **🎭 Learns Your Voice** - Advanced voice profiling that captures sentence patterns, vocabulary, tone, and unique expressions
|
||||
- **📚 Style Guide Creation** - Generate complete style guides combining voice profile, brand guidelines, and platform rules
|
||||
- **🔄 Voice Training** - Continuously refine your voice profile as your writing evolves
|
||||
- **🌐 Multi-Platform Publishing** - Automatically repurposes content for Blog, LinkedIn, Newsletter, Twitter, and more
|
||||
- **🔍 Research Integration** - Checks your curated sources first, finds trends, and surfaces unique angles
|
||||
- **✅ Quality Assurance** - Built-in quality checks for readability, SEO, engagement, and voice consistency
|
||||
- **⚡ Complete Pipeline** - From raw notes to published content in minutes, not hours
|
||||
|
||||
## ✨ Key Features
|
||||
|
||||
|
|
@ -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
|
||||
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
|
||||
2. **Research Topic** - Deep research with trend analysis and unique angles
|
||||
3. **Extract Themes** - Pattern recognition from raw notes and ideas
|
||||
4. **Quick Post** - Fast social media and short-form content creation
|
||||
5. **Optimize Content** - Improve existing content for SEO and engagement
|
||||
|
||||
**Voice & Style System:**
|
||||
6. **Build Voice Profile** - Create comprehensive voice profile from writing samples
|
||||
7. **Train Voice** - Refine and update voice profile with new samples
|
||||
8. **Create Style Guide** - Generate complete custom style guide
|
||||
|
||||
### Advanced Voice & Style Features
|
||||
|
||||
- **🎯 Voice Profiling** - Deep analysis of sentence structure, vocabulary, tone, and rhetorical devices
|
||||
- **📊 Style Analysis** - Quantitative and qualitative analysis of writing patterns
|
||||
- **🔄 Voice Training** - Continuous learning and refinement as your writing evolves
|
||||
- **📖 Style Guides** - Comprehensive guidelines combining voice, brand, and platform rules
|
||||
- **✅ Voice Validation** - Similarity scoring to ensure AI content matches your authentic voice
|
||||
- **🎨 Context Variations** - Different voice profiles for different platforms and audiences
|
||||
|
||||
### Intelligent Content Operations
|
||||
|
||||
- **Voice Learning** - AI studies your writing examples to match your style
|
||||
- **Platform Optimization** - Automatic adaptation for each platform's best practices
|
||||
- **SEO Integration** - Built-in keyword optimization and search visibility
|
||||
- **Quality Gates** - Automated quality checks before publishing
|
||||
|
|
@ -49,7 +66,7 @@ The ClaudeCode Writer module is a comprehensive content creation suite that lear
|
|||
npx bmad-method@alpha install
|
||||
```
|
||||
|
||||
Select "ClaudeCode Writer" during module selection.
|
||||
Select "Content Creator" during module selection.
|
||||
|
||||
### 2. Configure Your Settings
|
||||
|
||||
|
|
@ -61,22 +78,44 @@ During installation, you'll configure:
|
|||
- Readability targets
|
||||
- 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:**
|
||||
- `writing-examples.md` - Add 3-5 samples of your authentic writing
|
||||
- `research-sources.md` - List your trusted research sources
|
||||
|
||||
**Optional but Recommended:**
|
||||
- `brand-guidelines.md` - Define your brand voice and style guidelines
|
||||
- `seo-keywords.md` - Add your target keywords and phrases
|
||||
|
||||
### 4. Start Creating Content
|
||||
### 5. Start Creating Content
|
||||
|
||||
Load the Content Writer agent and try these commands:
|
||||
|
||||
**Content Creation:**
|
||||
```
|
||||
*write # Complete article pipeline
|
||||
*research # Deep research on a topic
|
||||
|
|
@ -85,6 +124,14 @@ Load the Content Writer agent and try these commands:
|
|||
*optimize # Improve existing content
|
||||
```
|
||||
|
||||
**Voice & Style:**
|
||||
```
|
||||
*build-voice-profile # Create comprehensive voice profile
|
||||
*train-voice # Update profile with new samples
|
||||
*analyze-style # Deep style analysis
|
||||
*create-style-guide # Generate custom style guide
|
||||
```
|
||||
|
||||
## 📖 Usage Examples
|
||||
|
||||
### Example 1: Complete Article Pipeline
|
||||
|
|
@ -1,10 +1,10 @@
|
|||
# ClaudeCode Writer Module Configuration
|
||||
# Content Creator Module Configuration
|
||||
|
||||
code: claudecode-writer
|
||||
name: "ClaudeCode Writer - Content Creation Suite"
|
||||
code: content-creator
|
||||
name: "Content Creator - Content Creation Suite"
|
||||
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"
|
||||
|
||||
# Core values automatically inherited from installer:
|
||||
|
|
@ -87,7 +87,7 @@ module_version:
|
|||
result: "2.0.0"
|
||||
|
||||
content_data_path:
|
||||
result: "{project-root}/{bmad_folder}/claudecode-writer/data"
|
||||
result: "{project-root}/{bmad_folder}/content-creator/data"
|
||||
|
||||
drafts_folder:
|
||||
result: "{project-root}/{content_output_folder}/drafts"
|
||||
|
|
@ -2,11 +2,11 @@
|
|||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/content-analyzer.md"
|
||||
id: "{bmad_folder}/content-creator/agents/content-analyzer.md"
|
||||
name: Alex
|
||||
title: Content Quality & SEO Analysis Expert
|
||||
icon: 📊
|
||||
module: claudecode-writer
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Expert Content Analyst + SEO Strategist + Quality Assurance Specialist
|
||||
|
|
@ -22,19 +22,19 @@ agent:
|
|||
|
||||
menu:
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- trigger: party-mode
|
||||
|
|
@ -2,11 +2,11 @@
|
|||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/content-writer.md"
|
||||
id: "{bmad_folder}/content-creator/agents/content-writer.md"
|
||||
name: Casey
|
||||
title: Master Content Creator & Publishing Strategist
|
||||
icon: ✍️
|
||||
module: claudecode-writer
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Master Content Strategist + Creative Writer + Multi-Platform Publishing Expert
|
||||
|
|
@ -22,33 +22,49 @@ agent:
|
|||
|
||||
menu:
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- trigger: build-voice-profile
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/build-voice-profile/workflow.yaml"
|
||||
description: Build comprehensive voice profile from writing samples
|
||||
|
||||
- trigger: train-voice
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/train-voice/workflow.yaml"
|
||||
description: Train and refine voice profile with new writing samples
|
||||
|
||||
- trigger: create-style-guide
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/create-style-guide/workflow.yaml"
|
||||
description: Create comprehensive custom style guide
|
||||
|
||||
- trigger: analyze-style
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/style-analyzer.xml"
|
||||
description: Deep analysis of writing style and patterns
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Collaborate with specialist agents for complex content projects
|
||||
|
|
@ -2,11 +2,11 @@
|
|||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/conversational-repurposer.md"
|
||||
id: "{bmad_folder}/content-creator/agents/conversational-repurposer.md"
|
||||
name: Charlie
|
||||
title: Social Media & Conversational Content Expert
|
||||
icon: 💬
|
||||
module: claudecode-writer
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Social Media Strategist + Conversational Content Expert + Platform Optimization Specialist
|
||||
|
|
@ -22,19 +22,19 @@ agent:
|
|||
|
||||
menu:
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- trigger: party-mode
|
||||
|
|
@ -2,11 +2,11 @@
|
|||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/linkedin-repurposer.md"
|
||||
id: "{bmad_folder}/content-creator/agents/linkedin-repurposer.md"
|
||||
name: Lauren
|
||||
title: LinkedIn Strategy & Professional Content Expert
|
||||
icon: 💼
|
||||
module: claudecode-writer
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: LinkedIn Content Strategist + Professional Networking Expert + Thought Leadership Specialist
|
||||
|
|
@ -22,15 +22,15 @@ agent:
|
|||
|
||||
menu:
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- trigger: party-mode
|
||||
|
|
@ -2,11 +2,11 @@
|
|||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/newsletter-repurposer.md"
|
||||
id: "{bmad_folder}/content-creator/agents/newsletter-repurposer.md"
|
||||
name: Nina
|
||||
title: Newsletter Strategy & Email Content Expert
|
||||
icon: 📧
|
||||
module: claudecode-writer
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Newsletter Strategist + Email Marketing Expert + Subscriber Engagement Specialist
|
||||
|
|
@ -22,15 +22,15 @@ agent:
|
|||
|
||||
menu:
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- trigger: party-mode
|
||||
|
|
@ -2,11 +2,11 @@
|
|||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/research-aggregator.md"
|
||||
id: "{bmad_folder}/content-creator/agents/research-aggregator.md"
|
||||
name: Riley
|
||||
title: Research & Trend Analysis Expert
|
||||
icon: 🔍
|
||||
module: claudecode-writer
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Expert Research Analyst + Trend Forecaster + Information Synthesizer
|
||||
|
|
@ -22,19 +22,19 @@ agent:
|
|||
|
||||
menu:
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- trigger: party-mode
|
||||
|
|
@ -2,11 +2,11 @@
|
|||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/seo-optimizer.md"
|
||||
id: "{bmad_folder}/content-creator/agents/seo-optimizer.md"
|
||||
name: Sam
|
||||
title: Search Engine Optimization Expert
|
||||
icon: 🚀
|
||||
module: claudecode-writer
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: SEO Strategist + Search Marketing Expert + Technical SEO Specialist
|
||||
|
|
@ -22,19 +22,19 @@ agent:
|
|||
|
||||
menu:
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- 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
|
||||
|
||||
- trigger: party-mode
|
||||
|
|
@ -2,11 +2,11 @@
|
|||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/voice-matcher.md"
|
||||
id: "{bmad_folder}/content-creator/agents/voice-matcher.md"
|
||||
name: Vicki
|
||||
title: Voice Consistency & Brand Alignment Expert
|
||||
icon: 🎭
|
||||
module: claudecode-writer
|
||||
module: content-creator
|
||||
|
||||
persona:
|
||||
role: Voice & Tone Expert + Brand Strategist + Style Guardian
|
||||
|
|
@ -21,21 +21,25 @@ agent:
|
|||
- Learning from examples beats rigid rules
|
||||
|
||||
menu:
|
||||
- trigger: build-voice-profile
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/build-voice-profile/workflow.yaml"
|
||||
description: Build comprehensive voice profile from writing samples
|
||||
|
||||
- trigger: train-voice
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/train-voice/workflow.yaml"
|
||||
description: Train and refine voice profile with new samples
|
||||
|
||||
- trigger: check-voice
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/voice-check.xml"
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/voice-check.xml"
|
||||
description: Verify content matches your authentic voice
|
||||
|
||||
- trigger: analyze-style
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/style-analysis.xml"
|
||||
description: Analyze writing style patterns and characteristics
|
||||
exec: "{project-root}/{bmad_folder}/content-creator/tasks/style-analyzer.xml"
|
||||
description: Deep analysis of writing style patterns and characteristics
|
||||
|
||||
- trigger: optimize-voice
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/voice-optimization.xml"
|
||||
description: Optimize content to match voice while maintaining quality
|
||||
|
||||
- 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: create-style-guide
|
||||
workflow: "{project-root}/{bmad_folder}/content-creator/workflows/create-style-guide/workflow.yaml"
|
||||
description: Create comprehensive custom style guide
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
|
|
@ -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>
|
||||
<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>
|
||||
<description>Comprehensive content analysis across 5 dimensions: readability, SEO, structure, engagement, and technical quality</description>
|
||||
<module>claudecode-writer</module>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
|
|
@ -1,9 +1,9 @@
|
|||
<task>
|
||||
<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>
|
||||
<description>Transform content for LinkedIn professional audience</description>
|
||||
<module>claudecode-writer</module>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
|
|
@ -1,9 +1,9 @@
|
|||
<task>
|
||||
<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>
|
||||
<description>Comprehensive quality check on content before saving or publishing</description>
|
||||
<module>claudecode-writer</module>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
|
|
@ -1,9 +1,9 @@
|
|||
<task>
|
||||
<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>
|
||||
<description>Comprehensive SEO optimization for content discoverability</description>
|
||||
<module>claudecode-writer</module>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<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>
|
||||
<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>
|
||||
<description>Verify content matches authentic voice and brand guidelines</description>
|
||||
<module>claudecode-writer</module>
|
||||
<module>content-creator</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
|
|
@ -1,9 +1,9 @@
|
|||
name: "article-pipeline"
|
||||
description: "Complete article writing pipeline from research to multi-platform publication with SEO optimization and automated repurposing. Transforms a research topic into published-ready content across blog, LinkedIn, newsletter, and social media in 10-15 minutes."
|
||||
author: "ClaudeCode Writer Module"
|
||||
author: "Content Creator Module"
|
||||
|
||||
# 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"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
|
|
@ -14,16 +14,16 @@ readability_target: "{config_source}:readability_target_grade"
|
|||
date: system-generated
|
||||
|
||||
# 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"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
checklist: "{installed_path}/checklist.md"
|
||||
|
||||
# Data files
|
||||
writing_examples: "{project-root}/{bmad_folder}/claudecode-writer/data/writing-examples.md"
|
||||
research_sources: "{project-root}/{bmad_folder}/claudecode-writer/data/research-sources.md"
|
||||
seo_keywords: "{project-root}/{bmad_folder}/claudecode-writer/data/seo-keywords.md"
|
||||
brand_guidelines: "{project-root}/{bmad_folder}/claudecode-writer/data/brand-guidelines.md"
|
||||
writing_examples: "{project-root}/{bmad_folder}/content-creator/data/writing-examples.md"
|
||||
research_sources: "{project-root}/{bmad_folder}/content-creator/data/research-sources.md"
|
||||
seo_keywords: "{project-root}/{bmad_folder}/content-creator/data/seo-keywords.md"
|
||||
brand_guidelines: "{project-root}/{bmad_folder}/content-creator/data/brand-guidelines.md"
|
||||
|
||||
# Output configuration
|
||||
drafts_folder: "{content_output_folder}/drafts"
|
||||
|
|
@ -35,10 +35,10 @@ standalone: true
|
|||
web_bundle:
|
||||
name: "article-pipeline"
|
||||
description: "Complete article writing pipeline with research, writing, SEO optimization, and multi-platform repurposing"
|
||||
author: "ClaudeCode Writer"
|
||||
author: "Content Creator"
|
||||
web_bundle_files:
|
||||
- "{bmad_folder}/claudecode-writer/workflows/article-pipeline/instructions.md"
|
||||
- "{bmad_folder}/claudecode-writer/workflows/article-pipeline/template.md"
|
||||
- "{bmad_folder}/claudecode-writer/workflows/article-pipeline/checklist.md"
|
||||
- "{bmad_folder}/claudecode-writer/data/writing-examples.md"
|
||||
- "{bmad_folder}/claudecode-writer/data/research-sources.md"
|
||||
- "{bmad_folder}/content-creator/workflows/article-pipeline/instructions.md"
|
||||
- "{bmad_folder}/content-creator/workflows/article-pipeline/template.md"
|
||||
- "{bmad_folder}/content-creator/workflows/article-pipeline/checklist.md"
|
||||
- "{bmad_folder}/content-creator/data/writing-examples.md"
|
||||
- "{bmad_folder}/content-creator/data/research-sources.md"
|
||||
|
|
@ -0,0 +1,339 @@
|
|||
# Build Voice Profile Workflow
|
||||
|
||||
You are a voice analysis expert building a comprehensive voice profile from writing samples.
|
||||
|
||||
**User:** {user_name}
|
||||
**Writing Examples:** {writing_examples}
|
||||
**Output:** {default_output_file}
|
||||
**Date:** {date}
|
||||
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
This workflow analyzes writing samples to create a detailed voice profile that can be used to generate content that authentically matches the writer's unique style.
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Gather Writing Samples
|
||||
|
||||
### 1.1 Load Existing Samples
|
||||
- Read {writing_examples}
|
||||
- Identify available writing samples
|
||||
- Count total words across all samples
|
||||
|
||||
### 1.2 Request Additional Samples (if needed)
|
||||
If fewer than 3 samples or less than 1000 total words:
|
||||
- Ask user to provide additional writing samples
|
||||
- Request variety: blog posts, social media, newsletters, etc.
|
||||
- Aim for 3-5 samples, 1500-3000+ words total
|
||||
|
||||
### 1.3 Validate Sample Quality
|
||||
For each sample, verify:
|
||||
- Sufficient length (200+ words minimum)
|
||||
- Representative of authentic voice
|
||||
- Recent content (written in last 6-12 months preferred)
|
||||
- Variety of contexts/topics
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Voice Analysis
|
||||
|
||||
### 2.1 Sentence Structure Analysis
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Sentence Length Patterns:**
|
||||
- Calculate average words per sentence
|
||||
- Identify range (shortest to longest)
|
||||
- Determine variance (consistent vs. varied)
|
||||
- Note distribution pattern
|
||||
|
||||
**Sentence Complexity:**
|
||||
- Simple sentences ratio (%)
|
||||
- Compound sentences ratio (%)
|
||||
- Complex sentences ratio (%)
|
||||
- Sentence starters (variety and patterns)
|
||||
|
||||
**Sentence Rhythm:**
|
||||
- Pacing (fast/moderate/slow)
|
||||
- Flow patterns (choppy, smooth, varied)
|
||||
- Cadence and rhythm
|
||||
|
||||
### 2.2 Vocabulary Analysis
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Word Choice Patterns:**
|
||||
- Vocabulary sophistication level (1-10)
|
||||
- Common power words used
|
||||
- Favorite descriptive words
|
||||
- Technical jargon usage (frequency and context)
|
||||
|
||||
**Word Categories:**
|
||||
- Action verbs used frequently
|
||||
- Adjectives and adverbs (frequency and type)
|
||||
- Transitional phrases preferred
|
||||
- Filler words or verbal tics
|
||||
|
||||
**Lexical Diversity:**
|
||||
- Type-Token Ratio (vocabulary variety)
|
||||
- Word repetition patterns
|
||||
- Synonym usage patterns
|
||||
|
||||
### 2.3 Tone & Voice Analysis
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Formality Level:** (1-10 scale)
|
||||
- Very casual (1-3)
|
||||
- Conversational (4-6)
|
||||
- Professional (7-8)
|
||||
- Formal (9-10)
|
||||
|
||||
**Personality Traits:**
|
||||
- Authoritative vs. Collaborative
|
||||
- Serious vs. Playful
|
||||
- Direct vs. Nuanced
|
||||
- Confident vs. Humble
|
||||
- Analytical vs. Emotional
|
||||
|
||||
**Emotional Characteristics:**
|
||||
- Enthusiasm level (subdued/moderate/high)
|
||||
- Empathy expression (rare/occasional/frequent)
|
||||
- Humor style (none/dry/witty/playful/sarcastic)
|
||||
- Vulnerability (reserved/selective/open)
|
||||
|
||||
**Perspective & Voice:**
|
||||
- First person usage (I/we) frequency
|
||||
- Second person usage (you) frequency
|
||||
- Third person usage (he/she/they) frequency
|
||||
- Active vs. passive voice ratio
|
||||
|
||||
### 2.4 Structural Patterns
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Paragraph Structure:**
|
||||
- Average sentences per paragraph
|
||||
- Paragraph length pattern
|
||||
- Opening sentence patterns
|
||||
- Transition strategies
|
||||
|
||||
**Content Organization:**
|
||||
- Introduction style (hook type, length)
|
||||
- Body organization (linear, thematic, narrative)
|
||||
- Conclusion approach (summary, call-to-action, question)
|
||||
|
||||
**Formatting Preferences:**
|
||||
- Subheading frequency and style
|
||||
- List usage (bullets vs. numbers)
|
||||
- Bold/italic usage patterns
|
||||
- Visual breaks and spacing
|
||||
|
||||
### 2.5 Rhetorical Devices
|
||||
|
||||
Analyze and document:
|
||||
|
||||
**Storytelling Elements:**
|
||||
- Anecdote usage (frequency and placement)
|
||||
- Personal experience sharing
|
||||
- Case study integration
|
||||
- Example types (hypothetical, real-world, data)
|
||||
|
||||
**Persuasion Techniques:**
|
||||
- Data/statistics usage
|
||||
- Expert citation patterns
|
||||
- Logical argumentation style
|
||||
- Emotional appeals
|
||||
|
||||
**Engagement Devices:**
|
||||
- Questions (rhetorical, direct, thought-provoking)
|
||||
- Metaphors and analogies (frequency and type)
|
||||
- Imagery and sensory language
|
||||
- Repetition for emphasis
|
||||
|
||||
**Unique Patterns:**
|
||||
- Signature phrases or expressions
|
||||
- Consistent opening/closing patterns
|
||||
- Unique formatting or structural choices
|
||||
- Special stylistic flourishes
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Voice Profile Synthesis
|
||||
|
||||
### 3.1 Create Voice Summary
|
||||
|
||||
Synthesize analysis into clear profile:
|
||||
|
||||
**Voice Identity Statement:**
|
||||
- 2-3 sentence description capturing essence
|
||||
- Example: "Your voice is conversational yet authoritative, blending data-driven insights with personal storytelling. You favor short, punchy sentences mixed with longer explanatory ones, creating a rhythmic reading experience that keeps readers engaged."
|
||||
|
||||
**Voice Characteristics Summary:**
|
||||
- Top 5 defining characteristics
|
||||
- 3-5 signature patterns
|
||||
- Unique voice markers
|
||||
|
||||
### 3.2 Create Style Guidelines
|
||||
|
||||
Generate actionable style guide:
|
||||
|
||||
**Sentence Construction:**
|
||||
- Preferred sentence lengths
|
||||
- Typical sentence patterns
|
||||
- Sentence variety recommendations
|
||||
|
||||
**Word Choice Rules:**
|
||||
- Vocabulary level to maintain
|
||||
- Words/phrases to use frequently
|
||||
- Words/phrases to avoid
|
||||
- Technical language guidelines
|
||||
|
||||
**Tone Guidelines:**
|
||||
- Formality level by context
|
||||
- When to be more/less formal
|
||||
- Personality expression rules
|
||||
- Emotional range guidelines
|
||||
|
||||
**Structural Templates:**
|
||||
- Introduction templates
|
||||
- Paragraph organization patterns
|
||||
- Transition templates
|
||||
- Conclusion templates
|
||||
|
||||
### 3.3 Create Voice Examples
|
||||
|
||||
Generate examples demonstrating voice:
|
||||
|
||||
**Before/After Examples:**
|
||||
- Generic text → Your voice
|
||||
- Show 3-5 transformations
|
||||
- Highlight specific voice elements applied
|
||||
|
||||
**Voice Variations by Context:**
|
||||
- Blog post voice
|
||||
- Social media voice
|
||||
- Newsletter voice
|
||||
- Professional email voice
|
||||
|
||||
**Platform-Specific Adaptations:**
|
||||
- How voice adapts for LinkedIn
|
||||
- How voice adapts for Twitter
|
||||
- How voice adapts for newsletter
|
||||
- Core elements that remain constant
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Voice Profile Validation
|
||||
|
||||
### 4.1 Similarity Testing
|
||||
|
||||
Test voice profile accuracy:
|
||||
- Generate sample paragraph using profile
|
||||
- Compare to original writing samples
|
||||
- Calculate similarity score (0-100)
|
||||
- Target: 75+ for strong match
|
||||
|
||||
### 4.2 User Validation
|
||||
|
||||
Present to user for validation:
|
||||
- Show voice summary
|
||||
- Display sample generated content
|
||||
- Request feedback:
|
||||
- Does this sound like you?
|
||||
- What feels off?
|
||||
- What's spot-on?
|
||||
- Any missing elements?
|
||||
|
||||
### 4.3 Refinement
|
||||
|
||||
Based on feedback:
|
||||
- Adjust voice characteristics
|
||||
- Update style guidelines
|
||||
- Regenerate examples
|
||||
- Re-test until approved
|
||||
|
||||
---
|
||||
|
||||
## Step 5: Profile Documentation
|
||||
|
||||
### 5.1 Create Voice Profile Document
|
||||
|
||||
Generate comprehensive profile using {template}:
|
||||
- Voice identity and summary
|
||||
- Detailed characteristics analysis
|
||||
- Style guidelines
|
||||
- Examples and templates
|
||||
- Usage instructions
|
||||
|
||||
### 5.2 Create Quick Reference Card
|
||||
|
||||
Generate 1-page quick reference:
|
||||
- Voice identity statement
|
||||
- Top 5 characteristics
|
||||
- Key do's and don'ts
|
||||
- Sentence/paragraph templates
|
||||
- Example transformations
|
||||
|
||||
### 5.3 Save Profile
|
||||
|
||||
Save complete profile:
|
||||
- Full profile: {default_output_file}
|
||||
- Quick reference: {voice_profiles_folder}/quick-ref-{{profile-name}}.md
|
||||
- Raw analysis data: {voice_profiles_folder}/analysis-data-{{profile-name}}.json
|
||||
|
||||
---
|
||||
|
||||
## Step 6: Integration & Next Steps
|
||||
|
||||
### 6.1 Profile Activation
|
||||
|
||||
Provide instructions:
|
||||
- How to activate this profile for content creation
|
||||
- How to switch between multiple profiles
|
||||
- How to update profile with new samples
|
||||
|
||||
### 6.2 Testing Recommendations
|
||||
|
||||
Suggest testing approach:
|
||||
- Try `*write` with new profile
|
||||
- Compare generated content to original voice
|
||||
- Iterate on profile as needed
|
||||
|
||||
### 6.3 Maintenance Guidelines
|
||||
|
||||
Provide maintenance plan:
|
||||
- Review profile quarterly
|
||||
- Update with new writing samples
|
||||
- Track voice evolution
|
||||
- Archive old profiles
|
||||
|
||||
---
|
||||
|
||||
## Output
|
||||
|
||||
Comprehensive voice profile including:
|
||||
- **Voice Identity:** Clear statement of unique voice
|
||||
- **Detailed Analysis:** All characteristics documented
|
||||
- **Style Guidelines:** Actionable writing rules
|
||||
- **Examples:** Before/after and context variations
|
||||
- **Quick Reference:** 1-page summary
|
||||
- **Integration Instructions:** How to use profile
|
||||
|
||||
Save complete profile to: {default_output_file}
|
||||
|
||||
---
|
||||
|
||||
## Success Criteria
|
||||
|
||||
✅ 3+ writing samples analyzed (1500+ words total)
|
||||
✅ Complete analysis across all 5 dimensions
|
||||
✅ Voice similarity score 75+
|
||||
✅ User validation approved
|
||||
✅ Profile document created
|
||||
✅ Quick reference generated
|
||||
✅ Ready for content generation
|
||||
|
||||
**Your voice profile is ready to ensure all AI-generated content sounds authentically like you!**
|
||||
|
|
@ -0,0 +1,334 @@
|
|||
# Voice Profile: [Profile Name]
|
||||
|
||||
**Created For:** {user_name}
|
||||
**Date Created:** {date}
|
||||
**Samples Analyzed:** [Number] samples, [Total] words
|
||||
**Profile Version:** 1.0
|
||||
|
||||
---
|
||||
|
||||
## Voice Identity
|
||||
|
||||
**Voice Summary:**
|
||||
[2-3 sentence description capturing the essence of the writing voice]
|
||||
|
||||
**Voice Type:** [e.g., "Conversational Expert", "Data-Driven Storyteller", "Professional Educator"]
|
||||
|
||||
**Best Described As:**
|
||||
- [Characteristic 1]
|
||||
- [Characteristic 2]
|
||||
- [Characteristic 3]
|
||||
|
||||
---
|
||||
|
||||
## Voice Characteristics
|
||||
|
||||
### Sentence Structure
|
||||
- **Average Length:** [X] words per sentence
|
||||
- **Length Range:** [Min]-[Max] words
|
||||
- **Variance:** [Consistent/Varied/Highly Varied]
|
||||
- **Complexity Mix:**
|
||||
- Simple: [X]%
|
||||
- Compound: [X]%
|
||||
- Complex: [X]%
|
||||
- **Rhythm:** [Choppy/Flowing/Varied/Dynamic]
|
||||
|
||||
### Vocabulary Profile
|
||||
- **Sophistication Level:** [X]/10
|
||||
- **Lexical Diversity:** [Low/Medium/High]
|
||||
- **Technical Jargon:** [Rare/Occasional/Frequent]
|
||||
- **Power Words Used:**
|
||||
- [Word 1], [Word 2], [Word 3]
|
||||
- **Signature Phrases:**
|
||||
- "[Phrase 1]"
|
||||
- "[Phrase 2]"
|
||||
|
||||
### Tone & Personality
|
||||
- **Formality Level:** [X]/10 ([Very Casual/Conversational/Professional/Formal])
|
||||
- **Personality Traits:**
|
||||
- Authoritative: [Low/Medium/High]
|
||||
- Playful: [Low/Medium/High]
|
||||
- Empathetic: [Low/Medium/High]
|
||||
- Analytical: [Low/Medium/High]
|
||||
- Confident: [Low/Medium/High]
|
||||
- **Emotional Expression:**
|
||||
- Enthusiasm: [Subdued/Moderate/High]
|
||||
- Humor: [None/Dry/Witty/Playful/Sarcastic]
|
||||
- Vulnerability: [Reserved/Selective/Open]
|
||||
|
||||
### Perspective & Voice
|
||||
- **First Person (I/we):** [X]%
|
||||
- **Second Person (you):** [X]%
|
||||
- **Third Person:** [X]%
|
||||
- **Active Voice:** [X]%
|
||||
- **Passive Voice:** [X]%
|
||||
|
||||
### Structural Patterns
|
||||
- **Paragraph Length:** [X] sentences average
|
||||
- **Opening Style:** [Description]
|
||||
- **Body Organization:** [Linear/Thematic/Narrative/Mix]
|
||||
- **Conclusion Style:** [Summary/CTA/Question/Reflection]
|
||||
- **Subheading Frequency:** Every [X] words
|
||||
- **List Preference:** [Bullets/Numbers/Both]
|
||||
|
||||
### Rhetorical Devices
|
||||
- **Storytelling:** [Rare/Occasional/Frequent]
|
||||
- **Personal Anecdotes:** [Never/Rare/Sometimes/Often]
|
||||
- **Data/Statistics:** [Rare/Occasional/Frequent]
|
||||
- **Metaphors/Analogies:** [Rare/Occasional/Frequent]
|
||||
- **Questions:** [Rare/Occasional/Frequent]
|
||||
- **Repetition for Emphasis:** [Rare/Occasional/Frequent]
|
||||
|
||||
---
|
||||
|
||||
## Style Guidelines
|
||||
|
||||
### DO: Core Voice Elements
|
||||
|
||||
**Sentence Construction:**
|
||||
1. [Guideline 1]
|
||||
2. [Guideline 2]
|
||||
3. [Guideline 3]
|
||||
|
||||
**Word Choice:**
|
||||
1. [Guideline 1]
|
||||
2. [Guideline 2]
|
||||
3. [Guideline 3]
|
||||
|
||||
**Tone Management:**
|
||||
1. [Guideline 1]
|
||||
2. [Guideline 2]
|
||||
3. [Guideline 3]
|
||||
|
||||
**Structure & Flow:**
|
||||
1. [Guideline 1]
|
||||
2. [Guideline 2]
|
||||
3. [Guideline 3]
|
||||
|
||||
### DON'T: Voice Violations
|
||||
|
||||
**Avoid:**
|
||||
- [Anti-pattern 1]
|
||||
- [Anti-pattern 2]
|
||||
- [Anti-pattern 3]
|
||||
|
||||
**Words/Phrases to Avoid:**
|
||||
- [Word/phrase 1] - Use [alternative] instead
|
||||
- [Word/phrase 2] - Use [alternative] instead
|
||||
|
||||
---
|
||||
|
||||
## Voice Examples
|
||||
|
||||
### Example 1: Blog Post Opening
|
||||
|
||||
**Generic Version:**
|
||||
[Generic text example]
|
||||
|
||||
**Your Voice:**
|
||||
[Same content in authentic voice]
|
||||
|
||||
**Voice Elements Applied:**
|
||||
- [Element 1]
|
||||
- [Element 2]
|
||||
- [Element 3]
|
||||
|
||||
---
|
||||
|
||||
### Example 2: Key Point Explanation
|
||||
|
||||
**Generic Version:**
|
||||
[Generic text example]
|
||||
|
||||
**Your Voice:**
|
||||
[Same content in authentic voice]
|
||||
|
||||
**Voice Elements Applied:**
|
||||
- [Element 1]
|
||||
- [Element 2]
|
||||
|
||||
---
|
||||
|
||||
### Example 3: Conclusion
|
||||
|
||||
**Generic Version:**
|
||||
[Generic text example]
|
||||
|
||||
**Your Voice:**
|
||||
[Same content in authentic voice]
|
||||
|
||||
**Voice Elements Applied:**
|
||||
- [Element 1]
|
||||
- [Element 2]
|
||||
|
||||
---
|
||||
|
||||
## Platform Adaptations
|
||||
|
||||
### Blog/Website
|
||||
**Voice Adjustments:**
|
||||
- [Adjustment 1]
|
||||
- [Adjustment 2]
|
||||
**Example Opening:** "[Example first paragraph]"
|
||||
|
||||
### LinkedIn
|
||||
**Voice Adjustments:**
|
||||
- [Adjustment 1]
|
||||
- [Adjustment 2]
|
||||
**Example Opening:** "[Example LinkedIn hook]"
|
||||
|
||||
### Newsletter
|
||||
**Voice Adjustments:**
|
||||
- [Adjustment 1]
|
||||
- [Adjustment 2]
|
||||
**Example Opening:** "[Example newsletter greeting]"
|
||||
|
||||
### Twitter/Social
|
||||
**Voice Adjustments:**
|
||||
- [Adjustment 1]
|
||||
- [Adjustment 2]
|
||||
**Example Post:** "[Example tweet]"
|
||||
|
||||
---
|
||||
|
||||
## Content Templates
|
||||
|
||||
### Introduction Template
|
||||
```
|
||||
[Hook pattern]
|
||||
|
||||
[Context/relevance pattern]
|
||||
|
||||
[Value proposition pattern]
|
||||
```
|
||||
|
||||
### Body Paragraph Template
|
||||
```
|
||||
[Topic sentence pattern]
|
||||
|
||||
[Supporting detail pattern]
|
||||
|
||||
[Example/data pattern]
|
||||
|
||||
[Transition pattern]
|
||||
```
|
||||
|
||||
### Conclusion Template
|
||||
```
|
||||
[Summary pattern]
|
||||
|
||||
[Key takeaway pattern]
|
||||
|
||||
[Call-to-action/closing pattern]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Voice Validation
|
||||
|
||||
**Similarity Score:** [X]/100
|
||||
|
||||
**Validation Results:**
|
||||
- ✅ Sentence structure matches
|
||||
- ✅ Vocabulary level appropriate
|
||||
- ✅ Tone consistent
|
||||
- ✅ Personality comes through
|
||||
- ✅ User approved
|
||||
|
||||
**Sample Generated Content:**
|
||||
[Paragraph generated using this profile]
|
||||
|
||||
**User Feedback:**
|
||||
- What works: [Feedback]
|
||||
- What to adjust: [Feedback]
|
||||
- Overall rating: [X]/10
|
||||
|
||||
---
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
### Activating This Profile
|
||||
|
||||
When requesting content creation:
|
||||
```
|
||||
Use my [profile-name] voice profile for this content.
|
||||
Profile: {default_output_file}
|
||||
```
|
||||
|
||||
### Profile Switching
|
||||
|
||||
To switch between profiles:
|
||||
```
|
||||
Switch to [profile-name] voice profile
|
||||
```
|
||||
|
||||
### Profile Updates
|
||||
|
||||
To update profile with new samples:
|
||||
```
|
||||
*train-voice
|
||||
Select profile: [profile-name]
|
||||
Add new samples: [paths or paste]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Maintenance
|
||||
|
||||
**Next Review Date:** [3 months from creation]
|
||||
|
||||
**Update Triggers:**
|
||||
- Significant voice evolution
|
||||
- New content types added
|
||||
- Platform expansion
|
||||
- User dissatisfaction with output
|
||||
|
||||
**Update Process:**
|
||||
1. Add new writing samples to {writing_examples}
|
||||
2. Run `*build-voice-profile` again
|
||||
3. Compare old vs new profile
|
||||
4. Merge or replace as appropriate
|
||||
|
||||
---
|
||||
|
||||
## Analysis Data
|
||||
|
||||
**Samples Analyzed:**
|
||||
1. [Sample 1 title/source] - [word count] words
|
||||
2. [Sample 2 title/source] - [word count] words
|
||||
3. [Sample 3 title/source] - [word count] words
|
||||
|
||||
**Total Analysis:**
|
||||
- Total words: [X]
|
||||
- Total sentences: [X]
|
||||
- Total paragraphs: [X]
|
||||
- Unique words: [X]
|
||||
- Type-Token Ratio: [X]
|
||||
|
||||
---
|
||||
|
||||
## Quick Reference
|
||||
|
||||
**Top 5 Voice Characteristics:**
|
||||
1. [Characteristic 1]
|
||||
2. [Characteristic 2]
|
||||
3. [Characteristic 3]
|
||||
4. [Characteristic 4]
|
||||
5. [Characteristic 5]
|
||||
|
||||
**Voice Identity in One Sentence:**
|
||||
[Single sentence capturing entire voice]
|
||||
|
||||
**Key Do's:**
|
||||
- [Do 1]
|
||||
- [Do 2]
|
||||
- [Do 3]
|
||||
|
||||
**Key Don'ts:**
|
||||
- [Don't 1]
|
||||
- [Don't 2]
|
||||
- [Don't 3]
|
||||
|
||||
---
|
||||
|
||||
**This voice profile ensures all AI-generated content authentically sounds like you across every platform and context.**
|
||||
|
|
@ -0,0 +1,19 @@
|
|||
name: "build-voice-profile"
|
||||
description: "Build a comprehensive voice profile by analyzing your writing samples and creating a detailed style guide"
|
||||
author: "Content Creator Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_output_folder: "{config_source}:content_output_folder"
|
||||
content_data_path: "{config_source}:content_data_path"
|
||||
user_name: "{config_source}:user_name"
|
||||
date: system-generated
|
||||
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/build-voice-profile"
|
||||
template: "{installed_path}/template.md"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
|
||||
writing_examples: "{content_data_path}/writing-examples.md"
|
||||
voice_profiles_folder: "{content_data_path}/voice-profiles"
|
||||
default_output_file: "{voice_profiles_folder}/voice-profile-{{profile-name}}-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,329 @@
|
|||
# Create Style Guide Workflow
|
||||
|
||||
You are a style guide expert creating comprehensive writing guidelines.
|
||||
|
||||
**User:** {user_name}
|
||||
**Voice Profiles:** {voice_profiles_folder}
|
||||
**Brand Guidelines:** {brand_guidelines}
|
||||
**Output:** {default_output_file}
|
||||
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
Create a comprehensive style guide that combines:
|
||||
- Voice profile characteristics
|
||||
- Brand guidelines
|
||||
- Platform-specific rules
|
||||
- Grammar and usage preferences
|
||||
- Formatting standards
|
||||
|
||||
This becomes the definitive reference for all content creation.
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Gather Foundation Materials
|
||||
|
||||
### 1.1 Load Voice Profile
|
||||
- Read existing voice profile
|
||||
- Extract core characteristics
|
||||
- Identify voice patterns
|
||||
- Note unique elements
|
||||
|
||||
### 1.2 Load Brand Guidelines
|
||||
- Read {brand_guidelines}
|
||||
- Extract brand voice
|
||||
- Note brand restrictions
|
||||
- Identify brand values
|
||||
|
||||
### 1.3 Interview User
|
||||
Ask about:
|
||||
- Content goals and strategy
|
||||
- Audience demographics
|
||||
- Platform priorities
|
||||
- Special requirements
|
||||
- Common challenges
|
||||
- Content types produced
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Define Core Style Principles
|
||||
|
||||
### 2.1 Voice & Tone Principles
|
||||
Based on voice profile and brand:
|
||||
- Core voice characteristics
|
||||
- Tone spectrum (formal ↔ casual)
|
||||
- When to adjust tone
|
||||
- Non-negotiables
|
||||
|
||||
### 2.2 Content Philosophy
|
||||
Define approach to:
|
||||
- Value delivery
|
||||
- Audience respect
|
||||
- Authenticity standards
|
||||
- Quality expectations
|
||||
- Research requirements
|
||||
- Accuracy standards
|
||||
|
||||
### 2.3 Brand Expression
|
||||
How brand shows up:
|
||||
- Brand personality in writing
|
||||
- Brand values expression
|
||||
- Brand differentiation
|
||||
- Consistency requirements
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Grammar & Usage Rules
|
||||
|
||||
### 3.1 Punctuation Preferences
|
||||
- Oxford comma: [Always/Never/Context]
|
||||
- Em dash vs. en dash usage
|
||||
- Ellipsis usage
|
||||
- Quotation marks (single vs. double)
|
||||
- Apostrophe in contractions
|
||||
- Hyphenation rules
|
||||
|
||||
### 3.2 Capitalization
|
||||
- Title capitalization style
|
||||
- Headers and subheaders
|
||||
- Proper nouns
|
||||
- Brand terms
|
||||
- Acronyms and abbreviations
|
||||
|
||||
### 3.3 Numbers & Symbols
|
||||
- When to spell out numbers
|
||||
- Percentage format
|
||||
- Currency display
|
||||
- Date and time format
|
||||
- Special symbols usage
|
||||
|
||||
### 3.4 Common Usage Decisions
|
||||
- Active vs. passive voice preference
|
||||
- Person (1st, 2nd, 3rd) by context
|
||||
- Singular "they" policy
|
||||
- Contractions policy
|
||||
- Sentence fragments policy
|
||||
- Serial comma in lists
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Vocabulary & Word Choice
|
||||
|
||||
### 4.1 Preferred Terms
|
||||
- Industry terminology
|
||||
- Company-specific terms
|
||||
- Product names and capitalization
|
||||
- Branded terms
|
||||
|
||||
### 4.2 Words to Use
|
||||
- Power words aligned with voice
|
||||
- Transition words preferred
|
||||
- Strong verbs list
|
||||
- Descriptive words
|
||||
|
||||
### 4.3 Words to Avoid
|
||||
- Jargon to avoid
|
||||
- Clichés and buzzwords
|
||||
- Overused phrases
|
||||
- Offensive or exclusive language
|
||||
- Competitor terminology
|
||||
|
||||
### 4.4 Inclusive Language
|
||||
- Gender-neutral alternatives
|
||||
- Accessibility terminology
|
||||
- Cultural sensitivity
|
||||
- Age-inclusive language
|
||||
- Ability-inclusive language
|
||||
|
||||
---
|
||||
|
||||
## Step 5: Structure & Formatting
|
||||
|
||||
### 5.1 Document Structure
|
||||
- Standard outline template
|
||||
- Introduction requirements
|
||||
- Body organization
|
||||
- Conclusion requirements
|
||||
- Call-to-action placement
|
||||
|
||||
### 5.2 Headers & Subheaders
|
||||
- Heading hierarchy (H1-H6)
|
||||
- Heading format and style
|
||||
- Frequency guidelines
|
||||
- Keyword integration
|
||||
|
||||
### 5.3 Paragraph Guidelines
|
||||
- Target length
|
||||
- Single idea focus
|
||||
- Opening sentence style
|
||||
- Transition requirements
|
||||
|
||||
### 5.4 Lists & Bullets
|
||||
- When to use bullets vs. numbers
|
||||
- List item capitalization
|
||||
- Punctuation in lists
|
||||
- Parallel structure requirements
|
||||
- Nesting guidelines
|
||||
|
||||
### 5.5 Emphasis & Highlighting
|
||||
- Bold usage guidelines
|
||||
- Italic usage guidelines
|
||||
- Underline policy
|
||||
- ALL CAPS policy
|
||||
- Color usage (if applicable)
|
||||
|
||||
---
|
||||
|
||||
## Step 6: Platform-Specific Guidelines
|
||||
|
||||
For each platform, define:
|
||||
|
||||
### 6.1 Blog/Website
|
||||
- Optimal length
|
||||
- SEO requirements
|
||||
- Meta description format
|
||||
- Heading structure
|
||||
- Image requirements
|
||||
- Internal linking rules
|
||||
|
||||
### 6.2 LinkedIn
|
||||
- Character limits
|
||||
- Hook requirements
|
||||
- Hashtag strategy (number, placement)
|
||||
- Emoji policy
|
||||
- Line break strategy
|
||||
- Engagement question placement
|
||||
|
||||
### 6.3 Newsletter
|
||||
- Subject line rules
|
||||
- Greeting format
|
||||
- Section structure
|
||||
- Length guidelines
|
||||
- Sign-off format
|
||||
- CTA requirements
|
||||
|
||||
### 6.4 Twitter/X
|
||||
- Thread structure
|
||||
- Tweet length
|
||||
- Hashtag usage
|
||||
- Mention strategy
|
||||
- Quote tweet policy
|
||||
|
||||
### 6.5 Other Platforms
|
||||
- [Platform-specific rules for each]
|
||||
|
||||
---
|
||||
|
||||
## Step 7: Content Types & Templates
|
||||
|
||||
### 7.1 Article/Blog Post
|
||||
- Structure template
|
||||
- Word count range
|
||||
- Required elements
|
||||
- Quality checklist
|
||||
|
||||
### 7.2 Social Media Post
|
||||
- Hook templates
|
||||
- Body structure
|
||||
- CTA templates
|
||||
- Hashtag formula
|
||||
|
||||
### 7.3 Newsletter
|
||||
- Section templates
|
||||
- Subject line formulas
|
||||
- Content blocks
|
||||
- Sign-off templates
|
||||
|
||||
### 7.4 [Other Content Types]
|
||||
- Templates for each
|
||||
|
||||
---
|
||||
|
||||
## Step 8: Quality Standards
|
||||
|
||||
### 8.1 Readability Requirements
|
||||
- Target Flesch score range
|
||||
- Grade level target
|
||||
- Sentence length limits
|
||||
- Paragraph length limits
|
||||
|
||||
### 8.2 SEO Standards
|
||||
- Keyword density targets
|
||||
- Meta requirements
|
||||
- Header optimization
|
||||
- Link requirements
|
||||
|
||||
### 8.3 Engagement Standards
|
||||
- Hook strength requirements
|
||||
- Value density expectations
|
||||
- CTA clarity requirements
|
||||
- Scannability requirements
|
||||
|
||||
### 8.4 Accuracy Standards
|
||||
- Fact-checking requirements
|
||||
- Source citation rules
|
||||
- Data freshness requirements
|
||||
- Expert validation needs
|
||||
|
||||
---
|
||||
|
||||
## Step 9: Examples & Anti-Examples
|
||||
|
||||
### 9.1 Good Examples
|
||||
For each content type:
|
||||
- Exemplar piece
|
||||
- Why it works
|
||||
- Key elements highlighted
|
||||
- Checklist of what makes it great
|
||||
|
||||
### 9.2 Bad Examples
|
||||
For each content type:
|
||||
- What not to do
|
||||
- Why it fails
|
||||
- How to fix
|
||||
- Learning points
|
||||
|
||||
### 9.3 Before/After Transformations
|
||||
- Generic → Your style
|
||||
- Multiple examples
|
||||
- Annotated with changes
|
||||
- Rationale explained
|
||||
|
||||
---
|
||||
|
||||
## Step 10: Workflow & Processes
|
||||
|
||||
### 10.1 Content Creation Process
|
||||
1. [Step 1 of process]
|
||||
2. [Step 2 of process]
|
||||
3. [etc.]
|
||||
|
||||
### 10.2 Quality Assurance
|
||||
- Review checklist
|
||||
- Approval process
|
||||
- Revision protocol
|
||||
- Final checks
|
||||
|
||||
### 10.3 Update Procedures
|
||||
- When to update guide
|
||||
- How to suggest changes
|
||||
- Approval process
|
||||
- Version control
|
||||
|
||||
---
|
||||
|
||||
## Output
|
||||
|
||||
Comprehensive style guide using {template} including:
|
||||
- Executive summary
|
||||
- Core principles
|
||||
- Detailed guidelines
|
||||
- Platform-specific rules
|
||||
- Templates and examples
|
||||
- Quality standards
|
||||
- Quick reference card
|
||||
|
||||
Save to: {default_output_file}
|
||||
|
||||
**Your complete style guide ensuring consistent, high-quality content across all platforms!**
|
||||
|
|
@ -0,0 +1,18 @@
|
|||
name: "create-style-guide"
|
||||
description: "Create a comprehensive custom style guide for consistent content creation across all platforms"
|
||||
author: "Content Creator Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/content-creator/config.yaml"
|
||||
content_data_path: "{config_source}:content_data_path"
|
||||
user_name: "{config_source}:user_name"
|
||||
date: system-generated
|
||||
|
||||
installed_path: "{project-root}/{bmad_folder}/content-creator/workflows/create-style-guide"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
template: "{installed_path}/template.md"
|
||||
|
||||
voice_profiles_folder: "{content_data_path}/voice-profiles"
|
||||
brand_guidelines: "{content_data_path}/brand-guidelines.md"
|
||||
default_output_file: "{content_data_path}/style-guides/style-guide-{{style-name}}-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -1,13 +1,13 @@
|
|||
name: "extract-themes"
|
||||
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"
|
||||
user_name: "{config_source}:user_name"
|
||||
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"
|
||||
template: "{installed_path}/template.md"
|
||||
|
||||
|
|
@ -1,17 +1,17 @@
|
|||
name: "optimize-content"
|
||||
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"
|
||||
readability_target: "{config_source}:readability_target_grade"
|
||||
enable_seo: "{config_source}:enable_seo_optimization"
|
||||
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"
|
||||
|
||||
seo_keywords: "{project-root}/{bmad_folder}/claudecode-writer/data/seo-keywords.md"
|
||||
writing_examples: "{project-root}/{bmad_folder}/claudecode-writer/data/writing-examples.md"
|
||||
seo_keywords: "{project-root}/{bmad_folder}/content-creator/data/seo-keywords.md"
|
||||
writing_examples: "{project-root}/{bmad_folder}/content-creator/data/writing-examples.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -1,17 +1,17 @@
|
|||
name: "quick-post"
|
||||
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"
|
||||
user_name: "{config_source}:user_name"
|
||||
writing_style: "{config_source}:default_writing_style"
|
||||
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"
|
||||
|
||||
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"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -1,17 +1,17 @@
|
|||
name: "research-topic"
|
||||
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"
|
||||
user_name: "{config_source}:user_name"
|
||||
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"
|
||||
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"
|
||||
|
||||
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