review-synthesis

namespace	aiwg
name	review-synthesis
platforms	["all"]
description	Aggregate multi-reviewer feedback into consolidated, prioritized, and actionable recommendations

review-synthesis

Aggregate multi-reviewer feedback into consolidated, actionable recommendations.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "merge reviews" → multi-reviewer feedback synthesis
• "synthesize feedback" → review consolidation

Purpose

This skill aggregates feedback from multiple reviewers into cohesive, prioritized recommendations by:

• Collecting feedback from parallel review processes
• Identifying consensus and conflicts
• Prioritizing by impact and frequency
• Resolving contradictions with rationale
• Generating actionable synthesis reports

Behavior

When triggered, this skill:

1. Collects review inputs:

   • Gather all reviewer feedback files
   • Parse structured and unstructured comments
   • Identify reviewer roles and expertise areas

2. Categorizes feedback:

   • Group by feedback type (content, design, technical, legal)
   • Tag by severity (blocking, major, minor, suggestion)
   • Map to asset sections/elements

3. Identifies patterns:

   • Find consensus (multiple reviewers agree)
   • Detect conflicts (reviewers disagree)
   • Note unique insights (single reviewer)

4. Resolves conflicts:

   • Apply priority rules
   • Document both positions
   • Provide resolution rationale
   • Flag for escalation if needed

5. Prioritizes actions:

   • Rank by business impact
   • Consider implementation effort
   • Group quick wins vs major changes

6. Generates synthesis:

   • Executive summary
   • Detailed action items
   • Conflict resolution notes
   • Approval recommendations

Review Categories

Content Reviews

content_feedback:
  sources:
    - content-writer
    - editor
    - copywriter
    - content-strategist

  aspects:
    - messaging_clarity
    - value_proposition
    - tone_voice
    - cta_effectiveness
    - audience_alignment

  weight: high
  priority_in_conflict: medium

Brand Reviews

brand_feedback:
  sources:
    - brand-guardian
    - creative-director
    - art-director

  aspects:
    - visual_identity
    - verbal_identity
    - brand_consistency
    - guideline_compliance

  weight: high
  priority_in_conflict: high

Technical Reviews

technical_feedback:
  sources:
    - quality-controller
    - production-coordinator
    - technical-marketing-writer

  aspects:
    - specifications
    - file_formats
    - rendering_quality
    - platform_compatibility

  weight: medium
  priority_in_conflict: high_for_blocking

Legal Reviews

legal_feedback:
  sources:
    - legal-reviewer
    - legal-liaison

  aspects:
    - claims_substantiation
    - disclosures
    - trademark_usage
    - regulatory_compliance

  weight: critical
  priority_in_conflict: highest

Strategic Reviews

strategic_feedback:
  sources:
    - campaign-strategist
    - marketing-analyst
    - positioning-specialist

  aspects:
    - campaign_alignment
    - competitive_positioning
    - market_fit
    - kpi_potential

  weight: medium
  priority_in_conflict: medium

Conflict Resolution Rules

Priority Hierarchy

conflict_resolution:
  priority_order:
    1: legal_compliance  # Always wins
    2: brand_guidelines  # Strong preference
    3: technical_requirements  # If blocking
    4: strategic_alignment  # Business logic
    5: content_preference  # Style choices
    6: design_preference  # Aesthetic choices

  escalation_triggers:
    - legal_vs_brand
    - strategy_vs_brand
    - multiple_blockers
    - no_clear_winner

  resolution_methods:
    consensus: Majority agreement (3+ reviewers)
    expertise: Defer to domain expert
    priority: Apply priority hierarchy
    escalate: Flag for stakeholder decision

Conflict Types

conflict_types:
  direct_contradiction:
    description: Reviewer A says X, Reviewer B says not-X
    resolution: Apply priority hierarchy
    documentation: Required

  style_preference:
    description: Different aesthetic preferences
    resolution: Defer to brand/creative director
    documentation: Optional

  scope_disagreement:
    description: Disagree on what needs changing
    resolution: Defer to strategic alignment
    documentation: Required

  priority_disagreement:
    description: Agree on issue, disagree on severity
    resolution: Take higher severity
    documentation: 

Synthesis Report Format

# Review Synthesis Report

**Asset**: Q1 Product Launch Campaign - Landing Page
**Reviews Collected**: 6
**Date**: 2025-12-08
**Synthesizer**: review-synthesis skill

## Executive Summary

| Metric | Count |
|--------|-------|
| Total Comments | 47 |
| Consensus Items | 28 |
| Conflicts Resolved | 8 |
| Escalations Needed | 2 |
| Blocking Issues | 3 |
| Major Issues | 12 |
| Minor Issues | 25 |
| Suggestions | 7 |

**Overall Assessment**: Asset requires revisions before approval.

## Reviewer Participation

| Reviewer | Role | Comments | Focus Areas |
|----------|------|----------|-------------|
| Sarah Chen | Brand Guardian | 12 | Visual identity, logo usage |
| Marcus Johnson | Editor | 8 | Copy clarity, grammar |
| Elena Rodriguez | Legal Reviewer | 5 | Claims, disclosures |
| David Kim | Campaign Strategist | 10 | Messaging, positioning |
| Amy Liu | Quality Controller | 7 | Technical specs |
| James Wilson | Creative Director | 5 | Overall creative |

## Consensus Items (High Confidence)

### 1. Hero Headline Needs Strengthening
- **Reviewers**: Sarah, Marcus, David (3/6 = consensus)
- **Current**: "Introducing Our New Product"
- **Issue**: Generic, doesn't communicate value
- **Recommendation**: "Cut Your Workflow Time in Half"
- **Priority**: High
- **Effort**: Low (copy change only)

### 2. CTA Button Color
- **Reviewers**: Sarah, Amy, James (3/6 = consensus)
- **Current**: Light gray (#CCCCCC)
- **Issue**: Low contrast, doesn't stand out
- **Recommendation**: Brand green (#00AA55)
- **Priority**: High
- **Effort**: Low


 : Elena (legal = authoritative)
 : Form collects email without privacy notice
 : Add privacy policy link
 : Blocking
 : Low




  (Sarah, Brand Guardian): Use lifestyle photography
  (James, Creative Director): Use product-only shots
 : Lifestyle photography
 : Brand guidelines specify lifestyle imagery for hero sections
 : Brand guidelines (priority 2)


  (Marcus, Editor): Professional, formal tone
  (David, Strategist): Casual, conversational tone
 : Professional with conversational elements
 : Hybrid approach matches brand voice profile (Friendly Professional)
 : Brand alignment via voice profile


  (David, Strategist): Show all 10 features
  (Sarah, Brand Guardian): Limit to top 5
 : Top 5 features with "See all features" link
 : Balances completeness with visual clarity
 : Consensus via compromise




 : Whether to show pricing on landing page
  (David): Show pricing for transparency
  (Marcus): Hide pricing, focus on value
 : Strategic decision beyond reviewer authority
 : Marketing Director
 : Before final approval


 : Include comparison chart with competitors?
  (David): Yes, differentiates product
  (Elena): Risk of legal issues without substantiation
 : Legal/strategy conflict
 : Marketing Director + Legal
 : Before final approval





| # | Item | Owner | Effort | Source |
|---|------|-------|--------|--------|
| 1 | Add privacy disclosure | Legal | 15 min | Elena |
| 2 | Fix contrast ratio on CTA | Design | 10 min | Consensus |
| 3 | Add alt text to images | Tech | 20 min | Amy |



| # | Item | Owner | Effort | Source |
|---|------|-------|--------|--------|
| 4 | Revise hero headline | Copy | 30 min | Consensus |
| 5 | Update product image style | Design | 2 hrs | Conflict resolution |
| 6 | Add feature limit with "more" link | Dev | 1 hr | Conflict resolution |



| # | Item | Owner | Effort | Source |
|---|------|-------|--------|--------|
| 7 | Tighten body copy | Copy | 45 min | Marcus |
| 8 | Adjust mobile spacing | Dev | 30 min | Amy |
| 9 | Update testimonial format | Design | 1 hr | Sarah |



| # | Item | Owner | Effort | Source |
|---|------|-------|--------|--------|
| 10 | Consider A/B test on CTA copy | Strategy | - | David |
| 11 | Add social proof counter | Dev | 2 hrs | James |
| 12 | Optimize image file sizes | Tech | 30 min | Amy |



: 12 action items
: 8.5 hours
: 3 (must fix before approval)
: 2 (need stakeholder decision)



 [ ] Complete blocking fixes (3 items)
 [ ] Resolve escalations with Marketing Director
 [ ] Complete high-priority items (3 items)
 [ ] Re-review by Brand Guardian
 [ ] Legal sign-off (if escalation resolved)
 [ ] Final approval




[Full feedback text...]


[Full feedback text...]

[etc.]

Usage Examples

Full Synthesis

User: "Synthesize reviews for the landing page"

Skill processes:
1. Collect reviews from .aiwg/marketing/reviews/landing-page/
2. Parse 47 total comments
3. Categorize by type and severity
4. Identify 28 consensus items
5. Resolve 8 conflicts
6. Flag 2 escalations
7. Generate prioritized action list

Output:
"Review Synthesis Complete

6 reviewers, 47 comments analyzed:
- Consensus items: 28
- Conflicts resolved: 8
- Escalations needed: 2

Blocking Issues (3):
1. Missing privacy disclosure
2. CTA contrast ratio
3. Missing alt text

Key Conflicts Resolved:
- Image style: Lifestyle (brand guidelines win)
- Headline tone: Professional with conversational elements

Report: .aiwg/marketing/synthesis/landing-page-synthesis.md"

Conflict Focus

User: "What conflicts exist in the reviews?"

Skill identifies:
- Direct contradictions
- Style disagreements
- Priority conflicts

Output:
"8 Conflicts Found:

Resolved (6):
1. Image style (lifestyle vs product-only) → Lifestyle
2. Headline tone (formal vs casual) → Hybrid
3. Feature count (10 vs 5) → 5 with link

Needs Escalation (2):
1. Pricing display - strategic decision
2. Competitor comparison - legal concern

See full rationale in synthesis report."

Quick Summary

User: "Summarize all feedback"

Skill generates:
- Comment counts
- Key themes
- Top action items

Output:
"Review Summary:

Top 3 Themes:
1. CTA needs more visibility (4 reviewers)
2. Hero messaging too generic (3 reviewers)
3. Legal disclosures missing (blocker)

Estimated Revision Effort: 8.5 hours
Blocking Items: 3
Approval ETA: After escalation decisions"

Integration

This skill uses:

• parallel-dispatch: Launch multiple reviewers
• artifact-metadata: Track review status
• project-awareness: Context for priority decisions

Agent Orchestration

synthesis_workflow:
  input_agents:
    - brand-guardian
    - editor
    - legal-reviewer
    - campaign-strategist
    - quality-controller
    - creative-director

  synthesis_agent: documentation-synthesizer

  escalation_path:
    - marketing-project-manager
    - creative-director
    - legal-liaison

Configuration

Synthesis Rules

synthesis_config:
  consensus_threshold: 3  # reviewers for consensus
  auto_resolve_style: true  # resolve style conflicts automatically
  escalation_timeout: 48h  # escalate if no decision

  priority_weights:
    legal: 100
    brand: 80
    technical_blocking: 75
    strategic: 60
    content: 50
    design: 40

Output Settings

output_config:
  include_raw_feedback: true
  anonymize_reviewers: false
  generate_action_tickets: true
  notify_escalation_owners: true

Output Locations

• Synthesis reports: .aiwg/marketing/synthesis/{asset}-synthesis.md
• Action items: .aiwg/marketing/synthesis/{asset}-actions.json
• Escalation log: .aiwg/marketing/escalations/
• Raw feedback archive: .aiwg/marketing/reviews/{asset}/

References

• Review templates: templates/governance/review-checklist.md
• Conflict resolution guide: docs/conflict-resolution.md
• Escalation procedures: docs/escalation-process.md