obsidian/01 Projects/modcomms/USER_MANUAL.md
2026-05-18 19:08:07 +01:00

3.6 KiB

auto_generated manual_updated_at modified
true 2026-05-18 2026-05-18

Mod Comms User Manual

What This Tool Does

Mod Comms is an AI-powered proof review tool designed for Barclays marketing materials. It utilizes a multi-agent AI system to analyze uploaded marketing assets for:

  • Legal Compliance: Advertising standards, disclaimers, and financial promotion detection.
  • Brand Adherence: Logo usage, color palette accuracy, and typo checking.
  • Tone of Voice: Voice and clarity analysis.
  • Channel Suitability: Platform-specific specifications.

The system provides real-time feedback via WebSocket streaming, allowing you to see the progress of analysis as it happens.

Who Uses It

  • Super Admins: Full access to all features including user management, settings, and knowledge base.
  • Oversight Admins: Can manage campaigns, view analytics, and audit trails.
  • Agency Admins: Can manage agency-specific campaigns and view analytics.
  • Basic Users: Can upload proofs, view feedback, and use the WIP Reviewer.
  • Agency Users: Can upload proofs and collaborate on agency campaigns.

How to Access

  1. Navigate to the Mod Comms URL.
  2. You will be prompted to log in using your corporate Microsoft account (SSO via Azure AD).
  3. Once authenticated, you will be taken to the Home Dashboard.

Main Workflows

1. Analyzing a Marketing Proof

  1. From the Home Dashboard or Sidebar, select "Home" or "Campaigns".
  2. Click "Upload Proof" or drag and drop an asset (PDF, Image, etc.).
  3. Select the relevant Campaign, Channel, SubChannel, and Proof Type from the dropdowns.
  4. The multi-agent system will begin analyzing the asset in parallel.
  5. Watch the Real-Time Feedback panel for live updates from the Legal, Brand, Tone, and Channel agents.
  6. Review the final verdict (Red/Amber/Green) and detailed feedback from the Lead Agent.
  7. Resolve flagged items by clicking on them and adding comments or marking them as resolved.
  8. Optionally, generate a PDF Report of the analysis.

2. Managing Campaigns

  1. Navigate to "Campaigns" in the sidebar.
  2. Create a new campaign or select an existing one.
  3. Organize proofs within the campaign.
  4. View version history for each proof to track changes over time.

3. WIP Reviewer

  1. Select "WIP Reviewer" from the sidebar.
  2. Upload work-in-progress assets for early-stage creative feedback.
  3. Receive targeted feedback from the AI agents specifically tailored for incomplete drafts.

4. Viewing Analytics

  1. Navigate to "Analytics".
  2. View compliance metrics, status breakdowns (Red/Amber/Green ratios), and trends.
  3. Filter by campaign, channel, or date range.

5. Auditing

  1. Navigate to "Auditing" (Admins only).
  2. View the full audit trail of all flagged issues and their resolutions.

FAQ

Q: How does the multi-agent system work? A: Four specialist agents (Legal, Brand, Tone, Channel) analyze the asset in parallel. A Lead Agent then synthesizes their findings into a final verdict with a RAG (Red/Amber/Green) status.

Q: What types of files can I upload? A: Currently, PDFs and common image formats are supported for proof review.

Q: Who can manage users? A: Only Super Admins and Oversight Admins have access to the "User Management" section.

Q: Can I export the analysis results? A: Yes, you can generate professional PDF reports of the analysis results for each proof.

Q: What happens if the analysis fails? A: You will receive an error message. Check the "Profile" section for your account status or contact your Super Admin if issues persist.