create-hq 5.1.0 → 5.2.0

package/template/workers/content-product/README.md

@@ -1,77 +0,0 @@
-# Content Worker: Product Accuracy
-
-Product accuracy verification worker for ExampleCo content.
-
-## Purpose
-
-Verifies product claims, feature descriptions, and statistics across website content. Ensures all product-related content is accurate, current, and substantiated.
-
-## Skills
-
-| Skill | Description |
-|-------|-------------|
-| claim-verification | Verify product and business claims |
-| stats-check | Validate statistics and metrics |
-| feature-accuracy | Confirm feature descriptions match reality |
-
-## Knowledge Sources
-
-- `companies/example-company/knowledge/products/` - Official product documentation
-- `companies/example-company/knowledge/metrics.md` - Verified company metrics
-
-## Scoring Categories
-
-| Category | Weight | Description |
-|----------|--------|-------------|
-| Feature Accuracy | 30% | Features correctly described |
-| Statistics Validity | 30% | Numbers verified and current |
-| Technical Correctness | 20% | Technical details accurate |
-| Cross-Page Consistency | 20% | Claims match across site |
-
-## Verification Principles
-
-1. **Source Everything** - Every claim needs a source
-2. **Current Data Only** - Statistics must be recent
-3. **Conservative Claims** - When in doubt, understate
-4. **Consistency First** - Same facts everywhere
-5. **Attribution Required** - Third-party claims need citation
-
-## Claim Categories
-
-### Verified (Green)
-- Documented in product specs
-- Validated by customer data
-- Third-party confirmed
-
-### Unverified (Yellow)
-- Plausible but no source
-- Outdated statistics
-- Internal estimates only
-
-### Inaccurate (Red)
-- Contradicts documentation
-- Demonstrably false
-- Exaggerated claims
-
-## Usage
-
-```bash
-# Run via HQ
-/run content-product --page homepage
-
-# Or directly
-cd workers/content-product
-npx ts-node src/analyze.ts --input content/homepage.json
-```
-
-## Output
-
-Reports go to `workspace/reports/content/` with format:
-- `{date}-content-product-{page}.md`
-
-## Integration
-
-Part of the Content Team worker group. Works alongside:
-- content-brand (voice consistency)
-- content-sales (conversion optimization)
-- content-legal (compliance checking)

package/template/workers/content-product/skills/claim-verification.md

@@ -1,96 +0,0 @@
-# Skill: Claim Verification
-
-Verify product and business claims against authoritative sources.
-
-## Input
-
-- Page content JSON
-- Product documentation
-- Metrics database
-
-## Process
-
-1. **Extract all claims**
-   - Product capabilities
-   - Business outcomes
-   - Comparative statements
-   - Performance metrics
-
-2. **Classify claims**
-   - Feature claims
-   - Performance claims
-   - Business impact claims
-   - Competitive claims
-
-3. **Verify each claim**
-   - Check product documentation
-   - Cross-reference metrics
-   - Validate with case studies
-   - Flag unverifiable
-
-4. **Rate verification status**
-   - Verified: Source found, accurate
-   - Partially verified: Source found, needs update
-   - Unverified: No source found
-   - Inaccurate: Contradicts source
-
-## Claim Types and Sources
-
-### Feature Claims
-**Source:** Product documentation, release notes
-**Example:** "Supports 50+ integrations"
-**Verify:** Count actual integrations in docs
-
-### Performance Claims
-**Source:** Internal benchmarks, customer data
-**Example:** "Processes 1M transactions/day"
-**Verify:** Check metrics database, customer case studies
-
-### Business Impact Claims
-**Source:** Customer case studies, ROI analyses
-**Example:** "Customers see 40% cost reduction"
-**Verify:** Specific customer results, average across customers
-
-### Competitive Claims
-**Source:** Third-party analysis, feature comparison
-**Example:** "Only platform with X feature"
-**Verify:** Competitor research, market analysis
-
-## Verification Standards
-
-| Claim Type | Required Evidence |
-|------------|-------------------|
-| "Supports X" | Documentation listing |
-| "X% improvement" | Customer data, case study |
-| "Fastest/Best" | Third-party benchmark |
-| "Only solution" | Competitive analysis |
-| "X customers" | Current customer count |
-| "Used by [Company]" | Customer permission |
-
-## Output
-
-```yaml
-claim_verification:
-  total_claims: 15
-  verified: 10
-  partially_verified: 3
-  unverified: 2
-  inaccurate: 0
-  claims:
-    - claim: "50+ enterprise integrations"
-      status: "verified"
-      source: "products/integrations.md"
-      note: "Actually 54 integrations listed"
-    - claim: "40% reduction in call volume"
-      status: "partially_verified"
-      source: "case-studies/acme-bank.md"
-      note: "Specific to one customer, state as 'up to 40%'"
-    - claim: "Industry-leading AI"
-      status: "unverified"
-      source: null
-      note: "Subjective claim, recommend removing or substantiating"
-  recommendations:
-    - "Add 'up to' qualifier for percentage claims"
-    - "Remove 'industry-leading' or cite ranking"
-    - "Update integration count to current number"
-```

package/template/workers/content-product/skills/feature-accuracy.md

@@ -1,117 +0,0 @@
-# Skill: Feature Accuracy
-
-Confirm feature descriptions match actual product capabilities.
-
-## Input
-
-- Page content JSON
-- Product documentation
-- Release notes
-
-## Process
-
-1. **Extract feature mentions**
-   - Explicit feature names
-   - Capability descriptions
-   - Integration claims
-   - Platform support
-
-2. **Map to documentation**
-   - Find matching feature
-   - Compare description
-   - Check availability
-   - Verify limitations
-
-3. **Identify discrepancies**
-   - Missing features
-   - Overstated capabilities
-   - Outdated descriptions
-   - Missing caveats
-
-4. **Score accuracy**
-   - Correct descriptions
-   - Minor variations
-   - Significant errors
-   - Missing information
-
-## Feature Verification Matrix
-
-| Content Element | Documentation Check |
-|-----------------|---------------------|
-| Feature name | Official naming |
-| Description | Capability match |
-| Availability | Current release |
-| Pricing tier | Feature matrix |
-| Limitations | Documented caveats |
-| Integrations | Integration list |
-
-## Common Discrepancies
-
-### Naming Issues
-- Using internal names publicly
-- Inconsistent product naming
-- Deprecated feature names
-- Unofficial abbreviations
-
-### Capability Overstatements
-- "Fully automated" (has manual steps)
-- "Unlimited" (has soft limits)
-- "All platforms" (specific support)
-- "Real-time" (near real-time)
-
-### Missing Context
-- Enterprise-only features
-- Add-on pricing
-- Beta/preview status
-- Regional availability
-
-### Outdated Information
-- Sunset features still listed
-- Old screenshots
-- Previous pricing
-- Legacy integrations
-
-## Accuracy Levels
-
-| Level | Description | Score Impact |
-|-------|-------------|--------------|
-| Exact | Perfect match to docs | +10 |
-| Equivalent | Same meaning, different words | +8 |
-| Simplified | Accurate but less detail | +5 |
-| Overstated | Exceeds actual capability | -15 |
-| Outdated | No longer accurate | -10 |
-| Wrong | Incorrect information | -25 |
-
-## Output
-
-```yaml
-feature_accuracy:
-  total_features: 20
-  exact: 12
-  equivalent: 5
-  simplified: 2
-  overstated: 1
-  outdated: 0
-  wrong: 0
-  accuracy_score: 88
-  inventory:
-    - feature: "AI-powered document analysis"
-      content_description: "Automatically analyzes and extracts data from any document"
-      docs_description: "Analyzes structured documents (PDFs, forms) with 95% accuracy"
-      status: "overstated"
-      issue: "'Any document' overstates; structured docs only"
-      recommendation: "Change to 'structured documents like PDFs and forms'"
-    - feature: "Slack integration"
-      content_description: "Connect with Slack"
-      docs_description: "Full Slack integration with notifications, commands, and workflows"
-      status: "simplified"
-      issue: "Could highlight more capabilities"
-      recommendation: "Add specific Slack capabilities"
-  missing_from_content:
-    - feature: "Microsoft Teams integration"
-      note: "Recently launched, not yet on website"
-  missing_from_docs:
-    - feature: "Custom AI training"
-      note: "Mentioned on website but not in product docs"
-      action: "Verify if feature exists, update docs or remove from site"
-```

package/template/workers/content-product/skills/stats-check.md

@@ -1,128 +0,0 @@
-# Skill: Stats Check
-
-Validate statistics and metrics for accuracy and currency.
-
-## Input
-
-- Page content JSON
-- Metrics database
-- Publication dates
-
-## Process
-
-1. **Extract all statistics**
-   - Percentages
-   - Counts
-   - Financial figures
-   - Time-based metrics
-
-2. **Identify source**
-   - Internal data
-   - Customer data
-   - Third-party research
-   - Unknown/unattributed
-
-3. **Verify accuracy**
-   - Match to source
-   - Check calculation
-   - Validate methodology
-
-4. **Check currency**
-   - Data collection date
-   - Update frequency
-   - Staleness threshold
-
-## Statistics Categories
-
-### Company Metrics
-- Customer count
-- Revenue figures
-- Growth rates
-- Team size
-
-### Product Metrics
-- Feature counts
-- Performance benchmarks
-- Uptime statistics
-- Usage volumes
-
-### Customer Outcomes
-- ROI figures
-- Efficiency gains
-- Cost savings
-- Time reductions
-
-### Market Data
-- Market size
-- Industry growth
-- Competitive position
-- Analyst ratings
-
-## Verification Checklist
-
-### Accuracy Checks
-- [ ] Number matches source exactly
-- [ ] Calculation methodology correct
-- [ ] Sample size appropriate
-- [ ] Context preserved
-
-### Currency Checks
-- [ ] Data collected within 12 months
-- [ ] Reflects current product state
-- [ ] Market data still relevant
-- [ ] Customer still active
-
-### Attribution Checks
-- [ ] Source clearly stated
-- [ ] Link to full study (if third-party)
-- [ ] Customer permission (if named)
-- [ ] Methodology available
-
-## Red Flags
-
-| Issue | Example | Action |
-|-------|---------|--------|
-| Round numbers | "Exactly 50% improvement" | Verify exact figure |
-| Extreme claims | "99.999% uptime" | Verify SLA |
-| Old data | "2022 study shows..." | Update or remove |
-| Unattributed | "Studies show..." | Find source or remove |
-| Aggregated | "Customers report..." | Get specific examples |
-
-## Output
-
-```yaml
-stats_check:
-  total_stats: 12
-  verified: 8
-  outdated: 2
-  unverified: 1
-  inaccurate: 1
-  inventory:
-    - stat: "500+ customers"
-      value: 500
-      actual: 523
-      status: "verified"
-      source: "CRM as of 2026-01"
-      recommendation: "Update to current count"
-    - stat: "99.9% uptime"
-      value: 99.9
-      actual: 99.95
-      status: "verified"
-      source: "Status page, 12-month average"
-    - stat: "40% faster than alternatives"
-      value: 40
-      actual: null
-      status: "unverified"
-      source: null
-      recommendation: "Remove or provide benchmark source"
-    - stat: "Used by 3 of top 5 banks"
-      value: 3
-      actual: 2
-      status: "inaccurate"
-      source: "Customer list"
-      recommendation: "Correct to '2 of top 5' or verify"
-  currency_issues:
-    - stat: "Industry grew 25% in 2024"
-      issue: "Outdated market data"
-      recommendation: "Update with 2025 figures"
-```

package/template/workers/content-product/worker.yaml

@@ -1,97 +0,0 @@
-worker:
-  id: content-product
-  name: "Content Worker - Product Accuracy"
-  type: ContentWorker
-  version: "1.0"
-
-execution:
-  mode: on_demand
-  max_runtime: 5m
-
-context:
-  base:
-    - workers/public/content-product/
-    - workers/public/content-shared/
-    - companies/example-company/knowledge/products/
-    - companies/example-company/knowledge/metrics.md
-  exclude:
-    - node_modules/
-    - dist/
-
-output:
-  destination: workspace/reports/content/
-  format: markdown
-  naming: "{date}-content-product-{page}.md"
-
-skills:
-  - claim-verification
-  - stats-check
-  - feature-accuracy
-
-instructions: |
-  Product Accuracy Analyst for ExampleCo
-
-  Purpose: Verify product claims, feature accuracy, and statistics validity across website content.
-
-  ## Analysis Process
-  1. Load page content from content/ directory
-  2. Extract all product claims and statistics
-  3. Cross-reference with product documentation
-  4. Flag unverifiable or inaccurate content
-
-  ## Verification Categories
-  - Feature claims (0-100): Features accurately described
-  - Statistics accuracy (0-100): Numbers verifiable and current
-  - Technical correctness (0-100): Technical details accurate
-  - Consistency (0-100): Claims match across pages
-
-  ## Claim Types to Verify
-
-  ### Feature Claims
-  - Product capabilities
-  - Integration claims
-  - Platform support
-  - Functionality descriptions
-
-  ### Performance Claims
-  - Speed/efficiency metrics
-  - Scale capabilities
-  - Uptime/availability
-  - Processing volumes
-
-  ### Business Impact Claims
-  - ROI figures
-  - Cost savings
-  - Time savings
-  - Efficiency improvements
-
-  ### Comparison Claims
-  - "Better than X"
-  - "Only solution that..."
-  - Industry position claims
-  - Competitive differentiators
-
-  ## Verification Sources
-  - products/: Official product documentation
-  - metrics.md: Verified company metrics
-  - Case studies: Customer-validated results
-  - Third-party: External validation
-
-  ## Red Flags
-  - Unsubstantiated percentages
-  - Vague superlatives ("best", "fastest")
-  - Outdated statistics
-  - Feature claims not in product docs
-  - Inconsistent numbers across pages
-  - Missing source attribution
-
-  ## Output
-  Generate markdown report with:
-  - Accuracy score by category
-  - Claim inventory with verification status
-  - Flagged issues with evidence
-  - Recommendations for correction
-
-  ## Knowledge Dependencies
-  - products/: Official feature documentation
-  - metrics.md: Verified statistics and metrics

package/template/workers/content-sales/README.md

@@ -1,70 +0,0 @@
-# Content Worker: Conversion Copy
-
-Conversion optimization analysis worker for ExampleCo content.
-
-## Purpose
-
-Analyzes website content for conversion effectiveness, CTA quality, and value proposition clarity. Identifies opportunities to improve lead generation and user journey optimization.
-
-## Skills
-
-| Skill | Description |
-|-------|-------------|
-| conversion-analysis | Overall conversion optimization assessment |
-| cta-audit | Evaluate CTA placement, copy, and effectiveness |
-| value-prop-check | Assess value proposition clarity and impact |
-
-## Knowledge Sources
-
-- `companies/example-company/knowledge/verticals/` - Vertical-specific messaging
-- `companies/example-company/knowledge/campaign-playbook.md` - Campaign strategy
-
-## Scoring Categories
-
-| Category | Weight | Description |
-|----------|--------|-------------|
-| CTA Effectiveness | 30% | Clear, compelling, well-placed CTAs |
-| Value Proposition | 30% | Benefits clear and differentiated |
-| Persuasion Elements | 20% | Social proof, trust signals |
-| Conversion Path | 20% | Clear journey, low friction |
-
-## Conversion Principles
-
-1. **Clarity over Cleverness** - User should instantly understand offer
-2. **Benefit-First CTAs** - State what user gets, not what they do
-3. **Strategic Placement** - CTAs where intent is highest
-4. **Reduce Friction** - Minimize steps to conversion
-5. **Build Trust** - Social proof before asking for action
-
-## Usage
-
-```bash
-# Run via HQ
-/run content-sales --page homepage
-
-# Or directly
-cd workers/content-sales
-npx ts-node src/analyze.ts --input content/homepage.json
-```
-
-## Output
-
-Reports go to `workspace/reports/content/` with format:
-- `{date}-content-sales-{page}.md`
-
-## CTA Rating Scale
-
-| Rating | Description |
-|--------|-------------|
-| A | Optimal - clear, compelling, well-placed |
-| B | Good - minor improvements possible |
-| C | Adequate - noticeable issues |
-| D | Poor - significant problems |
-| F | Failed - missing or ineffective |
-
-## Integration
-
-Part of the Content Team worker group. Works alongside:
-- content-brand (voice consistency)
-- content-product (accuracy verification)
-- content-legal (compliance checking)

package/template/workers/content-sales/skills/conversion-analysis.md

@@ -1,96 +0,0 @@
-# Skill: Conversion Analysis
-
-Comprehensive conversion optimization assessment for page content.
-
-## Input
-
-- Page content JSON
-- Page type and conversion goal
-
-## Process
-
-1. **Identify page conversion goal**
-   - Primary action (demo, signup, download)
-   - Secondary actions
-   - Micro-conversions
-
-2. **Audit conversion elements**
-   - CTA presence and quality
-   - Value proposition visibility
-   - Trust signals
-   - Friction points
-
-3. **Analyze user journey**
-   - Entry point clarity
-   - Information hierarchy
-   - Decision support
-   - Exit paths
-
-4. **Score conversion readiness**
-   - Element presence
-   - Element quality
-   - Strategic placement
-   - Overall optimization
-
-## Conversion Element Checklist
-
-### Above the Fold
-- [ ] Clear headline with value prop
-- [ ] Primary CTA visible
-- [ ] Supporting visual
-- [ ] Trust indicator
-
-### Body Content
-- [ ] Benefits clearly stated
-- [ ] Features connected to outcomes
-- [ ] Social proof present
-- [ ] Objection handling
-
-### Conversion Points
-- [ ] Multiple CTA placements
-- [ ] Varied CTA types (primary/secondary)
-- [ ] Low-commitment options
-- [ ] Clear next steps
-
-## Scoring Matrix
-
-| Element | Weight | Criteria |
-|---------|--------|----------|
-| Hero Section | 25% | Value prop, CTA, clarity |
-| Social Proof | 20% | Testimonials, logos, stats |
-| Benefit Clarity | 20% | Outcomes, not features |
-| CTA Strategy | 20% | Placement, copy, variety |
-| Trust Elements | 15% | Security, guarantees, authority |
-
-## Output
-
-```yaml
-conversion_score: 72
-page_type: "product"
-primary_goal: "Demo request"
-elements:
-  hero:
-    score: 80
-    has_value_prop: true
-    has_cta: true
-    clarity: "good"
-  social_proof:
-    score: 60
-    testimonials: 0
-    logos: 5
-    stats: 2
-  ctas:
-    count: 4
-    primary: 2
-    secondary: 2
-    effectiveness: 75
-friction_points:
-  - "No testimonials on product page"
-  - "Form requires too many fields"
-  - "Secondary CTA competes with primary"
-recommendations:
-  - priority: "high"
-    action: "Add customer testimonial to hero"
-  - priority: "medium"
-    action: "Reduce form fields to 3"
-```