diff --git a/src/modules/claudecode-writer/README.md b/src/modules/content-creator/README.md similarity index 77% rename from src/modules/claudecode-writer/README.md rename to src/modules/content-creator/README.md index 27a73b85..042204f3 100644 --- a/src/modules/claudecode-writer/README.md +++ b/src/modules/content-creator/README.md @@ -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 diff --git a/src/modules/claudecode-writer/_module-installer/install-config.yaml b/src/modules/content-creator/_module-installer/install-config.yaml similarity index 92% rename from src/modules/claudecode-writer/_module-installer/install-config.yaml rename to src/modules/content-creator/_module-installer/install-config.yaml index ea4d2774..c628870d 100644 --- a/src/modules/claudecode-writer/_module-installer/install-config.yaml +++ b/src/modules/content-creator/_module-installer/install-config.yaml @@ -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" diff --git a/src/modules/claudecode-writer/agents/content-analyzer.agent.yaml b/src/modules/content-creator/agents/content-analyzer.agent.yaml similarity index 78% rename from src/modules/claudecode-writer/agents/content-analyzer.agent.yaml rename to src/modules/content-creator/agents/content-analyzer.agent.yaml index 38be29b2..688ce73c 100644 --- a/src/modules/claudecode-writer/agents/content-analyzer.agent.yaml +++ b/src/modules/content-creator/agents/content-analyzer.agent.yaml @@ -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 diff --git a/src/modules/claudecode-writer/agents/content-writer.agent.yaml b/src/modules/content-creator/agents/content-writer.agent.yaml similarity index 57% rename from src/modules/claudecode-writer/agents/content-writer.agent.yaml rename to src/modules/content-creator/agents/content-writer.agent.yaml index 8f9d7cb2..41c14711 100644 --- a/src/modules/claudecode-writer/agents/content-writer.agent.yaml +++ b/src/modules/content-creator/agents/content-writer.agent.yaml @@ -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 diff --git a/src/modules/claudecode-writer/agents/conversational-repurposer.agent.yaml b/src/modules/content-creator/agents/conversational-repurposer.agent.yaml similarity index 77% rename from src/modules/claudecode-writer/agents/conversational-repurposer.agent.yaml rename to src/modules/content-creator/agents/conversational-repurposer.agent.yaml index 54115030..65adf429 100644 --- a/src/modules/claudecode-writer/agents/conversational-repurposer.agent.yaml +++ b/src/modules/content-creator/agents/conversational-repurposer.agent.yaml @@ -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 diff --git a/src/modules/claudecode-writer/agents/linkedin-repurposer.agent.yaml b/src/modules/content-creator/agents/linkedin-repurposer.agent.yaml similarity index 80% rename from src/modules/claudecode-writer/agents/linkedin-repurposer.agent.yaml rename to src/modules/content-creator/agents/linkedin-repurposer.agent.yaml index f6b04cd6..319183bd 100644 --- a/src/modules/claudecode-writer/agents/linkedin-repurposer.agent.yaml +++ b/src/modules/content-creator/agents/linkedin-repurposer.agent.yaml @@ -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 diff --git a/src/modules/claudecode-writer/agents/newsletter-repurposer.agent.yaml b/src/modules/content-creator/agents/newsletter-repurposer.agent.yaml similarity index 79% rename from src/modules/claudecode-writer/agents/newsletter-repurposer.agent.yaml rename to src/modules/content-creator/agents/newsletter-repurposer.agent.yaml index bda828a5..029c9adb 100644 --- a/src/modules/claudecode-writer/agents/newsletter-repurposer.agent.yaml +++ b/src/modules/content-creator/agents/newsletter-repurposer.agent.yaml @@ -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 diff --git a/src/modules/claudecode-writer/agents/research-aggregator.agent.yaml b/src/modules/content-creator/agents/research-aggregator.agent.yaml similarity index 76% rename from src/modules/claudecode-writer/agents/research-aggregator.agent.yaml rename to src/modules/content-creator/agents/research-aggregator.agent.yaml index 12652047..85cf506b 100644 --- a/src/modules/claudecode-writer/agents/research-aggregator.agent.yaml +++ b/src/modules/content-creator/agents/research-aggregator.agent.yaml @@ -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 diff --git a/src/modules/claudecode-writer/agents/seo-optimizer.agent.yaml b/src/modules/content-creator/agents/seo-optimizer.agent.yaml similarity index 77% rename from src/modules/claudecode-writer/agents/seo-optimizer.agent.yaml rename to src/modules/content-creator/agents/seo-optimizer.agent.yaml index 243196a2..c11967cb 100644 --- a/src/modules/claudecode-writer/agents/seo-optimizer.agent.yaml +++ b/src/modules/content-creator/agents/seo-optimizer.agent.yaml @@ -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 diff --git a/src/modules/claudecode-writer/agents/voice-matcher.agent.yaml b/src/modules/content-creator/agents/voice-matcher.agent.yaml similarity index 58% rename from src/modules/claudecode-writer/agents/voice-matcher.agent.yaml rename to src/modules/content-creator/agents/voice-matcher.agent.yaml index 0e6b3de3..fa9b6e92 100644 --- a/src/modules/claudecode-writer/agents/voice-matcher.agent.yaml +++ b/src/modules/content-creator/agents/voice-matcher.agent.yaml @@ -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" diff --git a/src/modules/claudecode-writer/data/brand-guidelines.md b/src/modules/content-creator/data/brand-guidelines.md similarity index 100% rename from src/modules/claudecode-writer/data/brand-guidelines.md rename to src/modules/content-creator/data/brand-guidelines.md diff --git a/src/modules/claudecode-writer/data/research-sources.md b/src/modules/content-creator/data/research-sources.md similarity index 100% rename from src/modules/claudecode-writer/data/research-sources.md rename to src/modules/content-creator/data/research-sources.md diff --git a/src/modules/claudecode-writer/data/seo-keywords.md b/src/modules/content-creator/data/seo-keywords.md similarity index 100% rename from src/modules/claudecode-writer/data/seo-keywords.md rename to src/modules/content-creator/data/seo-keywords.md diff --git a/src/modules/content-creator/data/style-guides/README.md b/src/modules/content-creator/data/style-guides/README.md new file mode 100644 index 00000000..a5c3c4ff --- /dev/null +++ b/src/modules/content-creator/data/style-guides/README.md @@ -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.** diff --git a/src/modules/content-creator/data/voice-profiles/.gitkeep b/src/modules/content-creator/data/voice-profiles/.gitkeep new file mode 100644 index 00000000..0ad267d9 --- /dev/null +++ b/src/modules/content-creator/data/voice-profiles/.gitkeep @@ -0,0 +1 @@ +# This directory will contain your generated voice profiles diff --git a/src/modules/content-creator/data/voice-profiles/README.md b/src/modules/content-creator/data/voice-profiles/README.md new file mode 100644 index 00000000..39d30f97 --- /dev/null +++ b/src/modules/content-creator/data/voice-profiles/README.md @@ -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.** diff --git a/src/modules/claudecode-writer/data/writing-examples.md b/src/modules/content-creator/data/writing-examples.md similarity index 100% rename from src/modules/claudecode-writer/data/writing-examples.md rename to src/modules/content-creator/data/writing-examples.md diff --git a/src/modules/claudecode-writer/tasks/content-analysis.xml b/src/modules/content-creator/tasks/content-analysis.xml similarity index 97% rename from src/modules/claudecode-writer/tasks/content-analysis.xml rename to src/modules/content-creator/tasks/content-analysis.xml index 81890ea6..963a116a 100644 --- a/src/modules/claudecode-writer/tasks/content-analysis.xml +++ b/src/modules/content-creator/tasks/content-analysis.xml @@ -1,9 +1,9 @@ - {bmad_folder}/claudecode-writer/tasks/content-analysis.xml + {bmad_folder}/content-creator/tasks/content-analysis.xml Content Analysis Comprehensive content analysis across 5 dimensions: readability, SEO, structure, engagement, and technical quality - claudecode-writer + content-creator diff --git a/src/modules/claudecode-writer/tasks/linkedin-repurpose.xml b/src/modules/content-creator/tasks/linkedin-repurpose.xml similarity index 94% rename from src/modules/claudecode-writer/tasks/linkedin-repurpose.xml rename to src/modules/content-creator/tasks/linkedin-repurpose.xml index b4756a0d..d4ea9051 100644 --- a/src/modules/claudecode-writer/tasks/linkedin-repurpose.xml +++ b/src/modules/content-creator/tasks/linkedin-repurpose.xml @@ -1,9 +1,9 @@ - {bmad_folder}/claudecode-writer/tasks/linkedin-repurpose.xml + {bmad_folder}/content-creator/tasks/linkedin-repurpose.xml LinkedIn Repurpose Transform content for LinkedIn professional audience - claudecode-writer + content-creator diff --git a/src/modules/claudecode-writer/tasks/quality-check.xml b/src/modules/content-creator/tasks/quality-check.xml similarity index 96% rename from src/modules/claudecode-writer/tasks/quality-check.xml rename to src/modules/content-creator/tasks/quality-check.xml index 41d5f58c..9f3c1991 100644 --- a/src/modules/claudecode-writer/tasks/quality-check.xml +++ b/src/modules/content-creator/tasks/quality-check.xml @@ -1,9 +1,9 @@ - {bmad_folder}/claudecode-writer/tasks/quality-check.xml + {bmad_folder}/content-creator/tasks/quality-check.xml Quality Check Comprehensive quality check on content before saving or publishing - claudecode-writer + content-creator diff --git a/src/modules/claudecode-writer/tasks/seo-optimize.xml b/src/modules/content-creator/tasks/seo-optimize.xml similarity index 94% rename from src/modules/claudecode-writer/tasks/seo-optimize.xml rename to src/modules/content-creator/tasks/seo-optimize.xml index 2d4a1ecd..f3a1a4ad 100644 --- a/src/modules/claudecode-writer/tasks/seo-optimize.xml +++ b/src/modules/content-creator/tasks/seo-optimize.xml @@ -1,9 +1,9 @@ - {bmad_folder}/claudecode-writer/tasks/seo-optimize.xml + {bmad_folder}/content-creator/tasks/seo-optimize.xml SEO Optimization Comprehensive SEO optimization for content discoverability - claudecode-writer + content-creator diff --git a/src/modules/content-creator/tasks/style-analyzer.xml b/src/modules/content-creator/tasks/style-analyzer.xml new file mode 100644 index 00000000..f3cc9a6c --- /dev/null +++ b/src/modules/content-creator/tasks/style-analyzer.xml @@ -0,0 +1,267 @@ + + + {bmad_folder}/content-creator/tasks/style-analyzer.xml + Style Analyzer + Deep analysis of writing style patterns, characteristics, and unique voice markers + content-creator + + + + + + diff --git a/src/modules/claudecode-writer/tasks/voice-check.xml b/src/modules/content-creator/tasks/voice-check.xml similarity index 93% rename from src/modules/claudecode-writer/tasks/voice-check.xml rename to src/modules/content-creator/tasks/voice-check.xml index dd41a6b4..fade5e74 100644 --- a/src/modules/claudecode-writer/tasks/voice-check.xml +++ b/src/modules/content-creator/tasks/voice-check.xml @@ -1,9 +1,9 @@ - {bmad_folder}/claudecode-writer/tasks/voice-check.xml + {bmad_folder}/content-creator/tasks/voice-check.xml Voice Consistency Check Verify content matches authentic voice and brand guidelines - claudecode-writer + content-creator diff --git a/src/modules/claudecode-writer/workflows/article-pipeline/checklist.md b/src/modules/content-creator/workflows/article-pipeline/checklist.md similarity index 100% rename from src/modules/claudecode-writer/workflows/article-pipeline/checklist.md rename to src/modules/content-creator/workflows/article-pipeline/checklist.md diff --git a/src/modules/claudecode-writer/workflows/article-pipeline/instructions.md b/src/modules/content-creator/workflows/article-pipeline/instructions.md similarity index 100% rename from src/modules/claudecode-writer/workflows/article-pipeline/instructions.md rename to src/modules/content-creator/workflows/article-pipeline/instructions.md diff --git a/src/modules/claudecode-writer/workflows/article-pipeline/template.md b/src/modules/content-creator/workflows/article-pipeline/template.md similarity index 100% rename from src/modules/claudecode-writer/workflows/article-pipeline/template.md rename to src/modules/content-creator/workflows/article-pipeline/template.md diff --git a/src/modules/claudecode-writer/workflows/article-pipeline/workflow.yaml b/src/modules/content-creator/workflows/article-pipeline/workflow.yaml similarity index 57% rename from src/modules/claudecode-writer/workflows/article-pipeline/workflow.yaml rename to src/modules/content-creator/workflows/article-pipeline/workflow.yaml index 2300703a..cc8100c6 100644 --- a/src/modules/claudecode-writer/workflows/article-pipeline/workflow.yaml +++ b/src/modules/content-creator/workflows/article-pipeline/workflow.yaml @@ -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" diff --git a/src/modules/content-creator/workflows/build-voice-profile/instructions.md b/src/modules/content-creator/workflows/build-voice-profile/instructions.md new file mode 100644 index 00000000..a07b8334 --- /dev/null +++ b/src/modules/content-creator/workflows/build-voice-profile/instructions.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!** diff --git a/src/modules/content-creator/workflows/build-voice-profile/template.md b/src/modules/content-creator/workflows/build-voice-profile/template.md new file mode 100644 index 00000000..408302b7 --- /dev/null +++ b/src/modules/content-creator/workflows/build-voice-profile/template.md @@ -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.** diff --git a/src/modules/content-creator/workflows/build-voice-profile/workflow.yaml b/src/modules/content-creator/workflows/build-voice-profile/workflow.yaml new file mode 100644 index 00000000..2b010823 --- /dev/null +++ b/src/modules/content-creator/workflows/build-voice-profile/workflow.yaml @@ -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 diff --git a/src/modules/content-creator/workflows/create-style-guide/instructions.md b/src/modules/content-creator/workflows/create-style-guide/instructions.md new file mode 100644 index 00000000..1ef1597a --- /dev/null +++ b/src/modules/content-creator/workflows/create-style-guide/instructions.md @@ -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!** diff --git a/src/modules/content-creator/workflows/create-style-guide/workflow.yaml b/src/modules/content-creator/workflows/create-style-guide/workflow.yaml new file mode 100644 index 00000000..e426ae1e --- /dev/null +++ b/src/modules/content-creator/workflows/create-style-guide/workflow.yaml @@ -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 diff --git a/src/modules/claudecode-writer/workflows/extract-themes/instructions.md b/src/modules/content-creator/workflows/extract-themes/instructions.md similarity index 100% rename from src/modules/claudecode-writer/workflows/extract-themes/instructions.md rename to src/modules/content-creator/workflows/extract-themes/instructions.md diff --git a/src/modules/claudecode-writer/workflows/extract-themes/template.md b/src/modules/content-creator/workflows/extract-themes/template.md similarity index 100% rename from src/modules/claudecode-writer/workflows/extract-themes/template.md rename to src/modules/content-creator/workflows/extract-themes/template.md diff --git a/src/modules/claudecode-writer/workflows/extract-themes/workflow.yaml b/src/modules/content-creator/workflows/extract-themes/workflow.yaml similarity index 70% rename from src/modules/claudecode-writer/workflows/extract-themes/workflow.yaml rename to src/modules/content-creator/workflows/extract-themes/workflow.yaml index 4cd0f94b..5f650a4f 100644 --- a/src/modules/claudecode-writer/workflows/extract-themes/workflow.yaml +++ b/src/modules/content-creator/workflows/extract-themes/workflow.yaml @@ -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" diff --git a/src/modules/claudecode-writer/workflows/optimize-content/instructions.md b/src/modules/content-creator/workflows/optimize-content/instructions.md similarity index 100% rename from src/modules/claudecode-writer/workflows/optimize-content/instructions.md rename to src/modules/content-creator/workflows/optimize-content/instructions.md diff --git a/src/modules/claudecode-writer/workflows/optimize-content/workflow.yaml b/src/modules/content-creator/workflows/optimize-content/workflow.yaml similarity index 51% rename from src/modules/claudecode-writer/workflows/optimize-content/workflow.yaml rename to src/modules/content-creator/workflows/optimize-content/workflow.yaml index 476bc9a1..e1ce82ba 100644 --- a/src/modules/claudecode-writer/workflows/optimize-content/workflow.yaml +++ b/src/modules/content-creator/workflows/optimize-content/workflow.yaml @@ -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 diff --git a/src/modules/claudecode-writer/workflows/quick-post/instructions.md b/src/modules/content-creator/workflows/quick-post/instructions.md similarity index 100% rename from src/modules/claudecode-writer/workflows/quick-post/instructions.md rename to src/modules/content-creator/workflows/quick-post/instructions.md diff --git a/src/modules/claudecode-writer/workflows/quick-post/workflow.yaml b/src/modules/content-creator/workflows/quick-post/workflow.yaml similarity index 60% rename from src/modules/claudecode-writer/workflows/quick-post/workflow.yaml rename to src/modules/content-creator/workflows/quick-post/workflow.yaml index 42ae0b86..bc935601 100644 --- a/src/modules/claudecode-writer/workflows/quick-post/workflow.yaml +++ b/src/modules/content-creator/workflows/quick-post/workflow.yaml @@ -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 diff --git a/src/modules/claudecode-writer/workflows/research-topic/instructions.md b/src/modules/content-creator/workflows/research-topic/instructions.md similarity index 100% rename from src/modules/claudecode-writer/workflows/research-topic/instructions.md rename to src/modules/content-creator/workflows/research-topic/instructions.md diff --git a/src/modules/claudecode-writer/workflows/research-topic/template.md b/src/modules/content-creator/workflows/research-topic/template.md similarity index 100% rename from src/modules/claudecode-writer/workflows/research-topic/template.md rename to src/modules/content-creator/workflows/research-topic/template.md diff --git a/src/modules/claudecode-writer/workflows/research-topic/workflow.yaml b/src/modules/content-creator/workflows/research-topic/workflow.yaml similarity index 62% rename from src/modules/claudecode-writer/workflows/research-topic/workflow.yaml rename to src/modules/content-creator/workflows/research-topic/workflow.yaml index e12bc0de..e204a6d0 100644 --- a/src/modules/claudecode-writer/workflows/research-topic/workflow.yaml +++ b/src/modules/content-creator/workflows/research-topic/workflow.yaml @@ -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 diff --git a/src/modules/content-creator/workflows/train-voice/instructions.md b/src/modules/content-creator/workflows/train-voice/instructions.md new file mode 100644 index 00000000..4e50bce1 --- /dev/null +++ b/src/modules/content-creator/workflows/train-voice/instructions.md @@ -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 diff --git a/src/modules/content-creator/workflows/train-voice/workflow.yaml b/src/modules/content-creator/workflows/train-voice/workflow.yaml new file mode 100644 index 00000000..d752273c --- /dev/null +++ b/src/modules/content-creator/workflows/train-voice/workflow.yaml @@ -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