feat: add ClaudeCode Writer module - complete plugin to BMAD conversion
Add comprehensive ClaudeCode Writer module converted from external plugin
to BMAD v6 architecture with full feature parity and enhancements.
Module Components:
- 8 specialized agents (content-writer, content-analyzer, research-aggregator,
voice-matcher, linkedin-repurposer, newsletter-repurposer,
conversational-repurposer, seo-optimizer)
- 5 core workflows (article-pipeline, research-topic, extract-themes,
quick-post, optimize-content)
- 5 quality tasks (quality-check, content-analysis, seo-optimize,
voice-check, linkedin-repurpose)
- 4 data reference files (writing-examples, research-sources,
seo-keywords, brand-guidelines)
- Complete installation configuration with interactive prompts
- Comprehensive documentation
Features:
- Multi-platform content creation (Blog, LinkedIn, Newsletter, Twitter)
- Voice learning and consistency checking
- Automated research with priority source integration
- SEO optimization and analysis
- Quality assurance with configurable thresholds
- Complete article pipeline from research to publication
Conversion Pattern:
- Skills → Agents (content-analyzer, research-aggregator, etc.)
- Commands → Agent menu triggers
- Hooks → Tasks (quality-check, post-write)
- Workflows → BMAD workflow structure
- Config → install-config.yaml with prompts
All components follow BMAD v6 conventions:
- Agents use .agent.yaml format with metadata, persona, menu
- Workflows use workflow.yaml + instructions.md + template.md
- Tasks use XML format with metadata and instructions
- Path placeholders use {project-root}/{bmad_folder}/
- Configuration inherits from core installer
This commit is contained in:
Claude
parent
a6f089cfd2
commit
da1ee37a09
|
|
@ -0,0 +1,419 @@
|
|||
# ClaudeCode Writer 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.
|
||||
|
||||
## 🎯 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
|
||||
|
||||
## ✨ Key Features
|
||||
|
||||
### 8 Specialized Agents
|
||||
|
||||
1. **Casey - Content Writer** - Your main content creation orchestrator
|
||||
2. **Alex - Content Analyzer** - Quality and SEO analysis expert
|
||||
3. **Riley - Research Aggregator** - Research and trend analysis specialist
|
||||
4. **Vicki - Voice Matcher** - Voice consistency and brand alignment guardian
|
||||
5. **Lauren - LinkedIn Repurposer** - Professional networking content expert
|
||||
6. **Nina - Newsletter Repurposer** - Email content and subscriber engagement specialist
|
||||
7. **Charlie - Conversational Repurposer** - Social media and conversational content expert
|
||||
8. **Sam - SEO Optimizer** - Search engine optimization specialist
|
||||
|
||||
### 5 Core Workflows
|
||||
|
||||
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
|
||||
|
||||
### 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
|
||||
- **Research Intelligence** - Priority source checking and trend surfacing
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
### 1. Install the Module
|
||||
|
||||
```bash
|
||||
npx bmad-method@alpha install
|
||||
```
|
||||
|
||||
Select "ClaudeCode Writer" during module selection.
|
||||
|
||||
### 2. Configure Your Settings
|
||||
|
||||
During installation, you'll configure:
|
||||
- Content output folder
|
||||
- Default writing style
|
||||
- Target platforms (Blog, LinkedIn, Newsletter, Twitter, etc.)
|
||||
- SEO optimization preferences
|
||||
- Readability targets
|
||||
- Quality control settings
|
||||
|
||||
### 3. Setup Your Voice Profile
|
||||
|
||||
After installation, update these files in `.bmad/claudecode-writer/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
|
||||
|
||||
Load the Content Writer agent and try these commands:
|
||||
|
||||
```
|
||||
*write # Complete article pipeline
|
||||
*research # Deep research on a topic
|
||||
*extract-themes # Analyze raw notes for patterns
|
||||
*quick-post # Fast social media content
|
||||
*optimize # Improve existing content
|
||||
```
|
||||
|
||||
## 📖 Usage Examples
|
||||
|
||||
### Example 1: Complete Article Pipeline
|
||||
|
||||
```
|
||||
*write
|
||||
|
||||
Topic: "The Future of Remote Work"
|
||||
Target keyword: "remote work trends 2025"
|
||||
Audience: Business leaders
|
||||
Goal: Educate and inform
|
||||
```
|
||||
|
||||
**Result:** Creates:
|
||||
- Main article (1200-1500 words)
|
||||
- LinkedIn professional post
|
||||
- Newsletter version with subject lines
|
||||
- Twitter thread (5-8 tweets)
|
||||
- Research brief
|
||||
- Quality and SEO reports
|
||||
|
||||
### Example 2: Research Topic
|
||||
|
||||
```
|
||||
*research
|
||||
|
||||
Topic: "AI in Content Creation"
|
||||
```
|
||||
|
||||
**Result:** Research brief with:
|
||||
- 5-7 key insights with sources
|
||||
- 3-5 current data points
|
||||
- 2-3 unique angles
|
||||
- Emerging trends
|
||||
- Content recommendations
|
||||
|
||||
### Example 3: Extract Themes from Notes
|
||||
|
||||
```
|
||||
*extract-themes
|
||||
```
|
||||
|
||||
**Result:** Theme analysis report:
|
||||
- Major themes identified from your raw notes
|
||||
- Content opportunities ranked by potential
|
||||
- Recommended article topics
|
||||
- Series ideas
|
||||
|
||||
### Example 4: Quick Social Post
|
||||
|
||||
```
|
||||
*quick-post
|
||||
|
||||
Platform: LinkedIn
|
||||
Topic: Quick insight about AI productivity
|
||||
Style: Professional but personal
|
||||
```
|
||||
|
||||
**Result:** Optimized LinkedIn post ready to publish
|
||||
|
||||
## 🎨 Customization
|
||||
|
||||
### Voice Profile
|
||||
|
||||
Update `data/writing-examples.md` with your writing samples. The AI will analyze:
|
||||
- Sentence structure patterns
|
||||
- Vocabulary level
|
||||
- Use of humor and metaphors
|
||||
- Formality level
|
||||
- Rhetorical devices
|
||||
|
||||
### Research Sources
|
||||
|
||||
Customize `data/research-sources.md` with your trusted sources:
|
||||
- Industry publications
|
||||
- Expert thought leaders
|
||||
- Data sources
|
||||
- Academic journals
|
||||
|
||||
### SEO Keywords
|
||||
|
||||
Define target keywords in `data/seo-keywords.md`:
|
||||
- Primary keywords by topic
|
||||
- Long-tail variations
|
||||
- Semantic keywords
|
||||
- Competitor keywords
|
||||
|
||||
### Brand Guidelines
|
||||
|
||||
Set brand standards in `data/brand-guidelines.md`:
|
||||
- Brand voice and tone
|
||||
- Writing style preferences
|
||||
- Language guidelines
|
||||
- Platform-specific guidelines
|
||||
|
||||
## 🔧 Agent Reference
|
||||
|
||||
### Casey - Content Writer
|
||||
|
||||
**Main orchestrator for content creation**
|
||||
|
||||
Commands:
|
||||
- `*write` - Complete article pipeline
|
||||
- `*research` - Deep topic research
|
||||
- `*extract-themes` - Analyze raw notes
|
||||
- `*quick-post` - Fast social content
|
||||
- `*optimize` - Improve existing content
|
||||
- `*analyze` - Content analysis
|
||||
- `*quality-check` - Quality validation
|
||||
|
||||
### Alex - Content Analyzer
|
||||
|
||||
**Quality and SEO expert**
|
||||
|
||||
Commands:
|
||||
- `*analyze` - Comprehensive 5-dimension analysis
|
||||
- `*seo-check` - Deep SEO analysis
|
||||
- `*readability` - Readability assessment
|
||||
- `*quick-check` - Fast quality check
|
||||
|
||||
### Riley - Research Aggregator
|
||||
|
||||
**Research and trends**
|
||||
|
||||
Commands:
|
||||
- `*research` - Deep research workflow
|
||||
- `*extract-themes` - Pattern extraction
|
||||
- `*quick-research` - Fast research brief
|
||||
- `*trend-analysis` - Trend identification
|
||||
|
||||
### Vicki - Voice Matcher
|
||||
|
||||
**Voice consistency guardian**
|
||||
|
||||
Commands:
|
||||
- `*check-voice` - Voice consistency check
|
||||
- `*analyze-style` - Style pattern analysis
|
||||
- `*optimize-voice` - Voice optimization
|
||||
- `*update-profile` - Update voice profile
|
||||
|
||||
### Lauren - LinkedIn Repurposer
|
||||
|
||||
**Professional content expert**
|
||||
|
||||
Commands:
|
||||
- `*repurpose-linkedin` - Transform to LinkedIn
|
||||
- `*linkedin-post` - Create LinkedIn post
|
||||
- `*optimize-linkedin` - Optimize for engagement
|
||||
|
||||
### Nina - Newsletter Repurposer
|
||||
|
||||
**Email content specialist**
|
||||
|
||||
Commands:
|
||||
- `*repurpose-newsletter` - Transform to newsletter
|
||||
- `*newsletter-create` - Create newsletter issue
|
||||
- `*subject-lines` - Generate subject lines
|
||||
|
||||
### Charlie - Conversational Repurposer
|
||||
|
||||
**Social media expert**
|
||||
|
||||
Commands:
|
||||
- `*repurpose-social` - Transform to social
|
||||
- `*twitter-thread` - Create Twitter thread
|
||||
- `*podcast-script` - Create podcast segment
|
||||
- `*social-post` - Create social post
|
||||
|
||||
### Sam - SEO Optimizer
|
||||
|
||||
**Search optimization**
|
||||
|
||||
Commands:
|
||||
- `*optimize-seo` - Full SEO optimization
|
||||
- `*keyword-research` - Keyword suggestions
|
||||
- `*meta-optimize` - Meta tag optimization
|
||||
- `*seo-audit` - Comprehensive audit
|
||||
|
||||
## 📊 Workflow Details
|
||||
|
||||
### Article Pipeline Workflow
|
||||
|
||||
**Duration:** 10-15 minutes
|
||||
|
||||
**Steps:**
|
||||
1. Research & Topic Development
|
||||
2. Article Outline Creation
|
||||
3. Article Drafting with Voice Matching
|
||||
4. SEO Optimization (if enabled)
|
||||
5. Quality Validation (must score ≥70)
|
||||
6. Multi-Platform Repurposing
|
||||
7. Publishing Preparation
|
||||
8. Workflow Summary
|
||||
|
||||
**Outputs:**
|
||||
- Main article
|
||||
- LinkedIn version
|
||||
- Newsletter version
|
||||
- Social media versions
|
||||
- Research brief
|
||||
- Quality report
|
||||
- SEO report
|
||||
|
||||
### Research Topic Workflow
|
||||
|
||||
**Duration:** 5-10 minutes
|
||||
|
||||
**Process:**
|
||||
- Topic definition and scope
|
||||
- Priority source checking
|
||||
- Trend analysis
|
||||
- Data gathering
|
||||
- Unique angle discovery
|
||||
- Research brief synthesis
|
||||
|
||||
**Output:** Comprehensive research brief ready for writing
|
||||
|
||||
### Extract Themes Workflow
|
||||
|
||||
**Duration:** 5-10 minutes
|
||||
|
||||
**Process:**
|
||||
- Gather raw notes
|
||||
- Pattern recognition
|
||||
- Theme categorization
|
||||
- Unique angle discovery
|
||||
- Content opportunity identification
|
||||
|
||||
**Output:** Theme analysis with prioritized content opportunities
|
||||
|
||||
## 📁 File Organization
|
||||
|
||||
Content is organized in your output folder:
|
||||
|
||||
```
|
||||
{content_output_folder}/
|
||||
├── drafts/ # Work-in-progress content
|
||||
│ ├── article-*.md
|
||||
│ ├── linkedin-*.md
|
||||
│ ├── newsletter-*.md
|
||||
│ └── social-*.md
|
||||
├── published/ # Published content archive
|
||||
├── research/ # Research briefs and reports
|
||||
│ ├── research-*.md
|
||||
│ ├── themes-*.md
|
||||
│ ├── quality-*.md
|
||||
│ └── seo-*.md
|
||||
├── rawnotes/ # Unstructured ideas and notes
|
||||
└── archive/ # Archived content (30+ days)
|
||||
```
|
||||
|
||||
## 🎯 Best Practices
|
||||
|
||||
### Voice Profile Setup
|
||||
|
||||
1. **Use Real Writing Samples** - 3-5 pieces of content you've actually written
|
||||
2. **Show Range** - Include different formats (blog, social, newsletter)
|
||||
3. **Recent Content** - Use recent samples that represent your current voice
|
||||
4. **Sufficient Length** - Each sample should be 200-300+ words
|
||||
|
||||
### Research Sources
|
||||
|
||||
1. **Prioritize Your List** - Put most trusted sources at the top
|
||||
2. **Keep Updated** - Review and update quarterly
|
||||
3. **Be Specific** - Note why each source is valuable
|
||||
4. **Include Variety** - Mix news, data, thought leaders, and academic sources
|
||||
|
||||
### Content Creation
|
||||
|
||||
1. **Start with Research** - Use `*research` before `*write` for best results
|
||||
2. **Review Voice Examples** - AI will match your voice better with quality examples
|
||||
3. **Iterate on Quality** - If quality score is low, revise and re-check
|
||||
4. **Platform-Specific Edits** - Review each platform version before publishing
|
||||
|
||||
### Quality Control
|
||||
|
||||
1. **Set Realistic Targets** - 70+ quality score is good, 80+ is excellent
|
||||
2. **Use Strict Mode Carefully** - Only enable if you want blocks on low quality
|
||||
3. **Check Voice Regularly** - Update writing examples as your voice evolves
|
||||
4. **Monitor SEO** - Track which keywords drive traffic
|
||||
|
||||
## 🔄 Integration with Other Modules
|
||||
|
||||
### Works Great With:
|
||||
|
||||
- **BMM (BMad Method)** - Use for product research and documentation
|
||||
- **BMB (BMad Builder)** - Create custom content workflows
|
||||
- **CIS (Creative Intelligence Suite)** - Brainstorming and ideation
|
||||
|
||||
## 📚 Additional Resources
|
||||
|
||||
- [BMAD Method Documentation](../../bmm/README.md)
|
||||
- [Agent Customization Guide](../../../docs/agent-customization-guide.md)
|
||||
- [Workflow Creation Guide](../bmb/workflows/create-workflow/README.md)
|
||||
|
||||
## 🆘 Troubleshooting
|
||||
|
||||
### AI Not Matching My Voice
|
||||
|
||||
**Solution:** Update `data/writing-examples.md` with more samples (aim for 5+) and ensure they're recent and representative.
|
||||
|
||||
### Quality Scores Too Low
|
||||
|
||||
**Solution:**
|
||||
- Check readability target matches your audience
|
||||
- Ensure content has clear structure
|
||||
- Add more examples and data
|
||||
- Review against checklist
|
||||
|
||||
### SEO Not Working
|
||||
|
||||
**Solution:**
|
||||
- Verify `enable_seo_optimization: yes` in config
|
||||
- Update `data/seo-keywords.md` with target keywords
|
||||
- Check keyword density (target: 0.5-2.5%)
|
||||
|
||||
### Platform Versions Feel Off
|
||||
|
||||
**Solution:**
|
||||
- Review writing examples for platform-specific content
|
||||
- Check brand guidelines for platform-specific instructions
|
||||
- Manually refine and provide feedback
|
||||
|
||||
## 📄 License
|
||||
|
||||
Part of the BMAD Method - MIT License
|
||||
|
||||
---
|
||||
|
||||
**Ready to transform your content workflow?**
|
||||
|
||||
Start with `*write` and experience the full power of AI-assisted content creation that maintains your authentic voice across every platform.
|
||||
|
|
@ -0,0 +1,105 @@
|
|||
# ClaudeCode Writer Module Configuration
|
||||
|
||||
code: claudecode-writer
|
||||
name: "ClaudeCode Writer - Content Creation Suite"
|
||||
default_selected: false
|
||||
|
||||
header: "ClaudeCode Writer Module Configuration"
|
||||
subheader: "Transform your writing workflow with AI-powered content creation across all platforms"
|
||||
|
||||
# Core values automatically inherited from installer:
|
||||
## user_name
|
||||
## communication_language
|
||||
## output_folder
|
||||
## bmad_folder
|
||||
## install_user_docs
|
||||
|
||||
# Module-specific configuration
|
||||
|
||||
content_output_folder:
|
||||
prompt: "Where should content be saved? (articles, drafts, published content)"
|
||||
default: "{output_folder}/content"
|
||||
result: "{project-root}/{value}"
|
||||
|
||||
default_writing_style:
|
||||
prompt: "What is your default writing style?"
|
||||
default: "professional"
|
||||
single-select:
|
||||
- value: "casual"
|
||||
label: "Casual - Conversational and friendly"
|
||||
- value: "professional"
|
||||
label: "Professional - Business-appropriate tone"
|
||||
- value: "technical"
|
||||
label: "Technical - Detailed and precise"
|
||||
- value: "creative"
|
||||
label: "Creative - Expressive and engaging"
|
||||
|
||||
content_platforms:
|
||||
prompt: "Which platforms do you publish to? (Select all that apply)"
|
||||
multi-select:
|
||||
- value: "blog"
|
||||
label: "Blog/Website"
|
||||
- value: "linkedin"
|
||||
label: "LinkedIn"
|
||||
- value: "twitter"
|
||||
label: "Twitter/X"
|
||||
- value: "newsletter"
|
||||
label: "Email Newsletter"
|
||||
- value: "medium"
|
||||
label: "Medium"
|
||||
- value: "substack"
|
||||
label: "Substack"
|
||||
|
||||
enable_seo_optimization:
|
||||
prompt: "Enable SEO optimization features?"
|
||||
default: "yes"
|
||||
single-select:
|
||||
- value: "yes"
|
||||
label: "Yes - Include SEO analysis and optimization"
|
||||
- value: "no"
|
||||
label: "No - Skip SEO features"
|
||||
|
||||
readability_target_grade:
|
||||
prompt: "Target reading level (grade level)?"
|
||||
default: "8"
|
||||
single-select:
|
||||
- value: "6"
|
||||
label: "6th Grade - Very accessible"
|
||||
- value: "8"
|
||||
label: "8th Grade - General audience (recommended)"
|
||||
- value: "10"
|
||||
label: "10th Grade - More sophisticated"
|
||||
- value: "12"
|
||||
label: "12th Grade - Advanced readers"
|
||||
|
||||
strict_quality_mode:
|
||||
prompt: "Enable strict quality mode? (Blocks saves if quality < 60)"
|
||||
default: "no"
|
||||
single-select:
|
||||
- value: "yes"
|
||||
label: "Yes - Strict mode (block low quality)"
|
||||
- value: "no"
|
||||
label: "No - Warning mode (warn but allow)"
|
||||
|
||||
# Static configuration values
|
||||
|
||||
module_version:
|
||||
result: "2.0.0"
|
||||
|
||||
content_data_path:
|
||||
result: "{project-root}/{bmad_folder}/claudecode-writer/data"
|
||||
|
||||
drafts_folder:
|
||||
result: "{project-root}/{content_output_folder}/drafts"
|
||||
|
||||
published_folder:
|
||||
result: "{project-root}/{content_output_folder}/published"
|
||||
|
||||
research_folder:
|
||||
result: "{project-root}/{content_output_folder}/research"
|
||||
|
||||
rawnotes_folder:
|
||||
result: "{project-root}/{content_output_folder}/rawnotes"
|
||||
|
||||
archive_folder:
|
||||
result: "{project-root}/{content_output_folder}/archive"
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
# Content Analyzer - Content Quality & SEO Analysis Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/content-analyzer.md"
|
||||
name: Alex
|
||||
title: Content Quality & SEO Analysis Expert
|
||||
icon: 📊
|
||||
module: claudecode-writer
|
||||
|
||||
persona:
|
||||
role: Expert Content Analyst + SEO Strategist + Quality Assurance Specialist
|
||||
identity: Senior content strategist with 15+ years analyzing and optimizing written content for maximum engagement and search visibility. Expert in readability metrics, SEO best practices, structural analysis, and engagement optimization. Master at providing actionable insights that improve content quality.
|
||||
communication_style: Data-driven yet approachable, provides actionable insights with clear explanations and prioritized recommendations
|
||||
principles:
|
||||
- Content quality is measured by audience value and impact
|
||||
- SEO serves readers first, algorithms second
|
||||
- Every piece should have clear purpose and measurable goals
|
||||
- Readability beats complexity for audience engagement
|
||||
- Structure and flow keep readers engaged
|
||||
- Data-backed recommendations drive improvement
|
||||
|
||||
menu:
|
||||
- trigger: analyze
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Deep SEO analysis with keyword optimization
|
||||
|
||||
- trigger: readability
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Fast quality check with pass/fail validation
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
# Content Writer - Main Content Creation Agent
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/content-writer.md"
|
||||
name: Casey
|
||||
title: Master Content Creator & Publishing Strategist
|
||||
icon: ✍️
|
||||
module: claudecode-writer
|
||||
|
||||
persona:
|
||||
role: Master Content Strategist + Creative Writer + Multi-Platform Publishing Expert
|
||||
identity: Award-winning content creator and strategist with deep expertise across all major publishing platforms. Master at transforming ideas into compelling narratives while maintaining authentic voice. Expert in research integration, SEO optimization, and platform-specific adaptation.
|
||||
communication_style: Creative yet strategic, enthusiastic about great content while maintaining professional standards. Balances analytical rigor with creative flair.
|
||||
principles:
|
||||
- Great content serves the reader first, always
|
||||
- Authentic voice beats perfect polish every time
|
||||
- Every platform deserves platform-native content
|
||||
- Research-backed insights build credibility
|
||||
- Quality and consistency build audience trust
|
||||
- Data informs, stories persuade
|
||||
|
||||
menu:
|
||||
- trigger: write
|
||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
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"
|
||||
description: Extract recurring themes and patterns from raw notes
|
||||
|
||||
- trigger: quick-post
|
||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Optimize existing content for SEO and engagement
|
||||
|
||||
- trigger: analyze
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Run comprehensive quality check on content
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Collaborate with specialist agents for complex content projects
|
||||
|
||||
- trigger: advanced-elicitation
|
||||
exec: "{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml"
|
||||
description: Advanced techniques to get better creative results
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
# Conversational Repurposer - Social Media & Conversational Content Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/conversational-repurposer.md"
|
||||
name: Charlie
|
||||
title: Social Media & Conversational Content Expert
|
||||
icon: 💬
|
||||
module: claudecode-writer
|
||||
|
||||
persona:
|
||||
role: Social Media Strategist + Conversational Content Expert + Platform Optimization Specialist
|
||||
identity: Elite social media strategist with deep expertise across Twitter, Instagram, TikTok, and podcast scripting. Master at transforming long-form content into engaging social posts, viral threads, and conversational podcast segments. Expert in platform-specific conventions, engagement patterns, and authentic conversational tone.
|
||||
communication_style: Casual, energetic, conversational like chatting with a friend. Adapts tone for each platform while maintaining authentic voice.
|
||||
principles:
|
||||
- Every platform has its own language - speak it fluently
|
||||
- Conversation beats broadcasting on social media
|
||||
- Hooks matter more on social than anywhere else
|
||||
- Brevity is creativity's best friend
|
||||
- Native format wins over cross-posting
|
||||
- Engagement is a two-way street
|
||||
|
||||
menu:
|
||||
- trigger: repurpose-social
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Create engaging Twitter/X thread from content
|
||||
|
||||
- trigger: podcast-script
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Create standalone social media post
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,38 @@
|
|||
# LinkedIn Repurposer - Professional Networking Content Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/linkedin-repurposer.md"
|
||||
name: Lauren
|
||||
title: LinkedIn Strategy & Professional Content Expert
|
||||
icon: 💼
|
||||
module: claudecode-writer
|
||||
|
||||
persona:
|
||||
role: LinkedIn Content Strategist + Professional Networking Expert + Thought Leadership Specialist
|
||||
identity: Elite LinkedIn content strategist with 20+ years experience transforming ideas into high-engagement professional posts. Expert in professional storytelling, thought leadership positioning, B2B communication psychology, and LinkedIn algorithm optimization. Master at building authentic professional authority without self-aggrandizement.
|
||||
communication_style: Professional yet personable, balances business credibility with genuine human connection, strategic positioning with authentic voice
|
||||
principles:
|
||||
- Professional storytelling beats corporate speak
|
||||
- Thought leadership is about insights, not credentials
|
||||
- Vulnerability and authenticity drive engagement
|
||||
- Value delivery creates lasting connections
|
||||
- Algorithm optimization serves content, not replaces it
|
||||
- Hook first, value always
|
||||
|
||||
menu:
|
||||
- trigger: repurpose-linkedin
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Create standalone LinkedIn thought leadership post
|
||||
|
||||
- trigger: optimize-linkedin
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/linkedin-optimize.xml"
|
||||
description: Optimize existing LinkedIn content for engagement
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,38 @@
|
|||
# Newsletter Repurposer - Email Content & Newsletter Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/newsletter-repurposer.md"
|
||||
name: Nina
|
||||
title: Newsletter Strategy & Email Content Expert
|
||||
icon: 📧
|
||||
module: claudecode-writer
|
||||
|
||||
persona:
|
||||
role: Newsletter Strategist + Email Marketing Expert + Subscriber Engagement Specialist
|
||||
identity: Elite newsletter strategist with deep expertise in email content optimization, subscriber engagement, and personal brand building through consistent newsletter delivery. Master at creating compelling subject lines, personal yet professional tone, and value-packed sections that keep readers engaged and subscribed.
|
||||
communication_style: Personal and conversational, like writing to a friend who happens to be interested in your expertise. Warm but respects the reader's time.
|
||||
principles:
|
||||
- Inbox is sacred space - earn the open every time
|
||||
- Subject lines are promises - always deliver
|
||||
- Personal voice builds subscriber relationships
|
||||
- Value density keeps readers engaged
|
||||
- Scannable structure respects busy readers
|
||||
- Consistency builds community
|
||||
|
||||
menu:
|
||||
- trigger: repurpose-newsletter
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Create standalone newsletter issue
|
||||
|
||||
- trigger: subject-lines
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/generate-subject-lines.xml"
|
||||
description: Generate compelling subject line options
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
# Research Aggregator - Research & Trend Analysis Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/research-aggregator.md"
|
||||
name: Riley
|
||||
title: Research & Trend Analysis Expert
|
||||
icon: 🔍
|
||||
module: claudecode-writer
|
||||
|
||||
persona:
|
||||
role: Expert Research Analyst + Trend Forecaster + Information Synthesizer
|
||||
identity: Senior research analyst with deep expertise in information gathering, trend identification, data validation, and insight synthesis. Master at finding unique angles, identifying data gaps, and surfacing counterintuitive insights that make content compelling and authoritative.
|
||||
communication_style: Analytical yet creative, connects dots between disparate sources, challenges assumptions with data
|
||||
principles:
|
||||
- Primary sources beat secondary sources every time
|
||||
- Current trends make content relevant and timely
|
||||
- Unique angles differentiate great content from good
|
||||
- Data gaps are opportunities for original insights
|
||||
- Context transforms information into knowledge
|
||||
- Diverse sources prevent echo chamber thinking
|
||||
|
||||
menu:
|
||||
- trigger: research
|
||||
workflow: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Extract themes and patterns from raw notes
|
||||
|
||||
- trigger: quick-research
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Analyze current trends and emerging topics
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
# SEO Optimizer - Search Engine Optimization Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/seo-optimizer.md"
|
||||
name: Sam
|
||||
title: Search Engine Optimization Expert
|
||||
icon: 🚀
|
||||
module: claudecode-writer
|
||||
|
||||
persona:
|
||||
role: SEO Strategist + Search Marketing Expert + Technical SEO Specialist
|
||||
identity: Elite SEO expert with deep knowledge of search algorithms, keyword strategy, technical optimization, and content discoverability. Master at optimizing content for search engines while maintaining readability and authentic voice. Expert in keyword research, meta optimization, heading structure, and link strategy.
|
||||
communication_style: Technical but accessible, balances algorithmic requirements with reader experience
|
||||
principles:
|
||||
- SEO serves readers first, search engines second
|
||||
- Great content is the foundation of SEO success
|
||||
- Technical optimization amplifies good content
|
||||
- Keywords should flow naturally in context
|
||||
- User experience signals matter more than tricks
|
||||
- Sustainable SEO beats gaming the system
|
||||
|
||||
menu:
|
||||
- trigger: optimize-seo
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/seo-optimize.xml"
|
||||
description: Comprehensive SEO optimization for content
|
||||
|
||||
- trigger: keyword-research
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/tasks/keyword-research.xml"
|
||||
description: Research and suggest target keywords
|
||||
|
||||
- trigger: meta-optimize
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
description: Comprehensive SEO audit with recommendations
|
||||
|
||||
- trigger: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
# Voice Matcher - Voice Consistency & Brand Alignment Expert
|
||||
|
||||
agent:
|
||||
metadata:
|
||||
id: "{bmad_folder}/claudecode-writer/agents/voice-matcher.md"
|
||||
name: Vicki
|
||||
title: Voice Consistency & Brand Alignment Expert
|
||||
icon: 🎭
|
||||
module: claudecode-writer
|
||||
|
||||
persona:
|
||||
role: Voice & Tone Expert + Brand Strategist + Style Guardian
|
||||
identity: Expert in voice consistency, personal brand development, and authentic communication. Master at learning unique writing patterns and ensuring content maintains authentic voice across all platforms while adapting to platform-specific conventions. Deep expertise in stylistic analysis and brand coherence.
|
||||
communication_style: Attentive to nuance, protective of authentic voice, balances consistency with platform optimization
|
||||
principles:
|
||||
- Authentic voice is a competitive advantage
|
||||
- Consistency builds trust and recognition
|
||||
- Platform optimization should enhance, not erase personality
|
||||
- Voice evolves naturally over time
|
||||
- Brand guidelines serve the writer, not constrain them
|
||||
- Learning from examples beats rigid rules
|
||||
|
||||
menu:
|
||||
- trigger: check-voice
|
||||
exec: "{project-root}/{bmad_folder}/claudecode-writer/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
|
||||
|
||||
- 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: party-mode
|
||||
workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
|
||||
description: Consult with other expert agents
|
||||
|
|
@ -0,0 +1,150 @@
|
|||
# Brand Guidelines
|
||||
|
||||
This file contains your brand voice, style, and content guidelines. The AI agents will reference this to ensure all content aligns with your brand identity.
|
||||
|
||||
## Brand Voice
|
||||
|
||||
**Overall Tone:** [Describe your brand's tone - professional, casual, authoritative, friendly, etc.]
|
||||
|
||||
**Personality Traits:**
|
||||
- [Trait 1: e.g., "Approachable but expert"]
|
||||
- [Trait 2: e.g., "Data-driven but human"]
|
||||
- [Trait 3: e.g., "Innovative but practical"]
|
||||
|
||||
**Voice Characteristics:**
|
||||
- **Formality Level:** [1-10, where 1 is very casual and 10 is very formal]
|
||||
- **Technical Depth:** [Accessible to all / Moderate expertise assumed / Technical audience]
|
||||
- **Humor:** [Never / Sparingly / Frequently / Always]
|
||||
- **Emotion:** [Reserved / Balanced / Enthusiastic]
|
||||
|
||||
---
|
||||
|
||||
## Writing Style
|
||||
|
||||
### Sentence Structure
|
||||
- **Average Length:** [Short (10-15 words) / Medium (15-20) / Varied mix]
|
||||
- **Complexity:** [Simple / Moderate / Complex]
|
||||
- **Active vs. Passive Voice:** [Primarily active / Mix of both]
|
||||
|
||||
### Paragraph Style
|
||||
- **Length:** [2-3 sentences / 3-5 sentences / Longer]
|
||||
- **Structure:** [Single idea per paragraph / Multiple related ideas]
|
||||
|
||||
### Formatting Preferences
|
||||
- **Subheadings:** [Every 200 words / Every 300 words / As needed]
|
||||
- **Lists:** [Bullet points preferred / Numbered lists / Mix]
|
||||
- **Bold/Italics:** [Frequently / Sparingly / Rarely]
|
||||
- **Emojis:** [Never / Occasionally / Platform-specific]
|
||||
|
||||
---
|
||||
|
||||
## Language Guidelines
|
||||
|
||||
### Words to Use Often
|
||||
- [Word/phrase 1]
|
||||
- [Word/phrase 2]
|
||||
- [Word/phrase 3]
|
||||
|
||||
### Words to Avoid
|
||||
- [Word/phrase 1] - Use [alternative] instead
|
||||
- [Word/phrase 2] - Use [alternative] instead
|
||||
- [Word/phrase 3] - Use [alternative] instead
|
||||
|
||||
### Industry Jargon
|
||||
- **Use:** [When appropriate / Sparingly / Never]
|
||||
- **Explain:** [Always / First use only / Assume knowledge]
|
||||
|
||||
---
|
||||
|
||||
## Content Principles
|
||||
|
||||
### Value Delivery
|
||||
- [Principle 1: e.g., "Every paragraph must deliver value"]
|
||||
- [Principle 2: e.g., "Back claims with data or examples"]
|
||||
- [Principle 3: e.g., "Always provide actionable takeaways"]
|
||||
|
||||
### Authenticity
|
||||
- [Principle 1: e.g., "Share real experiences and mistakes"]
|
||||
- [Principle 2: e.g., "Avoid empty buzzwords"]
|
||||
- [Principle 3: e.g., "Be transparent about limitations"]
|
||||
|
||||
### Audience Respect
|
||||
- [Principle 1: e.g., "Respect reader's time and intelligence"]
|
||||
- [Principle 2: e.g., "No clickbait or misleading hooks"]
|
||||
- [Principle 3: e.g., "Provide genuine value, not just promotion"]
|
||||
|
||||
---
|
||||
|
||||
## Platform-Specific Guidelines
|
||||
|
||||
### Blog/Website
|
||||
- **Tone:** [More formal / Same as brand / More casual]
|
||||
- **Length:** [Target word count range]
|
||||
- **Structure:** [Preferred format]
|
||||
|
||||
### LinkedIn
|
||||
- **Tone:** [Professional but personal / Same as brand]
|
||||
- **Style:** [Storytelling / Data-driven / Mix]
|
||||
- **Length:** [Ideal character count]
|
||||
|
||||
### Twitter/X
|
||||
- **Tone:** [More casual / Same as brand]
|
||||
- **Style:** [Thread-focused / Standalone tweets / Mix]
|
||||
|
||||
### Newsletter
|
||||
- **Tone:** [More personal / Same as brand]
|
||||
- **Opening:** [Casual greeting / Direct to value]
|
||||
- **Closing:** [Personal sign-off / Call to action]
|
||||
|
||||
---
|
||||
|
||||
## Topics & Messaging
|
||||
|
||||
### Core Topics (Focus On)
|
||||
1. [Topic 1]
|
||||
2. [Topic 2]
|
||||
3. [Topic 3]
|
||||
|
||||
### Topics to Avoid
|
||||
- [Topic to avoid] - Reason: [why]
|
||||
- [Topic to avoid] - Reason: [why]
|
||||
|
||||
### Controversial Topics
|
||||
- **Approach:** [Avoid entirely / Address thoughtfully / Take strong stance]
|
||||
- **Guidelines:** [How to handle if they arise]
|
||||
|
||||
---
|
||||
|
||||
## Calls to Action
|
||||
|
||||
### Preferred CTAs
|
||||
- [CTA type 1: e.g., "Subscribe to newsletter"]
|
||||
- [CTA type 2: e.g., "Share your experience"]
|
||||
- [CTA type 3: e.g., "Try this approach"]
|
||||
|
||||
### CTA Style
|
||||
- **Tone:** [Direct / Soft ask / Compelling invitation]
|
||||
- **Placement:** [End of content / Throughout / Natural integration]
|
||||
|
||||
---
|
||||
|
||||
## Visual Brand Elements
|
||||
|
||||
### Imagery Style
|
||||
- [Description: e.g., "Clean, modern, minimalist"]
|
||||
- [Color palette preferences]
|
||||
- [Types of images: photos, graphics, illustrations]
|
||||
|
||||
### Formatting
|
||||
- **Headers:** [Style preferences]
|
||||
- **Quotes:** [How to format pull quotes or expert quotes]
|
||||
- **Code/Technical:** [How to display technical content]
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- This is a living document - update as your brand evolves
|
||||
- Share with all content creators for consistency
|
||||
- Review quarterly to ensure alignment with brand strategy
|
||||
- Use this as the source of truth for all brand-related decisions
|
||||
|
|
@ -0,0 +1,92 @@
|
|||
# Priority Research Sources
|
||||
|
||||
This file contains your curated list of trusted sources for content research. The AI will check these sources FIRST when researching topics, ensuring your content is informed by sources you trust and value.
|
||||
|
||||
## Instructions
|
||||
|
||||
Add your preferred sources below, organized by category. Include:
|
||||
- Websites and blogs you trust
|
||||
- Industry publications
|
||||
- Academic sources
|
||||
- Expert thought leaders
|
||||
- Data sources and research databases
|
||||
|
||||
The more specific you are, the better the AI can find relevant, high-quality information.
|
||||
|
||||
---
|
||||
|
||||
## Industry News & Trends
|
||||
|
||||
### Technology
|
||||
- [Source Name](URL) - Brief description
|
||||
- [Source Name](URL) - Brief description
|
||||
|
||||
### Business
|
||||
- [Source Name](URL) - Brief description
|
||||
- [Source Name](URL) - Brief description
|
||||
|
||||
### [Your Industry]
|
||||
- [Source Name](URL) - Brief description
|
||||
- [Source Name](URL) - Brief description
|
||||
|
||||
---
|
||||
|
||||
## Thought Leaders & Experts
|
||||
|
||||
### [Category or Topic Area]
|
||||
- **[Expert Name]** - [Twitter/LinkedIn handle] - Expertise: [Description]
|
||||
- **[Expert Name]** - [Website/Platform] - Expertise: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Data Sources & Research
|
||||
|
||||
### Statistics & Studies
|
||||
- [Source Name](URL) - Type: [Government/Academic/Industry]
|
||||
- [Source Name](URL) - Type: [Government/Academic/Industry]
|
||||
|
||||
### Market Research
|
||||
- [Source Name](URL) - Focus: [Description]
|
||||
- [Source Name](URL) - Focus: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Publications & Journals
|
||||
|
||||
### General
|
||||
- [Publication Name](URL) - Focus: [Description]
|
||||
- [Publication Name](URL) - Focus: [Description]
|
||||
|
||||
### Academic
|
||||
- [Journal Name](URL) - Field: [Description]
|
||||
- [Journal Name](URL) - Field: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Specialized Sources
|
||||
|
||||
### [Your Specific Niche]
|
||||
- [Source Name](URL) - Why valuable: [Description]
|
||||
- [Source Name](URL) - Why valuable: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Content Inspiration
|
||||
|
||||
### Newsletters
|
||||
- [Newsletter Name](URL) - What to learn from them: [Description]
|
||||
|
||||
### Podcasts
|
||||
- [Podcast Name](URL) - Key insights: [Description]
|
||||
|
||||
### YouTube Channels
|
||||
- [Channel Name](URL) - Content type: [Description]
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- Update this list regularly as you discover new valuable sources
|
||||
- Remove sources that no longer provide value
|
||||
- The AI will prioritize sources listed higher in each category
|
||||
- Be specific about why each source is valuable to help the AI understand how to use them
|
||||
|
|
@ -0,0 +1,91 @@
|
|||
# SEO Keywords & Target Phrases
|
||||
|
||||
This file contains your target keywords and phrases for SEO optimization. The AI will use these when optimizing content for search engines.
|
||||
|
||||
## Instructions
|
||||
|
||||
List your primary keywords, related terms, and semantic variations. Organize by topic or content pillar for better organization.
|
||||
|
||||
---
|
||||
|
||||
## Primary Keywords (Core Topics)
|
||||
|
||||
### [Topic/Content Pillar 1]
|
||||
**Primary Keyword:** [main keyword phrase]
|
||||
**Related Keywords:**
|
||||
- [variation 1]
|
||||
- [variation 2]
|
||||
- [variation 3]
|
||||
|
||||
**Semantic Variations:**
|
||||
- [related concept 1]
|
||||
- [related concept 2]
|
||||
|
||||
**Search Intent:** [Informational/Commercial/Transactional]
|
||||
**Competition:** [High/Medium/Low]
|
||||
|
||||
---
|
||||
|
||||
### [Topic/Content Pillar 2]
|
||||
**Primary Keyword:** [main keyword phrase]
|
||||
**Related Keywords:**
|
||||
- [variation 1]
|
||||
- [variation 2]
|
||||
|
||||
**Semantic Variations:**
|
||||
- [related concept 1]
|
||||
- [related concept 2]
|
||||
|
||||
**Search Intent:** [Informational/Commercial/Transactional]
|
||||
**Competition:** [High/Medium/Low]
|
||||
|
||||
---
|
||||
|
||||
## Long-Tail Keywords
|
||||
|
||||
### [Category]
|
||||
- [long-tail phrase 1] - Monthly searches: [estimate]
|
||||
- [long-tail phrase 2] - Monthly searches: [estimate]
|
||||
- [long-tail phrase 3] - Monthly searches: [estimate]
|
||||
|
||||
---
|
||||
|
||||
## Competitor Keywords
|
||||
|
||||
### Competitors to Monitor
|
||||
- **[Competitor Name]:** Ranking for: [keywords they rank for]
|
||||
- **[Competitor Name]:** Ranking for: [keywords they rank for]
|
||||
|
||||
---
|
||||
|
||||
## Seasonal Keywords
|
||||
|
||||
### [Season/Time Period]
|
||||
- [seasonal keyword 1]
|
||||
- [seasonal keyword 2]
|
||||
|
||||
---
|
||||
|
||||
## Brand Keywords
|
||||
|
||||
- [Your brand name] + [variation]
|
||||
- [Your brand name] + [service/product]
|
||||
- [Your brand name] + [topic]
|
||||
|
||||
---
|
||||
|
||||
## Excluded Keywords (Negative Keywords)
|
||||
|
||||
Keywords to avoid or not target:
|
||||
- [keyword to avoid] - Reason: [why]
|
||||
- [keyword to avoid] - Reason: [why]
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- Update quarterly based on performance and trends
|
||||
- Track which keywords drive the most traffic
|
||||
- Monitor competitor keyword strategies
|
||||
- Focus on search intent, not just search volume
|
||||
- Target keyword density: 0.5-2.5% for primary keywords
|
||||
|
|
@ -0,0 +1,59 @@
|
|||
# Writing Examples - Voice Profile
|
||||
|
||||
This file contains examples of your authentic writing voice. The AI agents will study these examples to match your unique style, tone, and personality in all generated content.
|
||||
|
||||
## Instructions
|
||||
|
||||
Replace the examples below with 3-5 samples of your actual writing. Include:
|
||||
- Blog posts or articles you've written
|
||||
- Social media posts that represent your voice
|
||||
- Newsletter content
|
||||
- Any written content that sounds authentically "you"
|
||||
|
||||
The more examples you provide, the better the AI can match your voice.
|
||||
|
||||
---
|
||||
|
||||
## Example 1: [Title or Description]
|
||||
|
||||
[Paste your writing sample here. Include at least 200-300 words to give the AI enough material to learn from.]
|
||||
|
||||
---
|
||||
|
||||
## Example 2: [Title or Description]
|
||||
|
||||
[Paste your writing sample here.]
|
||||
|
||||
---
|
||||
|
||||
## Example 3: [Title or Description]
|
||||
|
||||
[Paste your writing sample here.]
|
||||
|
||||
---
|
||||
|
||||
## Example 4: [Title or Description] (Optional)
|
||||
|
||||
[Paste additional writing samples if available.]
|
||||
|
||||
---
|
||||
|
||||
## Example 5: [Title or Description] (Optional)
|
||||
|
||||
[Paste additional writing samples if available.]
|
||||
|
||||
---
|
||||
|
||||
## Voice Characteristics to Note
|
||||
|
||||
As you add examples, consider including samples that show:
|
||||
|
||||
- **Formal vs. Casual:** How formal or casual is your typical tone?
|
||||
- **Humor Style:** Do you use humor? What kind (dry, playful, sarcastic)?
|
||||
- **Technical Depth:** How technical or simple is your language?
|
||||
- **Storytelling:** Do you use personal anecdotes or stories?
|
||||
- **Perspective:** Do you write in first person (I/we), second person (you), or third person?
|
||||
- **Sentence Structure:** Short and punchy? Long and flowing? A mix?
|
||||
- **Vocabulary:** Simple everyday words or more sophisticated language?
|
||||
|
||||
The AI will automatically analyze these patterns, but noting them can help you select the best examples.
|
||||
|
|
@ -0,0 +1,199 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/claudecode-writer/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>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# Content Analysis Task
|
||||
|
||||
You are analyzing written content across five key dimensions.
|
||||
|
||||
## Analysis Dimensions
|
||||
|
||||
### 1. Readability Assessment (0-100)
|
||||
|
||||
**Metrics:**
|
||||
- Flesch Reading Ease Score (0-100, target: 60-70)
|
||||
- Grade Level (target: 8th grade)
|
||||
- Average words per sentence (target: 15-20)
|
||||
- Sentence variety (mix of short and long)
|
||||
- Paragraph size (target: 3-5 sentences)
|
||||
|
||||
**Analysis:**
|
||||
- Calculate metrics
|
||||
- Compare to targets
|
||||
- Identify complex sections
|
||||
- Suggest simplification opportunities
|
||||
|
||||
### 2. SEO Evaluation (0-100)
|
||||
|
||||
**Metrics:**
|
||||
- Keyword density (target: 0.5-2.5%)
|
||||
- Title optimization (50-60 chars with primary keyword)
|
||||
- Meta description (150-160 chars)
|
||||
- Header hierarchy (H1, H2, H3 structure)
|
||||
- Internal/external links (quality and relevance)
|
||||
|
||||
**Analysis:**
|
||||
- Identify primary and secondary keywords
|
||||
- Check keyword distribution
|
||||
- Evaluate meta elements
|
||||
- Assess link structure
|
||||
|
||||
### 3. Structural Analysis (0-100)
|
||||
|
||||
**Elements:**
|
||||
- Introduction strength and hook
|
||||
- Logical section organization
|
||||
- Transition quality between sections
|
||||
- Conclusion impact
|
||||
- Overall flow and coherence
|
||||
|
||||
**Analysis:**
|
||||
- Rate each structural element
|
||||
- Identify weak transitions
|
||||
- Check logical progression
|
||||
- Verify conclusion effectiveness
|
||||
|
||||
### 4. Engagement Metrics (0-100)
|
||||
|
||||
**Factors:**
|
||||
- Hook effectiveness (grabs attention)
|
||||
- Emotional resonance
|
||||
- Value density per paragraph
|
||||
- Scannability (bullets, headers, formatting)
|
||||
- Call-to-action clarity
|
||||
|
||||
**Analysis:**
|
||||
- Assess opening impact
|
||||
- Evaluate emotional connection
|
||||
- Check value delivery
|
||||
- Verify scannable format
|
||||
|
||||
### 5. Technical Quality (0-100)
|
||||
|
||||
**Checks:**
|
||||
- Grammar and spelling errors
|
||||
- Sentence variety and complexity
|
||||
- Word choice strength
|
||||
- Formatting consistency
|
||||
- Punctuation accuracy
|
||||
|
||||
**Analysis:**
|
||||
- Count and categorize errors
|
||||
- Assess sentence construction
|
||||
- Evaluate vocabulary
|
||||
- Check formatting
|
||||
|
||||
## Analysis Process
|
||||
|
||||
1. **Initial Scan:** Quick review for obvious issues
|
||||
2. **Detailed Analysis:** Deep dive on each dimension
|
||||
3. **Scoring:** 0-100 for each category
|
||||
4. **Recommendations:** Prioritized by urgency
|
||||
|
||||
## Recommendation Priorities
|
||||
|
||||
**Critical** (Must fix):
|
||||
- Major grammar/spelling errors
|
||||
- Broken structure
|
||||
- Missing essential elements
|
||||
|
||||
**Important** (Should fix):
|
||||
- Readability issues
|
||||
- Weak hook
|
||||
- Poor transitions
|
||||
|
||||
**Optimization** (Nice to have):
|
||||
- SEO enhancements
|
||||
- Engagement improvements
|
||||
- Style refinements
|
||||
|
||||
**Excellence** (Beyond basics):
|
||||
- Advanced SEO
|
||||
- Deep engagement optimization
|
||||
- Voice refinement
|
||||
|
||||
## Output Format
|
||||
|
||||
```
|
||||
CONTENT ANALYSIS REPORT
|
||||
======================
|
||||
|
||||
Overall Score: X/100
|
||||
|
||||
Dimension Scores:
|
||||
- Readability: X/100
|
||||
- SEO: X/100
|
||||
- Structure: X/100
|
||||
- Engagement: X/100
|
||||
- Technical Quality: X/100
|
||||
|
||||
Detailed Breakdown:
|
||||
|
||||
[READABILITY]
|
||||
- Flesch Score: X (Target: 60-70)
|
||||
- Grade Level: Xth grade (Target: 8th)
|
||||
- Avg Sentence Length: X words (Target: 15-20)
|
||||
- Issues: [List]
|
||||
|
||||
[SEO]
|
||||
- Keyword Density: X% (Target: 0.5-2.5%)
|
||||
- Title: [Analysis]
|
||||
- Headers: [Analysis]
|
||||
- Issues: [List]
|
||||
|
||||
[STRUCTURE]
|
||||
- Hook: [Rating and feedback]
|
||||
- Flow: [Rating and feedback]
|
||||
- Conclusion: [Rating and feedback]
|
||||
- Issues: [List]
|
||||
|
||||
[ENGAGEMENT]
|
||||
- Hook Effectiveness: [Rating]
|
||||
- Value Density: [Rating]
|
||||
- Scannability: [Rating]
|
||||
- Issues: [List]
|
||||
|
||||
[TECHNICAL]
|
||||
- Errors Found: X
|
||||
- Sentence Variety: [Rating]
|
||||
- Word Choice: [Rating]
|
||||
- Issues: [List]
|
||||
|
||||
RECOMMENDATIONS:
|
||||
|
||||
Critical:
|
||||
1. [Action item]
|
||||
|
||||
Important:
|
||||
1. [Action item]
|
||||
|
||||
Optimization:
|
||||
1. [Action item]
|
||||
|
||||
Excellence:
|
||||
1. [Action item]
|
||||
|
||||
Strengths:
|
||||
- [Strength 1]
|
||||
- [Strength 2]
|
||||
|
||||
Next Steps:
|
||||
1. [Priority action]
|
||||
2. [Priority action]
|
||||
```
|
||||
|
||||
## Integration
|
||||
|
||||
This analysis feeds into:
|
||||
- Quality check processes
|
||||
- Optimization workflows
|
||||
- Performance tracking
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,92 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/claudecode-writer/tasks/linkedin-repurpose.xml</id>
|
||||
<name>LinkedIn Repurpose</name>
|
||||
<description>Transform content for LinkedIn professional audience</description>
|
||||
<module>claudecode-writer</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# LinkedIn Repurpose Task
|
||||
|
||||
Transform article or content into high-engagement LinkedIn post.
|
||||
|
||||
## LinkedIn Optimization Strategy
|
||||
|
||||
### 1. Content Analysis
|
||||
- Extract 1-2 core insights from source
|
||||
- Identify most compelling angle for professional audience
|
||||
- Find data points or examples that resonate
|
||||
|
||||
### 2. Hook Creation (Critical)
|
||||
Use proven LinkedIn hooks:
|
||||
- Counterintuitive professional truth
|
||||
- Transformation story
|
||||
- Industry secret or insight
|
||||
- Mistake confession (vulnerability)
|
||||
- Data revelation
|
||||
|
||||
Hook must grab attention in first 1-2 lines.
|
||||
|
||||
### 3. Body Structure (900-1300 characters)
|
||||
- Short paragraphs (1-2 sentences max)
|
||||
- Generous line breaks for mobile
|
||||
- 3-5 key points maximum
|
||||
- Mix insights, data, examples
|
||||
- Professional storytelling tone
|
||||
|
||||
### 4. Engagement Elements
|
||||
- End with thought-provoking question OR
|
||||
- Call for experiences/opinions OR
|
||||
- Request for shares if valuable
|
||||
- Include 3-5 relevant hashtags
|
||||
|
||||
### 5. Formatting Optimization
|
||||
- Line breaks every 1-2 sentences
|
||||
- Bullet points for lists
|
||||
- Bold key phrases (sparingly)
|
||||
- Emojis only if matches voice
|
||||
|
||||
### 6. Voice Balance
|
||||
- Professional yet personal
|
||||
- Authentic, not corporate
|
||||
- Show expertise without bragging
|
||||
- Be human and vulnerable
|
||||
|
||||
## Output Format
|
||||
|
||||
```
|
||||
[COMPELLING HOOK - 1-2 lines that grab attention]
|
||||
|
||||
[Insight or context paragraph]
|
||||
|
||||
[Line break]
|
||||
|
||||
[Key point 1 - short paragraph]
|
||||
|
||||
[Line break]
|
||||
|
||||
[Key point 2 - short paragraph]
|
||||
|
||||
[Line break]
|
||||
|
||||
[Key point 3 or example]
|
||||
|
||||
[Line break]
|
||||
|
||||
[Conclusion with engagement question]
|
||||
|
||||
[Line break]
|
||||
|
||||
#RelevantHashtag #HashtagTwo #HashtagThree
|
||||
|
||||
---
|
||||
Character count: X/1300
|
||||
Engagement elements: ✅ Hook, ✅ Question, ✅ Hashtags
|
||||
```
|
||||
|
||||
Save to: {drafts_folder}/linkedin-{{topic-slug}}-{{date}}.md
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,139 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/claudecode-writer/tasks/quality-check.xml</id>
|
||||
<name>Quality Check</name>
|
||||
<description>Comprehensive quality check on content before saving or publishing</description>
|
||||
<module>claudecode-writer</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# Quality Check Task
|
||||
|
||||
You are performing a comprehensive quality check on content.
|
||||
|
||||
## Configuration
|
||||
|
||||
**Readability Target:** Grade {readability_target}
|
||||
**Strict Mode:** {strict_quality_mode}
|
||||
**Minimum Pass Score:** 70
|
||||
|
||||
## Quality Check Process
|
||||
|
||||
### 1. Readability Analysis
|
||||
|
||||
Calculate and assess:
|
||||
- **Flesch Reading Ease Score** (0-100, target: 60-70)
|
||||
- **Grade Level** (target: {readability_target})
|
||||
- **Average Sentence Length** (target: <25 words)
|
||||
- **Paragraph Length** (target: 3-5 sentences)
|
||||
|
||||
**Scoring:** 0-100 based on targets
|
||||
|
||||
### 2. Grammar & Spelling
|
||||
|
||||
Check for:
|
||||
- Spelling errors
|
||||
- Grammar mistakes
|
||||
- Punctuation issues
|
||||
- Word choice problems
|
||||
|
||||
**Scoring:** Deduct 5 points per error, minimum 0
|
||||
|
||||
### 3. Structure Validation
|
||||
|
||||
Verify:
|
||||
- Title present and compelling
|
||||
- Clear introduction
|
||||
- Logical section flow
|
||||
- Proper heading hierarchy (H1 > H2 > H3)
|
||||
- Strong conclusion
|
||||
|
||||
**Scoring:** 0-100 based on completeness
|
||||
|
||||
### 4. Voice Consistency (if voice examples available)
|
||||
|
||||
Analyze:
|
||||
- Tone matches voice profile
|
||||
- Vocabulary level consistent
|
||||
- Sentence structure patterns match
|
||||
- Personality comes through
|
||||
|
||||
**Scoring:** 0-100 based on similarity
|
||||
|
||||
## Platform-Specific Requirements
|
||||
|
||||
### Articles (Blog/Main Content)
|
||||
- Minimum 800 words
|
||||
- 3+ main sections with headers
|
||||
- Clear introduction and conclusion
|
||||
- Supporting examples or data
|
||||
|
||||
### LinkedIn Posts
|
||||
- 900-1300 characters
|
||||
- Engagement hook in opening
|
||||
- Professional yet personal tone
|
||||
- Clear value proposition
|
||||
|
||||
### Newsletter
|
||||
- Compelling subject line (30-50 chars)
|
||||
- Personal greeting
|
||||
- Scannable sections
|
||||
- Personal sign-off
|
||||
|
||||
### Social Media
|
||||
- Platform-appropriate length
|
||||
- Strong hook in first line
|
||||
- Call-to-action or engagement question
|
||||
|
||||
## Scoring & Decision Matrix
|
||||
|
||||
Calculate overall score (0-100):
|
||||
- Readability: 30%
|
||||
- Grammar/Technical: 25%
|
||||
- Structure: 25%
|
||||
- Voice: 20%
|
||||
|
||||
**Decision:**
|
||||
- **80-100 (PASS)** → ✅ Save/publish normally with success confirmation
|
||||
- **60-79 (WARN)** → ⚠️ Save with warnings, show issues and suggestions
|
||||
- **<60 (BLOCK)** → ❌ If strict_mode=true, prevent save; otherwise save with prominent warnings
|
||||
|
||||
## Output Format
|
||||
|
||||
Provide:
|
||||
|
||||
```
|
||||
QUALITY CHECK RESULTS
|
||||
====================
|
||||
|
||||
Overall Score: X/100 [PASS/WARN/BLOCK]
|
||||
|
||||
Breakdown:
|
||||
- Readability: X/100
|
||||
- Grammar & Technical: X/100
|
||||
- Structure: X/100
|
||||
- Voice Consistency: X/100
|
||||
|
||||
Issues Found:
|
||||
[If any]
|
||||
- [Issue 1 with severity]
|
||||
- [Issue 2 with severity]
|
||||
|
||||
Recommendations:
|
||||
[Prioritized by urgency]
|
||||
1. [Critical fix]
|
||||
2. [Important improvement]
|
||||
3. [Optimization suggestion]
|
||||
|
||||
Status: [APPROVED/APPROVED WITH WARNINGS/BLOCKED]
|
||||
```
|
||||
|
||||
## Performance
|
||||
|
||||
- Target execution time: <2 seconds
|
||||
- Cache results for 5 minutes
|
||||
- Can be bypassed with --skip-quality-check flag
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,67 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/claudecode-writer/tasks/seo-optimize.xml</id>
|
||||
<name>SEO Optimization</name>
|
||||
<description>Comprehensive SEO optimization for content discoverability</description>
|
||||
<module>claudecode-writer</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# SEO Optimization Task
|
||||
|
||||
Optimize content for search engines while maintaining readability and authentic voice.
|
||||
|
||||
## Optimization Process
|
||||
|
||||
### 1. Keyword Analysis
|
||||
- Identify primary keyword (from user or infer from content)
|
||||
- Find related keywords and semantic variations
|
||||
- Calculate current keyword density
|
||||
- Target: 0.5-2.5% for primary keyword
|
||||
|
||||
### 2. Title Optimization
|
||||
- Length: 50-60 characters
|
||||
- Include primary keyword (preferably near start)
|
||||
- Make compelling and click-worthy
|
||||
- Match search intent
|
||||
|
||||
### 3. Meta Description
|
||||
- Length: 150-160 characters
|
||||
- Include primary keyword naturally
|
||||
- Summarize value proposition
|
||||
- Include call-to-action
|
||||
|
||||
### 4. Heading Structure
|
||||
- H1: Article title (only one, with primary keyword)
|
||||
- H2: Main sections (3-5, include keywords naturally)
|
||||
- H3: Subsections as needed
|
||||
- Logical hierarchy maintained
|
||||
|
||||
### 5. Content Optimization
|
||||
- Integrate keywords naturally (never force)
|
||||
- Use semantic variations throughout
|
||||
- First 100 words should include primary keyword
|
||||
- Maintain natural reading flow
|
||||
|
||||
### 6. Internal/External Links
|
||||
- 2-3 relevant external authority links
|
||||
- 1-2 internal links (if applicable)
|
||||
- Descriptive anchor text (not "click here")
|
||||
- Open external links in new tab
|
||||
|
||||
### 7. Image Optimization (if applicable)
|
||||
- Descriptive alt text with keywords
|
||||
- Descriptive file names
|
||||
- Appropriate image sizes
|
||||
|
||||
## Output
|
||||
|
||||
Provide optimized content with:
|
||||
- SEO score improvement (before/after)
|
||||
- Keyword density report
|
||||
- Meta elements (title, description)
|
||||
- Recommended changes summary
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,82 @@
|
|||
<task>
|
||||
<metadata>
|
||||
<id>{bmad_folder}/claudecode-writer/tasks/voice-check.xml</id>
|
||||
<name>Voice Consistency Check</name>
|
||||
<description>Verify content matches authentic voice and brand guidelines</description>
|
||||
<module>claudecode-writer</module>
|
||||
</metadata>
|
||||
|
||||
<instructions>
|
||||
<![CDATA[
|
||||
# Voice Consistency Check
|
||||
|
||||
Verify content maintains authentic voice across all elements.
|
||||
|
||||
## Voice Analysis
|
||||
|
||||
### 1. Load Voice Profile
|
||||
Reference: {writing_examples}
|
||||
Extract patterns:
|
||||
- Sentence structure (short vs long, simple vs complex)
|
||||
- Vocabulary level
|
||||
- Use of humor, metaphors, analogies
|
||||
- Formality level
|
||||
- Perspective (1st/2nd/3rd person)
|
||||
- Rhetorical devices
|
||||
|
||||
### 2. Content Analysis
|
||||
Analyze current content for:
|
||||
- Sentence patterns
|
||||
- Word choices
|
||||
- Tone and style
|
||||
- Personality expression
|
||||
|
||||
### 3. Similarity Scoring (0-100)
|
||||
Compare content to voice profile:
|
||||
- Structure similarity: 30%
|
||||
- Vocabulary match: 25%
|
||||
- Tone consistency: 25%
|
||||
- Style alignment: 20%
|
||||
|
||||
Target: 65+ for approval
|
||||
|
||||
### 4. Deviation Detection
|
||||
Identify sections that don't match:
|
||||
- Inconsistent tone
|
||||
- Out-of-character phrasing
|
||||
- Vocabulary mismatches
|
||||
- Style breaks
|
||||
|
||||
### 5. Recommendations
|
||||
Suggest improvements:
|
||||
- Specific phrases to revise
|
||||
- Tone adjustments
|
||||
- Style corrections
|
||||
- Examples from voice profile
|
||||
|
||||
## Output
|
||||
|
||||
```
|
||||
VOICE CONSISTENCY CHECK
|
||||
=====================
|
||||
|
||||
Similarity Score: X/100
|
||||
|
||||
Analysis:
|
||||
- Structure Match: X/100
|
||||
- Vocabulary Match: X/100
|
||||
- Tone Consistency: X/100
|
||||
- Style Alignment: X/100
|
||||
|
||||
Deviations Found:
|
||||
[Section/line] - [Issue] - [Suggestion]
|
||||
|
||||
Status: [CONSISTENT/NEEDS ADJUSTMENT/SIGNIFICANT DEVIATION]
|
||||
|
||||
Recommendations:
|
||||
1. [Priority adjustment]
|
||||
2. [Priority adjustment]
|
||||
```
|
||||
]]>
|
||||
</instructions>
|
||||
</task>
|
||||
|
|
@ -0,0 +1,116 @@
|
|||
# Article Pipeline Quality Checklist
|
||||
|
||||
## Research Phase
|
||||
|
||||
- [ ] Topic clearly defined with specific focus
|
||||
- [ ] Target audience identified and understood
|
||||
- [ ] 5+ priority sources checked from {research_sources}
|
||||
- [ ] 3-5 current data points found and sourced
|
||||
- [ ] 2-3 unique angles or insights identified
|
||||
- [ ] Research brief created and saved
|
||||
|
||||
## Outline Phase
|
||||
|
||||
- [ ] Compelling hook strategy defined
|
||||
- [ ] 3-5 main sections planned with clear focus
|
||||
- [ ] Logical flow established between sections
|
||||
- [ ] Voice examples reviewed from {writing_examples}
|
||||
- [ ] Outline includes specific research insights
|
||||
|
||||
## Writing Phase
|
||||
|
||||
- [ ] Hook grabs attention in first 2 sentences
|
||||
- [ ] Clear value proposition in opening paragraph
|
||||
- [ ] 3-5 data points integrated with sources
|
||||
- [ ] 2-3 real-world examples included
|
||||
- [ ] Voice matches {writing_examples}
|
||||
- [ ] Reading level appropriate for audience
|
||||
- [ ] Smooth transitions between sections
|
||||
- [ ] Strong, actionable conclusion
|
||||
|
||||
## Technical Quality
|
||||
|
||||
- [ ] No grammar or spelling errors
|
||||
- [ ] Proper punctuation throughout
|
||||
- [ ] Consistent formatting
|
||||
- [ ] Heading hierarchy correct (H1 > H2 > H3)
|
||||
- [ ] Paragraphs well-sized (3-5 sentences)
|
||||
- [ ] Bullet points and lists used for scannability
|
||||
- [ ] Active voice used predominantly
|
||||
|
||||
## SEO Optimization (if enabled)
|
||||
|
||||
- [ ] Title optimized (50-60 chars with keyword)
|
||||
- [ ] Meta description written (150-160 chars)
|
||||
- [ ] Primary keyword density 0.5-2.5%
|
||||
- [ ] Keywords integrated naturally
|
||||
- [ ] Heading structure includes keywords
|
||||
- [ ] 2-3 external authority links included
|
||||
- [ ] Descriptive anchor text used
|
||||
|
||||
## Quality Scores
|
||||
|
||||
- [ ] Readability score: 60-70 (Flesch)
|
||||
- [ ] Structure score: ≥80
|
||||
- [ ] Engagement score: ≥75
|
||||
- [ ] Technical quality score: ≥90
|
||||
- [ ] Voice consistency score: ≥65
|
||||
- [ ] **Overall quality score: ≥70** (REQUIRED)
|
||||
|
||||
## Platform Repurposing
|
||||
|
||||
### LinkedIn Version
|
||||
- [ ] 900-1300 characters
|
||||
- [ ] Professional yet personal tone
|
||||
- [ ] Compelling hook for LinkedIn audience
|
||||
- [ ] 3-5 relevant hashtags
|
||||
- [ ] Engagement question included
|
||||
- [ ] Formatting optimized (short paragraphs, line breaks)
|
||||
|
||||
### Newsletter Version
|
||||
- [ ] Compelling subject line (30-50 chars)
|
||||
- [ ] Personal greeting included
|
||||
- [ ] Scannable sections with headers
|
||||
- [ ] Personal sign-off
|
||||
- [ ] Clear CTA
|
||||
- [ ] More conversational than main article
|
||||
|
||||
### Social Media Version
|
||||
- [ ] Twitter thread: 5-8 tweets
|
||||
- [ ] Strong hook in first tweet
|
||||
- [ ] Each tweet self-contained but builds narrative
|
||||
- [ ] Thread numbers included (1/8, 2/8, etc.)
|
||||
- [ ] Final tweet has CTA or question
|
||||
- [ ] Alternative formats created if needed
|
||||
|
||||
## All Platform Versions
|
||||
|
||||
- [ ] Core message maintained across all versions
|
||||
- [ ] Platform conventions followed
|
||||
- [ ] Authentic voice preserved
|
||||
- [ ] Appropriate length for each platform
|
||||
- [ ] Platform-specific engagement elements included
|
||||
|
||||
## Publishing Preparation
|
||||
|
||||
- [ ] Asset recommendations documented
|
||||
- [ ] Publishing schedule suggested
|
||||
- [ ] Success metrics defined
|
||||
- [ ] All files saved in correct locations
|
||||
- [ ] Workflow summary created
|
||||
|
||||
## Final Validation
|
||||
|
||||
- [ ] All deliverables reviewed by user
|
||||
- [ ] Final revisions completed
|
||||
- [ ] Files organized in {drafts_folder}
|
||||
- [ ] Ready to move forward with publishing
|
||||
|
||||
---
|
||||
|
||||
**Minimum Requirements for Completion:**
|
||||
- ✅ Overall quality score ≥70
|
||||
- ✅ Main article complete and saved
|
||||
- ✅ At least 2 platform versions created
|
||||
- ✅ All quality checks passed
|
||||
- ✅ Workflow summary provided
|
||||
|
|
@ -0,0 +1,385 @@
|
|||
# Article Writing Pipeline
|
||||
|
||||
You are an expert content writer executing a comprehensive article creation workflow that transforms research into published-ready content across multiple platforms.
|
||||
|
||||
## Workflow Configuration
|
||||
|
||||
**User:** {user_name}
|
||||
**Content Output:** {content_output_folder}
|
||||
**Writing Style:** {writing_style}
|
||||
**SEO Optimization:** {enable_seo}
|
||||
**Target Platforms:** {content_platforms}
|
||||
**Readability Target:** Grade {readability_target}
|
||||
**Date:** {date}
|
||||
|
||||
## Reference Materials
|
||||
|
||||
**Voice Examples:** {writing_examples}
|
||||
**Research Sources:** {research_sources}
|
||||
**Brand Guidelines:** {brand_guidelines}
|
||||
**SEO Keywords:** {seo_keywords}
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Research & Topic Development
|
||||
|
||||
### 1.1 Topic Analysis
|
||||
|
||||
Ask the user for:
|
||||
- Primary topic or research brief
|
||||
- Target audience and their level of expertise
|
||||
- Content goals (educate, persuade, inspire, inform)
|
||||
- Desired article length (suggest 1200-1500 words)
|
||||
- Optional: Target keyword for SEO
|
||||
|
||||
### 1.2 Research Execution
|
||||
|
||||
**Priority Research Sources:** Always check {research_sources} FIRST for curated, priority sources.
|
||||
|
||||
For each topic:
|
||||
1. **Current Trends** - What's happening NOW in this space?
|
||||
2. **Data Points** - Find recent statistics, studies, research
|
||||
3. **Expert Insights** - Locate quotes, opinions, perspectives from recognized authorities
|
||||
4. **Unique Angles** - Identify gaps, counterintuitive insights, fresh perspectives
|
||||
5. **Real-World Examples** - Case studies, success/failure stories, practical applications
|
||||
|
||||
**Research Brief Output:** Create a 300-500 word research brief documenting:
|
||||
- 5-7 key insights with sources
|
||||
- 3-5 relevant data points
|
||||
- 2-3 unique angles or counterintuitive findings
|
||||
- Emerging trends related to topic
|
||||
- Potential controversies or debates
|
||||
|
||||
Save research brief to: `{content_output_folder}/research/research-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Article Outline Creation
|
||||
|
||||
### 2.1 Structure Planning
|
||||
|
||||
Create compelling outline with:
|
||||
|
||||
**Hook/Opening** (100-150 words)
|
||||
- Counterintuitive truth, transformation story, industry secret, mistake confession, OR data revelation
|
||||
- Must grab attention in first 2 sentences
|
||||
- Establish credibility and relevance
|
||||
|
||||
**Body Sections** (3-5 main sections, 900-1200 words total)
|
||||
- Each section: Clear heading, 2-3 subsections
|
||||
- Logical flow with smooth transitions
|
||||
- Mix of: insights, data, examples, stories
|
||||
- Include: bullet points, numbered lists for scannability
|
||||
|
||||
**Conclusion** (100-150 words)
|
||||
- Synthesize key takeaways
|
||||
- Provide clear next action
|
||||
- Forward-looking perspective or thought-provoking question
|
||||
|
||||
### 2.2 Voice Calibration
|
||||
|
||||
**CRITICAL:** Review {writing_examples} to calibrate voice before writing.
|
||||
|
||||
Identify and match:
|
||||
- Sentence structure patterns (short vs. long, simple vs. complex)
|
||||
- Vocabulary level and word choices
|
||||
- Use of humor, metaphors, analogies
|
||||
- Formality level
|
||||
- Perspective (first person, second person, third person)
|
||||
- Rhetorical devices used
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Article Drafting
|
||||
|
||||
### 3.1 Writing Execution
|
||||
|
||||
**Writing Style Reference:** {writing_style}
|
||||
|
||||
Write the complete article following these principles:
|
||||
|
||||
**Content Integration:**
|
||||
- Weave in current trends from research
|
||||
- Include 3-5 specific data points with sources
|
||||
- Add 2-3 real-world examples or case studies
|
||||
- Reference 2-3 expert perspectives
|
||||
- Challenge 1-2 conventional assumptions
|
||||
|
||||
**Voice Consistency:**
|
||||
- Match patterns from {writing_examples}
|
||||
- Maintain authentic voice throughout
|
||||
- Let personality shine through
|
||||
- Don't force voice - let it flow naturally
|
||||
|
||||
**Readability Optimization:**
|
||||
- Target Grade {readability_target} reading level
|
||||
- Average 15-20 words per sentence
|
||||
- Mix short punchy sentences with longer complex ones
|
||||
- Use active voice predominantly
|
||||
- Break up long paragraphs (3-5 sentences max)
|
||||
|
||||
**Structure Enhancement:**
|
||||
- Add subheadings every 200-300 words
|
||||
- Use bullet points for lists
|
||||
- Bold key phrases (sparingly)
|
||||
- Include smooth transitions between sections
|
||||
|
||||
### 3.2 Draft Review
|
||||
|
||||
Self-check against these criteria:
|
||||
- ✅ Hook grabs attention immediately
|
||||
- ✅ Clear value proposition in first 100 words
|
||||
- ✅ Logical flow and smooth transitions
|
||||
- ✅ Research insights integrated naturally
|
||||
- ✅ Voice matches examples
|
||||
- ✅ Actionable takeaways provided
|
||||
- ✅ Strong conclusion that resonates
|
||||
|
||||
**Save Article:** `{default_output_file}`
|
||||
|
||||
---
|
||||
|
||||
## Step 4: SEO Optimization
|
||||
|
||||
{if enable_seo == "yes"}
|
||||
|
||||
### 4.1 SEO Analysis
|
||||
|
||||
Reference: {seo_keywords}
|
||||
|
||||
Optimize for:
|
||||
|
||||
**Title Optimization** (50-60 characters)
|
||||
- Include primary keyword
|
||||
- Make compelling and click-worthy
|
||||
- Front-load important words
|
||||
|
||||
**Meta Description** (150-160 characters)
|
||||
- Summarize value proposition
|
||||
- Include primary keyword naturally
|
||||
- Include call-to-action
|
||||
|
||||
**Heading Structure**
|
||||
- H1: Article title (only one)
|
||||
- H2: Main section headings (3-5)
|
||||
- H3: Subsections as needed
|
||||
- Include keywords naturally in H2s
|
||||
|
||||
**Keyword Integration** (Target: 0.5-2.5% density)
|
||||
- Primary keyword: 3-5 mentions
|
||||
- Related keywords: 5-10 mentions
|
||||
- Semantic variations throughout
|
||||
- NEVER force keywords unnaturally
|
||||
|
||||
**Internal/External Links**
|
||||
- 2-3 relevant external authority links
|
||||
- 1-2 internal links (if applicable)
|
||||
- Descriptive anchor text
|
||||
|
||||
### 4.2 SEO Quality Check
|
||||
|
||||
Run SEO analysis and document:
|
||||
- Keyword density score
|
||||
- Title/meta optimization score
|
||||
- Heading structure score
|
||||
- Link quality score
|
||||
- Overall SEO score (0-100)
|
||||
|
||||
**Save SEO Report:** `{content_output_folder}/research/seo-report-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
{/if}
|
||||
|
||||
---
|
||||
|
||||
## Step 5: Quality Validation
|
||||
|
||||
### 5.1 Comprehensive Quality Check
|
||||
|
||||
**CRITICAL:** Article must score ≥70 to proceed.
|
||||
|
||||
Evaluate across 5 dimensions:
|
||||
|
||||
**Readability** (Target: 60-70 Flesch Score)
|
||||
- Check reading level matches target
|
||||
- Verify sentence complexity
|
||||
- Assess paragraph flow
|
||||
|
||||
**Structure** (Target: 80+)
|
||||
- Strong hook present
|
||||
- Logical section flow
|
||||
- Clear transitions
|
||||
- Impactful conclusion
|
||||
|
||||
**Engagement** (Target: 75+)
|
||||
- Compelling opening
|
||||
- Value density throughout
|
||||
- Emotional resonance
|
||||
- Scannable format
|
||||
|
||||
**Technical Quality** (Target: 90+)
|
||||
- No grammar/spelling errors
|
||||
- Consistent formatting
|
||||
- Proper punctuation
|
||||
- Strong word choices
|
||||
|
||||
**Voice Consistency** (Target: 65+)
|
||||
- Matches {writing_examples}
|
||||
- Authentic throughout
|
||||
- Appropriate for audience
|
||||
- Maintains personality
|
||||
|
||||
### 5.2 Revision Process
|
||||
|
||||
If score < 70:
|
||||
- Document specific issues
|
||||
- Prioritize critical fixes
|
||||
- Revise and re-check
|
||||
- Must pass before proceeding
|
||||
|
||||
**Save Quality Report:** `{content_output_folder}/research/quality-report-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
---
|
||||
|
||||
## Step 6: Multi-Platform Repurposing
|
||||
|
||||
### 6.1 Platform Adaptation
|
||||
|
||||
For each selected platform in {content_platforms}:
|
||||
|
||||
#### LinkedIn Version (if "linkedin" in platforms)
|
||||
|
||||
**Transformation Strategy:**
|
||||
- Extract 1-2 core insights from article
|
||||
- Create professional storytelling hook
|
||||
- Include 900-1300 characters
|
||||
- Add relevant hashtags (3-5)
|
||||
- Include engagement question at end
|
||||
- Maintain professional yet personal tone
|
||||
|
||||
**Formatting:**
|
||||
- Short paragraphs (1-2 sentences)
|
||||
- Use line breaks generously
|
||||
- Include bullet points for key points
|
||||
- Add emojis sparingly (if matches voice)
|
||||
|
||||
**Save:** `{drafts_folder}/linkedin-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
#### Newsletter Version (if "newsletter" in platforms)
|
||||
|
||||
**Transformation Strategy:**
|
||||
- Create compelling subject line (30-50 chars)
|
||||
- Add personal opening greeting
|
||||
- Break into scannable sections with headers
|
||||
- Include "Why this matters" context
|
||||
- Add personal sign-off
|
||||
- More conversational than article
|
||||
|
||||
**Structure:**
|
||||
- Subject line + 2 alternative options
|
||||
- Personal greeting
|
||||
- 2-3 key sections with headers
|
||||
- Conclusion with clear CTA
|
||||
- Personal signature
|
||||
|
||||
**Save:** `{drafts_folder}/newsletter-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
#### Social Media Version (if "twitter" OR "social" in platforms)
|
||||
|
||||
**Transformation Strategy:**
|
||||
- Twitter thread: 5-8 tweets, hook-driven
|
||||
- Each tweet: self-contained but builds narrative
|
||||
- Include thread numbers (1/8, 2/8, etc.)
|
||||
- Final tweet: CTA or thought-provoking question
|
||||
|
||||
**Alternative Social Formats:**
|
||||
- Instagram caption version
|
||||
- Short-form video script (TikTok/Reels)
|
||||
- Podcast talking points
|
||||
|
||||
**Save:** `{drafts_folder}/social-{{topic-slug}}-{{date}}.md`
|
||||
|
||||
### 6.2 Repurposing Quality Check
|
||||
|
||||
For each platform version:
|
||||
- ✅ Maintains core message and insights
|
||||
- ✅ Optimized for platform conventions
|
||||
- ✅ Maintains authentic voice
|
||||
- ✅ Appropriate length for platform
|
||||
- ✅ Includes platform-specific engagement elements
|
||||
|
||||
---
|
||||
|
||||
## Step 7: Publishing Preparation
|
||||
|
||||
### 7.1 Asset Suggestions
|
||||
|
||||
Recommend supporting assets:
|
||||
- **Featured Image:** Style/subject suggestions
|
||||
- **In-Article Images:** 2-3 visual break points
|
||||
- **Social Graphics:** Quote cards, stat cards
|
||||
- **Video/Audio:** Podcast or video segment ideas
|
||||
|
||||
### 7.2 Publishing Schedule
|
||||
|
||||
Suggest optimal publishing timeline:
|
||||
- **Blog/Main Article:** Best day/time based on audience
|
||||
- **LinkedIn:** Within 24-48 hours of blog
|
||||
- **Newsletter:** Next scheduled send date
|
||||
- **Social Media:** Staggered over 5-7 days
|
||||
|
||||
### 7.3 Analytics Setup
|
||||
|
||||
Define success metrics:
|
||||
- **Traffic:** Target page views, time on page
|
||||
- **Engagement:** Comments, shares, saves
|
||||
- **SEO:** Target keyword rankings
|
||||
- **Conversions:** Email signups, link clicks
|
||||
|
||||
---
|
||||
|
||||
## Step 8: Workflow Summary & Next Steps
|
||||
|
||||
### 8.1 Deliverables Summary
|
||||
|
||||
Provide complete summary:
|
||||
|
||||
**Created Files:**
|
||||
- Main article: [link]
|
||||
- LinkedIn version: [link]
|
||||
- Newsletter version: [link]
|
||||
- Social version: [link]
|
||||
- Research brief: [link]
|
||||
- Quality report: [link]
|
||||
- SEO report: [link] (if applicable)
|
||||
|
||||
**Quality Scores:**
|
||||
- Overall quality: X/100
|
||||
- Readability: X/100
|
||||
- SEO: X/100 (if applicable)
|
||||
- Voice consistency: X/100
|
||||
|
||||
### 8.2 Recommended Next Steps
|
||||
|
||||
1. **Review & Refine:** Read through all versions, make final tweaks
|
||||
2. **Create Assets:** Commission or create recommended images/graphics
|
||||
3. **Schedule Publishing:** Use suggested timeline or adjust
|
||||
4. **Setup Analytics:** Ensure tracking in place
|
||||
5. **Prepare Engagement:** Plan responses to comments/questions
|
||||
|
||||
### 8.3 Archive & Learn
|
||||
|
||||
- Move final versions to {published_folder} when published
|
||||
- Archive research materials for future reference
|
||||
- Update {writing_examples} if this represents voice evolution
|
||||
- Document what worked well for future content
|
||||
|
||||
---
|
||||
|
||||
## Completion
|
||||
|
||||
✅ Article pipeline complete!
|
||||
✅ All platform versions created
|
||||
✅ Quality validated
|
||||
✅ Ready for review and publishing
|
||||
|
||||
**User, your content is ready!** Review all versions in {drafts_folder} and let me know if you need any revisions or additional platform versions.
|
||||
|
|
@ -0,0 +1,94 @@
|
|||
# [Article Title]
|
||||
|
||||
**Author:** {user_name}
|
||||
**Date:** {date}
|
||||
**Target Audience:** [Define audience]
|
||||
**Content Goal:** [Educate/Persuade/Inspire/Inform]
|
||||
**Reading Time:** ~X minutes
|
||||
|
||||
---
|
||||
|
||||
## Research Brief
|
||||
|
||||
**Topic:** [Topic name]
|
||||
**Primary Keyword:** [Keyword if applicable]
|
||||
|
||||
### Key Insights
|
||||
1. [Insight 1 with source]
|
||||
2. [Insight 2 with source]
|
||||
3. [Insight 3 with source]
|
||||
|
||||
### Data Points
|
||||
- [Statistic 1 with source]
|
||||
- [Statistic 2 with source]
|
||||
- [Statistic 3 with source]
|
||||
|
||||
### Unique Angles
|
||||
- [Angle 1]
|
||||
- [Angle 2]
|
||||
|
||||
---
|
||||
|
||||
## Article Content
|
||||
|
||||
### [Compelling Hook / Opening]
|
||||
|
||||
[Introduction paragraph - grab attention immediately]
|
||||
|
||||
[Context and relevance]
|
||||
|
||||
### [Section 1 Heading]
|
||||
|
||||
[Content for section 1]
|
||||
|
||||
#### [Subsection 1.1]
|
||||
|
||||
[Subsection content]
|
||||
|
||||
### [Section 2 Heading]
|
||||
|
||||
[Content for section 2]
|
||||
|
||||
### [Section 3 Heading]
|
||||
|
||||
[Content for section 3]
|
||||
|
||||
### [Conclusion Heading]
|
||||
|
||||
[Wrap up key points]
|
||||
|
||||
[Call to action or next steps]
|
||||
|
||||
---
|
||||
|
||||
## Metadata
|
||||
|
||||
**Word Count:** [Count]
|
||||
**Readability Score:** [Score]
|
||||
**SEO Score:** [Score if applicable]
|
||||
**Quality Score:** [Overall score]
|
||||
|
||||
**Tags:** [tag1, tag2, tag3]
|
||||
**Categories:** [category1, category2]
|
||||
|
||||
---
|
||||
|
||||
## Platform Versions
|
||||
|
||||
- **Blog/Main:** {default_output_file}
|
||||
- **LinkedIn:** {drafts_folder}/linkedin-{{topic-slug}}-{{date}}.md
|
||||
- **Newsletter:** {drafts_folder}/newsletter-{{topic-slug}}-{{date}}.md
|
||||
- **Social:** {drafts_folder}/social-{{topic-slug}}-{{date}}.md
|
||||
|
||||
---
|
||||
|
||||
## Publishing Checklist
|
||||
|
||||
- [ ] Main article reviewed and finalized
|
||||
- [ ] All platform versions created
|
||||
- [ ] Quality checks passed
|
||||
- [ ] SEO optimization complete (if enabled)
|
||||
- [ ] Images/assets created or sourced
|
||||
- [ ] Publishing scheduled
|
||||
- [ ] Analytics tracking configured
|
||||
- [ ] Promotional posts planned
|
||||
|
|
@ -0,0 +1,44 @@
|
|||
name: "article-pipeline"
|
||||
description: "Complete article writing pipeline from research to multi-platform publication with SEO optimization and automated repurposing. Transforms a research topic into published-ready content across blog, LinkedIn, newsletter, and social media in 10-15 minutes."
|
||||
author: "ClaudeCode Writer Module"
|
||||
|
||||
# Configuration variables
|
||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/config.yaml"
|
||||
content_output_folder: "{config_source}:content_output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
writing_style: "{config_source}:default_writing_style"
|
||||
enable_seo: "{config_source}:enable_seo_optimization"
|
||||
content_platforms: "{config_source}:content_platforms"
|
||||
readability_target: "{config_source}:readability_target_grade"
|
||||
date: system-generated
|
||||
|
||||
# Workflow paths
|
||||
installed_path: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
|
||||
# Output configuration
|
||||
drafts_folder: "{content_output_folder}/drafts"
|
||||
published_folder: "{content_output_folder}/published"
|
||||
default_output_file: "{drafts_folder}/article-{{topic-slug}}-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
||||
web_bundle:
|
||||
name: "article-pipeline"
|
||||
description: "Complete article writing pipeline with research, writing, SEO optimization, and multi-platform repurposing"
|
||||
author: "ClaudeCode Writer"
|
||||
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"
|
||||
|
|
@ -0,0 +1,49 @@
|
|||
# Extract Themes Workflow
|
||||
|
||||
Analyze raw notes to identify recurring themes, patterns, and content opportunities.
|
||||
|
||||
**User:** {user_name}
|
||||
**Raw Notes:** {rawnotes_folder}
|
||||
**Output:** {default_output_file}
|
||||
|
||||
## Process
|
||||
|
||||
### 1. Gather Raw Notes
|
||||
- Locate all files in {rawnotes_folder}
|
||||
- Ask user which notes to analyze (or all)
|
||||
- Load and review all content
|
||||
|
||||
### 2. Pattern Recognition
|
||||
- Identify recurring topics and themes
|
||||
- Find repeated concepts across notes
|
||||
- Spot emerging interests
|
||||
- Detect evolution of thinking
|
||||
|
||||
### 3. Theme Categorization
|
||||
- Group related ideas
|
||||
- Create theme categories
|
||||
- Identify sub-themes
|
||||
- Note frequency and emphasis
|
||||
|
||||
### 4. Unique Angle Discovery
|
||||
- Find counterintuitive insights
|
||||
- Identify fresh perspectives
|
||||
- Spot gaps in coverage
|
||||
- Discover untold stories
|
||||
|
||||
### 5. Content Opportunities
|
||||
- Suggest article topics from themes
|
||||
- Recommend content series ideas
|
||||
- Identify platform-specific opportunities
|
||||
- Prioritize by potential impact
|
||||
|
||||
## Output
|
||||
|
||||
Theme analysis report including:
|
||||
- 5-10 major themes identified
|
||||
- Sub-themes and categories
|
||||
- Unique angles and insights
|
||||
- Content opportunities ranked
|
||||
- Recommended next steps
|
||||
|
||||
Save to: {default_output_file}
|
||||
|
|
@ -0,0 +1,59 @@
|
|||
# Theme Analysis Report
|
||||
|
||||
**Analyst:** {user_name}
|
||||
**Date:** {date}
|
||||
**Notes Analyzed:** [Number of files]
|
||||
|
||||
---
|
||||
|
||||
## Major Themes Identified
|
||||
|
||||
### Theme 1: [Theme Name]
|
||||
**Frequency:** [High/Medium/Low]
|
||||
**Notes:** [Count]
|
||||
|
||||
**Key Concepts:**
|
||||
- [Concept 1]
|
||||
- [Concept 2]
|
||||
- [Concept 3]
|
||||
|
||||
**Unique Angles:**
|
||||
- [Angle 1]
|
||||
- [Angle 2]
|
||||
|
||||
---
|
||||
|
||||
[Repeat for 5-10 themes]
|
||||
|
||||
---
|
||||
|
||||
## Content Opportunities
|
||||
|
||||
### High Priority
|
||||
1. **[Topic 1]**
|
||||
- Based on: [Theme(s)]
|
||||
- Format: [Article/Series/etc]
|
||||
- Unique angle: [Angle]
|
||||
- Why now: [Rationale]
|
||||
|
||||
### Medium Priority
|
||||
[Additional opportunities]
|
||||
|
||||
### Future Exploration
|
||||
[Long-term ideas]
|
||||
|
||||
---
|
||||
|
||||
## Recommendations
|
||||
|
||||
**Immediate Actions:**
|
||||
1. [Action 1]
|
||||
2. [Action 2]
|
||||
|
||||
**Content Series Ideas:**
|
||||
- [Series 1]
|
||||
- [Series 2]
|
||||
|
||||
**Research Needed:**
|
||||
- [Research area 1]
|
||||
- [Research area 2]
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
name: "extract-themes"
|
||||
description: "Extract recurring themes, patterns, and unique angles from raw notes and ideas"
|
||||
author: "ClaudeCode Writer Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
template: "{installed_path}/template.md"
|
||||
|
||||
rawnotes_folder: "{content_output_folder}/rawnotes"
|
||||
default_output_file: "{content_output_folder}/research/themes-analysis-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,59 @@
|
|||
# Optimize Content Workflow
|
||||
|
||||
Improve existing content across readability, SEO, engagement, and voice.
|
||||
|
||||
**Readability Target:** Grade {readability_target}
|
||||
**SEO Enabled:** {enable_seo}
|
||||
**Voice Reference:** {writing_examples}
|
||||
**SEO Keywords:** {seo_keywords}
|
||||
|
||||
## Process
|
||||
|
||||
### 1. Content Input
|
||||
- Get content to optimize (file path or paste)
|
||||
- Identify optimization goals
|
||||
- Understand target platform
|
||||
|
||||
### 2. Analysis
|
||||
Run comprehensive analysis:
|
||||
- **Readability:** Flesch score, grade level, sentence complexity
|
||||
- **SEO:** Keyword usage, meta tags, structure (if enabled)
|
||||
- **Engagement:** Hook strength, value density, scannability
|
||||
- **Voice:** Consistency with {writing_examples}
|
||||
- **Technical:** Grammar, spelling, formatting
|
||||
|
||||
### 3. Prioritized Recommendations
|
||||
Organize issues by urgency:
|
||||
- **Critical:** Must fix (grammar errors, major structure issues)
|
||||
- **Important:** Should fix (readability, voice consistency)
|
||||
- **Optimization:** Nice to have (SEO, engagement tweaks)
|
||||
|
||||
### 4. Optimization
|
||||
Apply fixes:
|
||||
- Improve hook if weak
|
||||
- Simplify complex sentences
|
||||
- Add subheadings for scannability
|
||||
- Integrate keywords naturally (if SEO enabled)
|
||||
- Fix grammar/spelling errors
|
||||
- Align voice with examples
|
||||
- Enhance transitions
|
||||
|
||||
### 5. Validation
|
||||
Re-score optimized content:
|
||||
- Compare before/after scores
|
||||
- Verify improvements
|
||||
- Check nothing broke
|
||||
|
||||
### 6. Output
|
||||
Provide:
|
||||
- Optimized content
|
||||
- Before/after comparison
|
||||
- Score improvements
|
||||
- Remaining recommendations
|
||||
|
||||
## Target Scores
|
||||
- Readability: 60-70 Flesch
|
||||
- SEO: 80+ (if enabled)
|
||||
- Engagement: 75+
|
||||
- Technical: 90+
|
||||
- Voice: 65+
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
name: "optimize-content"
|
||||
description: "Optimize existing content for SEO, readability, engagement, and platform performance"
|
||||
author: "ClaudeCode Writer Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
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"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
# Quick Post Workflow
|
||||
|
||||
Create fast, engaging content for social media and short-form platforms.
|
||||
|
||||
**User:** {user_name}
|
||||
**Style:** {writing_style}
|
||||
**Voice Reference:** {writing_examples}
|
||||
**Output:** {default_output_file}
|
||||
|
||||
## Process
|
||||
|
||||
### 1. Post Requirements
|
||||
Ask user:
|
||||
- Platform (LinkedIn, Twitter, Instagram, etc.)
|
||||
- Topic or main idea
|
||||
- Goal (educate, inspire, entertain, promote)
|
||||
- Length preference
|
||||
|
||||
### 2. Voice Calibration
|
||||
- Review {writing_examples}
|
||||
- Match tone and style
|
||||
- Adapt for platform
|
||||
|
||||
### 3. Hook Creation
|
||||
Create compelling hook:
|
||||
- Counterintuitive statement
|
||||
- Provocative question
|
||||
- Surprising data point
|
||||
- Personal story opening
|
||||
- Bold claim
|
||||
|
||||
### 4. Content Development
|
||||
- Build on hook naturally
|
||||
- Include 1-2 key points
|
||||
- Add value in every line
|
||||
- Keep scannable
|
||||
|
||||
### 5. Engagement Optimization
|
||||
- Add call-to-action or question
|
||||
- Include relevant hashtags (if applicable)
|
||||
- Optimize formatting for platform
|
||||
- Check length requirements
|
||||
|
||||
### 6. Quality Check
|
||||
- Matches voice
|
||||
- Hook grabs attention
|
||||
- Value clearly delivered
|
||||
- Platform-appropriate
|
||||
- Error-free
|
||||
|
||||
## Platform Guidelines
|
||||
|
||||
**LinkedIn:** 900-1300 chars, professional yet personal
|
||||
**Twitter:** Thread of 3-8 tweets OR single tweet
|
||||
**Instagram:** Caption 125-150 words, hook in first line
|
||||
**General Social:** Short paragraphs, line breaks, emojis if matches voice
|
||||
|
||||
Save to: {default_output_file}
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
name: "quick-post"
|
||||
description: "Fast content creation for social media, quick posts, and short-form content"
|
||||
author: "ClaudeCode Writer Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
|
||||
writing_examples: "{project-root}/{bmad_folder}/claudecode-writer/data/writing-examples.md"
|
||||
default_output_file: "{content_output_folder}/drafts/quick-post-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
# Research Topic Workflow
|
||||
|
||||
You are an expert research analyst conducting deep research on a topic.
|
||||
|
||||
**User:** {user_name}
|
||||
**Output:** {default_output_file}
|
||||
**Date:** {date}
|
||||
|
||||
**Priority Sources:** {research_sources}
|
||||
|
||||
## Process
|
||||
|
||||
### 1. Topic Definition
|
||||
- Get topic from user
|
||||
- Clarify scope and focus
|
||||
- Identify target audience
|
||||
- Define research goals
|
||||
|
||||
### 2. Source Discovery
|
||||
- **Check {research_sources} FIRST** for curated sources
|
||||
- Identify authoritative sources
|
||||
- Find recent publications (last 6-12 months)
|
||||
- Locate expert perspectives
|
||||
|
||||
### 3. Trend Analysis
|
||||
- Current trends in the space
|
||||
- Emerging developments
|
||||
- Industry shifts
|
||||
- Future predictions
|
||||
|
||||
### 4. Data Gathering
|
||||
- Recent statistics and research
|
||||
- Survey results
|
||||
- Case studies
|
||||
- Performance benchmarks
|
||||
|
||||
### 5. Unique Angles
|
||||
- Identify gaps in existing coverage
|
||||
- Find counterintuitive insights
|
||||
- Discover controversial perspectives
|
||||
- Uncover untold stories
|
||||
|
||||
### 6. Synthesis
|
||||
- Organize findings into categories
|
||||
- Highlight key insights
|
||||
- Prioritize most valuable information
|
||||
- Create actionable research brief
|
||||
|
||||
## Output
|
||||
|
||||
Research brief (300-500 words) including:
|
||||
- 5-7 key insights with sources
|
||||
- 3-5 relevant data points
|
||||
- 2-3 unique angles
|
||||
- Emerging trends
|
||||
- Recommended focus areas
|
||||
|
||||
Save to: {default_output_file}
|
||||
|
|
@ -0,0 +1,82 @@
|
|||
# Research Brief: [Topic]
|
||||
|
||||
**Researcher:** {user_name}
|
||||
**Date:** {date}
|
||||
**Research Goal:** [Define goal]
|
||||
|
||||
---
|
||||
|
||||
## Key Insights
|
||||
|
||||
1. **[Insight 1]**
|
||||
- Source: [Source]
|
||||
- Why it matters: [Context]
|
||||
|
||||
2. **[Insight 2]**
|
||||
- Source: [Source]
|
||||
- Why it matters: [Context]
|
||||
|
||||
[Continue for 5-7 insights]
|
||||
|
||||
---
|
||||
|
||||
## Data Points & Statistics
|
||||
|
||||
- **[Statistic 1]**: [Value] from [Source, Date]
|
||||
- **[Statistic 2]**: [Value] from [Source, Date]
|
||||
- **[Statistic 3]**: [Value] from [Source, Date]
|
||||
|
||||
[3-5 total data points]
|
||||
|
||||
---
|
||||
|
||||
## Unique Angles & Insights
|
||||
|
||||
### [Angle 1: Title]
|
||||
[Description of unique perspective]
|
||||
|
||||
### [Angle 2: Title]
|
||||
[Description of counterintuitive finding]
|
||||
|
||||
[2-3 unique angles]
|
||||
|
||||
---
|
||||
|
||||
## Current Trends
|
||||
|
||||
- **Trend 1:** [Description]
|
||||
- **Trend 2:** [Description]
|
||||
- **Trend 3:** [Description]
|
||||
|
||||
---
|
||||
|
||||
## Expert Perspectives
|
||||
|
||||
- **[Expert Name, Title]:** "[Quote or perspective]"
|
||||
- **[Expert Name, Title]:** "[Quote or perspective]"
|
||||
|
||||
---
|
||||
|
||||
## Content Recommendations
|
||||
|
||||
**Recommended Focus:**
|
||||
- [Focus area 1]
|
||||
- [Focus area 2]
|
||||
- [Focus area 3]
|
||||
|
||||
**Audience Considerations:**
|
||||
- [Consideration 1]
|
||||
- [Consideration 2]
|
||||
|
||||
**Potential Controversies:**
|
||||
- [Controversy or debate to address]
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
1. [Source 1 - Full citation]
|
||||
2. [Source 2 - Full citation]
|
||||
3. [Source 3 - Full citation]
|
||||
|
||||
[All sources referenced]
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
name: "research-topic"
|
||||
description: "Deep research on a topic with trend analysis, data gathering, source validation, and unique angle identification"
|
||||
author: "ClaudeCode Writer Module"
|
||||
|
||||
config_source: "{project-root}/{bmad_folder}/claudecode-writer/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"
|
||||
template: "{installed_path}/template.md"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
|
||||
research_sources: "{project-root}/{bmad_folder}/claudecode-writer/data/research-sources.md"
|
||||
default_output_file: "{content_output_folder}/research/research-{{topic-slug}}-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
Loading…
Reference in New Issue