System: MWMS
Document Type: Framework
Authority Level: MCR Source Of Truth
Status: Draft For MCR
Primary Location: MCR
Future Operational Destination: HeadOffice Brain, MWMS Brain, Brain Room, AI Manager, AI Employee Router, Task Executor Systems, Newsletter Intelligence, Routed Actions, HeadOffice Dashboard, Finance Brain, Experimentation Brain, Ads Brain, Affiliate Brain, AI Business Systems Brain
Parent Page: HeadOffice
Owner: Martyn
Developer Boundary: Do Not Touch M’s Active Build Areas Unless Specifically Assigned
Source Of Truth: MCR
Purpose
The purpose of this document is to define the MWMS Analytics And Visualization Workflow Framework.
This framework explains how MWMS turns clean structured records, data, reports, signals, outcomes, failures, experiments, financial notes, and operational activity into useful analytics and visual decision-support outputs.
MWMS does not need visual dashboards for decoration.
MWMS needs analytics and visualization systems that help HeadOffice and the Brains understand:
- what is happening
- what is changing
- what matters
- what needs attention
- what is improving
- what is failing
- what should be acted on
- what should be monitored
- what should be ignored
- what should be escalated
- what should be reported to future clients
Analytics and visualization must help decisions.
The goal is not to create more charts.
The goal is to turn structured data into clear operational intelligence.
Scope
This framework applies to all MWMS analytics, visualization, dashboard, reporting, and insight-display workflows.
This includes analytics and visualization for:
- HeadOffice Dashboard
- Newsletter Intelligence
- Routed Actions
- Brain Room activity
- AI Employee outcomes
- AI Employee failures
- Permission Gatekeeper records
- Operational Decision records
- Structured Analysis records
- Forecasting and Scenario Planning records
- Course Absorption progress
- Opportunity System
- Affiliate offer pipeline
- Research Brain findings
- Finance Brain exposure
- Experimentation Brain test results
- Ads Brain performance
- Content Brain production
- M developer progress
- system stability reporting
- recurring reports
- future AIBS client dashboards
- future AIBS client reports
This framework applies before any visual output is treated as operationally useful, dashboard-ready, client-ready, or suitable for automation.
This framework does not authorize technical development, dashboard build work, database schema changes, plugin/UI work, client delivery, or automation by itself.
It defines the analytics and visualization discipline MWMS must use before build.
Core Definition
Analytics is the process of turning structured data into useful interpretation.
Visualization is the process of presenting that interpretation in a form that makes patterns, priorities, risks, and decisions easier to understand.
Analytics answers:
What does the data mean?
Visualization answers:
How should this meaning be shown so the right person can understand and act?
A good MWMS analytics workflow does not only produce numbers.
It produces:
- clean metrics
- patterns
- comparisons
- trends
- exceptions
- risks
- priorities
- insight summaries
- recommended actions
- decision-ready dashboard items
Core Principle
The core principle of this framework is:
Visuals must clarify decisions, not decorate data.
A chart, table, card, graph, panel, or dashboard is only useful if it helps MWMS decide faster, safer, or better.
A visual output fails if it:
- looks impressive but does not guide action
- displays too many numbers
- hides data quality issues
- lacks context
- lacks owner or next action
- treats weak data as strong
- shows stale information as current
- creates dashboard clutter
- distracts HeadOffice from real priorities
Visualization should reduce cognitive load.
It should not create another layer of noise.
Analytics And Visualization Workflow
The MWMS Analytics And Visualization Workflow has ten stages:
- Define The Decision Need
- Confirm Data Source
- Check Schema Quality
- Clean And Filter Data
- Select Metrics
- Analyze Patterns
- Choose Visualization Format
- Add Insight Summary
- Validate Dashboard Readiness
- Route, Review, And Improve
1. Define The Decision Need
Every analytics or visualization output must begin with a decision need.
Examples:
- What needs HeadOffice attention this week?
- Which newsletter signals are action-worthy?
- Which routed actions are blocked?
- Which AI Employees are producing useful outcomes?
- Which failures are recurring?
- Which offers are ready for Research Brain?
- Which experiments are worth continuing?
- Which finance risks need review?
- Which dashboard cards should be ACT NOW?
- Which client KPI needs explanation?
Decision Need Rule:
Do not visualize data until the decision need is clear.
Without a decision need, visualization becomes decoration.
2. Confirm Data Source
The data source must be known before analysis begins.
Possible sources:
- Supabase records
- WordPress/MCR records
- newsletter_intelligence table
- Routed Actions records
- Brain Room messages
- AI Agent Failure Logs
- AI Agent Outcome Logs
- Operational Decision records
- Structured Analysis records
- Forecasting records
- Permission Gatekeeper records
- Finance records
- Experimentation results
- Ads platform metrics
- Google Sheets
- M developer updates
- manually supplied data
- future client system data
Data Source Rule:
Analytics must be source-grounded.
If the source is unclear, the visual should not be trusted.
3. Check Schema Quality
Analytics depends on clean schema.
Before visualizing, MWMS must check:
- required fields exist
- field names are stable
- allowed values are respected
- status values are consistent
- risk levels are consistent
- owners are assigned
- dates are usable
- records are not malformed
- duplicates are controlled
- missing values are marked
- stale records are identified
Schema Quality Rule:
Dirty schema creates misleading dashboards.
If schema quality is weak, the correct action is to fix schema or data first, not build better visuals.
4. Clean And Filter Data
Raw data must be cleaned and filtered before analytics.
Cleaning may include:
- removing duplicates
- excluding rejected records
- separating parked records
- filtering stale items
- removing test records
- grouping similar items
- correcting obvious malformed fields
- identifying missing owners
- identifying missing status
- excluding unvalidated records from active dashboards
- separating draft from approved items
Cleaning Rule:
A dashboard should not amplify raw clutter.
Only cleaned and classified data should feed decision views.
5. Select Metrics
MWMS must select metrics that support the decision need.
Good metrics are:
- relevant
- understandable
- current
- comparable
- actionable
- tied to an owner or decision
- connected to risk, outcome, or progress
Poor metrics are:
- vanity numbers
- too broad
- stale
- disconnected from action
- hard to interpret
- included because they are easy to count
Metric Selection Rule:
Track what helps MWMS decide, not everything that can be counted.
6. Analyze Patterns
Analytics should detect patterns before visualization.
Patterns may include:
- rising number of blocked actions
- repeated failure type
- repeated newsletter signal
- increasing finance exposure
- recurring missing owner
- repeated schema failure
- offer pipeline bottleneck
- experiment performance trend
- M task blockage pattern
- AI Employee usefulness pattern
- dashboard item ageing
- client workflow risk pattern
Pattern Rule:
Visualization should show the pattern, not just the data point.
A single number may be useful, but patterns are often more actionable.
7. Choose Visualization Format
The visualization format must match the data and decision need.
Possible formats:
- KPI card
- status card
- priority card
- risk alert
- bar chart
- line chart
- table
- scorecard
- trend summary
- funnel view
- queue view
- matrix
- timeline
- comparison panel
- progress tracker
- heat map
- action list
- dashboard card
- report section
Visualization Format Rule:
Use the simplest visual that makes the decision clearer.
Do not use complex charts when a clear card or table is better.
8. Add Insight Summary
A visual should include a short explanation of what it means.
A good insight summary includes:
- what changed
- why it matters
- risk or opportunity
- recommended action
- owner or next step
- confidence where needed
Bad insight summaries say only:
- “data increased”
- “performance changed”
- “more items appeared”
- “dashboard updated”
Insight Summary Rule:
A number without meaning is not intelligence.
Every important visual should explain the decision relevance.
9. Validate Dashboard Readiness
Before visual output becomes active, MWMS must validate it.
Dashboard readiness checks:
- source is known
- data is clean
- schema is valid
- metric is useful
- visual is readable
- insight summary is clear
- action is specific
- owner is known where needed
- status is accurate
- risk level is visible
- stale data is marked
- human review required where needed
- dashboard does not create noise
Dashboard Readiness Rule:
Visual output should be reviewed before it becomes operational display.
A weak dashboard can mislead HeadOffice.
10. Route, Review, And Improve
After validation, analytics output should be routed.
Possible destinations:
- HeadOffice Dashboard
- Newsletter Queue Review
- Routed Actions
- Brain Room
- Finance Brain
- Experimentation Brain
- Ads Brain
- Affiliate Brain
- Research Brain
- Recurring Reports
- Parking System
- Failure Log
- Outcome Log
- future client review dashboard
Analytics should improve over time.
If a visual is not used, not understood, or not helping decisions, it should be revised, parked, or retired.
Improvement Rule:
Dashboards should be judged by decision value, not visual polish.
Analytics Output Types
MWMS recognizes the following analytics output types.
1. KPI Card
Used to show one important number or state.
Examples:
- Open Routed Actions
- Critical Risks
- Active ACT NOW Items
- Failed Validations This Week
- Completed Outcomes
- M Blockers
- Finance Exposure
- Active Experiments
Best for:
- quick HeadOffice visibility
- dashboard top layer
- weekly summaries
Rule:
KPI cards should be few, clear, and decision-relevant.
2. Insight Card
Used to explain a specific insight.
Examples:
- “Newsletter signals about Google AI shopping are increasing.”
- “Developer handoffs are being blocked by missing file evidence.”
- “Offer evaluations are waiting on Finance assumptions.”
- “Repeated schema failures are slowing automation readiness.”
Best for:
- HeadOffice attention
- routed action creation
- issue review
- report summaries
Rule:
Insight cards must explain meaning and next action.
3. Risk Alert
Used to highlight risk.
Examples:
- High-priority routed action overdue
- Client report lacks approval
- Finance exposure increasing
- M task lacks file path
- Dashboard data stale
- Validation failure repeated
Best for:
- HeadOffice risk review
- escalation
- action prioritization
Rule:
Risk alerts must include owner and next action.
4. Queue View
Used to show items waiting for decision.
Examples:
- Newsletter Queue Review
- Routed Actions
- Offer Evaluation Queue
- Course Absorption Queue
- Validation Queue
- M Developer Queue
- Failure Review Queue
Best for:
- operational workflow management
Rule:
Queue views must show status, owner, priority, and next action.
5. Trend View
Used to show change over time.
Examples:
- newsletter signals per week
- AI Employee outcomes per month
- failure types over time
- routed action volume
- completed tasks
- experiment performance
- finance exposure
Best for:
- pattern detection
- recurring reports
- HeadOffice review
Rule:
Trend views must include time range and source quality.
6. Comparison View
Used to compare options, Brains, offers, campaigns, or scenarios.
Examples:
- offer comparison
- scenario comparison
- campaign performance comparison
- AI Employee outcome comparison
- tool comparison
- client workflow comparison
Best for:
- decision support
Rule:
Comparison views must use consistent criteria.
7. Funnel View
Used when work moves through stages.
Examples:
- opportunity intake to research to finance to experiment
- newsletter signal to review to routed action
- course lesson to absorption to page creation
- client workflow to report to approval
Best for:
- bottleneck detection
Rule:
Funnel views must reveal where items drop, stall, or fail.
8. Scorecard
Used to evaluate performance or readiness.
Examples:
- AI Employee usefulness scorecard
- offer readiness scorecard
- workflow automation readiness scorecard
- client reporting readiness scorecard
- MCR page quality scorecard
Best for:
- governance review
- readiness checks
- Kaizen improvement
Rule:
Scorecards must explain what the score means and what to do next.
9. Report Summary Panel
Used inside recurring reports.
Examples:
- Weekly HeadOffice Report
- Weekly Kaizen Digest
- AI Employee Outcome Review
- Failure Review
- Newsletter Digest
- Future Client Weekly Report
Best for:
- repeated operational summaries
Rule:
Report panels must summarize meaning, not just repeat numbers.
10. Client Dashboard View
Used for future AIBS client-facing reporting.
Examples:
- client workflow health
- client task status
- client risk summary
- client recommendation panel
- client operational KPI
Best for:
- reviewed, simplified business reporting
Rule:
Client dashboard views require stricter validation, privacy protection, and human approval.
Visualization Format Selection Rules
Use KPI Cards When
- one number matters
- decision needs speed
- HeadOffice needs quick status
- metric is stable and trusted
Use Tables When
- details matter
- multiple fields must be compared
- queue management is needed
- owner/status/next action must be visible
Use Line Charts When
- time trend matters
- change over time is the key insight
- repeated monitoring is needed
Use Bar Charts When
- categories need comparison
- Brain-to-Brain comparison is useful
- status counts matter
Use Funnel Views When
- work moves through stages
- bottlenecks matter
- drop-off or delay matters
Use Scorecards When
- readiness, quality, or usefulness must be evaluated
Use Insight Cards When
- meaning matters more than raw number
Use Alerts When
- risk, urgency, or blocked work needs attention
Format Rule:
Choose the visual format based on the decision, not the available chart type.
Analytics Record Template
Use this template when defining an analytics or visualization workflow.
Analytics Name
Field:Analytics Name:
Analytics Type
Field:Analytics Type:
Recommended values:
- KPI Card
- Insight Card
- Risk Alert
- Queue View
- Trend View
- Comparison View
- Funnel View
- Scorecard
- Report Summary Panel
- Client Dashboard View
Decision Need
Field:Decision Need:
Owning Brain
Field:Owning Brain:
Supporting Brains
Field:Supporting Brains:
Data Source
Field:Data Source:
Source Quality
Field:Source Quality:
Recommended values:
- Strong
- Usable
- Partial
- Weak
- Conflicting
- Stale
- Unknown
Required Fields
Field:Required Fields:
Cleaning Rules
Field:Cleaning Rules:
Metric Or Pattern
Field:Metric Or Pattern:
Visualization Format
Field:Visualization Format:
Insight Summary
Field:Insight Summary:
Recommended Action
Field:Recommended Action:
Owner
Field:Owner:
Update Frequency
Field:Update Frequency:
Recommended values:
- Manual
- Daily
- Weekly
- Monthly
- On Change
- Per Report
- Per Campaign
- Per Client Cycle
Validation Requirement
Field:Validation Requirement:
Human Review Requirement
Field:Human Review Requirement:
Destination
Field:Destination:
Failure Conditions
Field:Failure Conditions:
Analytics Status
Field:Analytics Status:
Recommended values:
- Proposed
- Draft
- Manual Use
- Ready For Review
- Active
- Parked
- Deprecated
- Retired
Last Reviewed
Field:Last Reviewed:
Quick Use Version
Analytics Name:
Analytics Type:
Decision Need:
Owning Brain:
Supporting Brains:
Data Source:
Source Quality:
Required Fields:
Cleaning Rules:
Metric Or Pattern:
Visualization Format:
Insight Summary:
Recommended Action:
Owner:
Update Frequency:
Validation Requirement:
Human Review Requirement:
Destination:
Failure Conditions:
Analytics Status:
Last Reviewed:
Example 1: Routed Actions Queue Analytics
Analytics Name:
Routed Actions Queue Health View
Analytics Type:
Queue View / KPI Card / Risk Alert
Decision Need:
Which routed actions need HeadOffice attention?
Owning Brain:
HeadOffice Brain
Supporting Brains:
All Brains with routed actions.
Data Source:
Routed Actions records.
Source Quality:
Usable if status, owner, priority, urgency, and due date fields are complete.
Required Fields:
- action_title
- owning_brain
- owner
- priority
- urgency
- status
- due_date
- next_action
Cleaning Rules:
- exclude completed actions from active queue
- separate parked actions
- mark ownerless actions
- flag overdue actions
- group by priority and Brain
Metric Or Pattern:
Open actions, blocked actions, ownerless actions, overdue actions, high-priority actions.
Visualization Format:
KPI cards plus queue table.
Insight Summary:
Shows whether HeadOffice action flow is healthy or blocked.
Recommended Action:
Assign owners, close stale items, escalate high-priority blockers.
Owner:
HeadOffice
Update Frequency:
Daily or weekly after manual proof.
Validation Requirement:
Dashboard Readiness Validation.
Human Review Requirement:
Yes for priority changes or escalations.
Destination:
HeadOffice Dashboard / Routed Actions panel.
Failure Conditions:
Missing owner, missing status, stale records, vague next action.
Analytics Status:
Manual Use / Future Active
Last Reviewed:
YYYY-MM-DD
Example 2: Newsletter Signal Analytics
Analytics Name:
Newsletter Signal Intelligence View
Analytics Type:
Trend View / Insight Card / KPI Card
Decision Need:
Which newsletter signals are action-worthy, repeated, or noise?
Owning Brain:
HeadOffice Brain
Supporting Brains:
Ads Brain, Affiliate Brain, Content Brain, Research Brain, Finance Brain, AI Business Systems Brain.
Data Source:
newsletter_intelligence records and Newsletter Queue Review.
Source Quality:
Usable if body capture is complete and fields are valid.
Required Fields:
- headline
- source_name
- extracted_insight
- primary_brain
- action_type
- priority
- urgency
- status
- recommended_action
Cleaning Rules:
- remove rejected noise
- group repeated signals
- separate ACT NOW, TEST, MONITOR, PARK
- flag weak or generic insights
- mark unverified urgent claims
Metric Or Pattern:
Signal volume by Brain, action type, priority, repeated theme, rejected noise.
Visualization Format:
KPI cards, trend view, insight cards.
Insight Summary:
Shows which external signals matter and which are noise.
Recommended Action:
Route strong signals to Queue Review, Research, or Routed Actions after validation.
Owner:
HeadOffice
Update Frequency:
Daily or weekly.
Validation Requirement:
Operational Validation.
Human Review Requirement:
Yes before downstream action.
Destination:
HeadOffice Dashboard / Newsletter Digest / Queue Review.
Failure Conditions:
Incomplete body, generic insight, wrong Brain routing, inflated urgency.
Analytics Status:
Assisted Use Candidate
Last Reviewed:
YYYY-MM-DD
Example 3: AI Employee Outcome Analytics
Analytics Name:
AI Employee Outcome Usefulness Scorecard
Analytics Type:
Scorecard / Trend View / Report Summary Panel
Decision Need:
Which AI Employees are creating useful outcomes and which workflows need improvement?
Owning Brain:
HeadOffice Brain
Supporting Brains:
All active Brains.
Data Source:
AI Agent Outcome Logs, Failure Logs, validation results, user corrections.
Source Quality:
Partial until outcome logging is consistent.
Required Fields:
- ai_employee
- workflow
- output_created
- outcome_created
- value_type
- risk_reduced
- decision_supported
- status
- date
Cleaning Rules:
- exclude output-only work unless outcome exists
- group by AI Employee and workflow
- separate failures from outcomes
- flag repeated corrections
Metric Or Pattern:
Useful outcomes, repeated failures, value type, correction frequency, automation readiness.
Visualization Format:
Scorecard plus trend summary.
Insight Summary:
Shows whether AI Employees are producing value or just activity.
Recommended Action:
Improve skills, merge roles, split roles, park low-value workflows, or review automation readiness.
Owner:
HeadOffice
Update Frequency:
Weekly or monthly.
Validation Requirement:
Structured Validation.
Human Review Requirement:
Yes.
Destination:
AI Employee Outcome Review / Weekly Kaizen Digest.
Failure Conditions:
Outcome not defined, inflated value, missing examples, no next action.
Analytics Status:
Draft / Manual Use
Last Reviewed:
YYYY-MM-DD
Example 4: Finance Exposure Analytics
Analytics Name:
Finance Exposure And Test Budget View
Analytics Type:
KPI Card / Risk Alert / Trend View
Decision Need:
Is MWMS financial exposure safe for current tests and campaigns?
Owning Brain:
Finance Brain
Supporting Brains:
Ads Brain, Experimentation Brain, Affiliate Brain, HeadOffice Brain.
Data Source:
test budgets, campaign spend, payout data, finance notes, experiment plans.
Source Quality:
Partial until tracking and payout data are verified.
Required Fields:
- campaign_name
- offer_name
- test_budget
- spend_to_date
- payout
- estimated_break_even
- risk_level
- status
- owner
Cleaning Rules:
- exclude draft campaigns
- separate planned from active spend
- flag missing payout
- flag missing break-even
- flag unverified assumptions
Metric Or Pattern:
Spend exposure, break-even gap, active test risk, missing finance assumptions.
Visualization Format:
KPI card, risk alert, table.
Insight Summary:
Shows whether testing remains within safe exposure limits.
Recommended Action:
Pause, continue, review assumptions, or escalate to HeadOffice.
Owner:
Finance Brain
Update Frequency:
Per campaign / weekly.
Validation Requirement:
High Risk Validation.
Human Review Requirement:
Yes before spend increases.
Destination:
Finance Brain / HeadOffice Dashboard.
Failure Conditions:
Missing payout, missing spend data, tracking mismatch, stale cost data.
Analytics Status:
Future Manual Use
Last Reviewed:
YYYY-MM-DD
Example 5: AIBS Client Dashboard Analytics
Analytics Name:
AIBS Client Workflow Health View
Analytics Type:
Client Dashboard View / KPI Card / Insight Card
Decision Need:
What does the client need to know about workflow health, risks, and next actions?
Owning Brain:
AI Business Systems Brain
Supporting Brains:
HeadOffice Brain, Operations Brain, client-specific workflow Brain.
Data Source:
Approved client workflow records and reviewed client data.
Source Quality:
Must be verified and client-approved.
Required Fields:
- client_workflow
- status
- key_metric
- issue_summary
- recommended_action
- risk_level
- review_status
- owner
Cleaning Rules:
- exclude internal-only notes
- remove unapproved data
- remove unsupported claims
- mark missing data
- simplify technical language
Metric Or Pattern:
Workflow health, open risks, completed actions, decisions needed.
Visualization Format:
Client-friendly KPI cards and insight cards.
Insight Summary:
Explains what changed, what matters, and what the client should decide.
Recommended Action:
Review, approve, act, monitor, or request missing data.
Owner:
Client Review Owner / HeadOffice
Update Frequency:
Weekly or per client cycle.
Validation Requirement:
High Risk Validation.
Human Review Requirement:
Always before client delivery.
Destination:
Client Review Queue / client dashboard after approval.
Failure Conditions:
Privacy risk, unsupported claim, missing approval, unclear recommendation, stale source.
Analytics Status:
Future Draft Only
Last Reviewed:
YYYY-MM-DD
Analytics And Visualization Readiness Checklist
Before approving analytics or visualization, check:
- Is the decision need clear?
- Is the owning Brain clear?
- Are supporting Brains listed?
- Is the data source known?
- Is source quality assessed?
- Are required fields present?
- Is schema quality acceptable?
- Are cleaning rules defined?
- Is the metric useful?
- Is the pattern meaningful?
- Is the visualization format appropriate?
- Is the insight summary clear?
- Is the recommended action specific?
- Is an owner assigned where needed?
- Is update frequency appropriate?
- Is validation required?
- Is human review required?
- Is the destination clear?
- Are failure conditions listed?
- Would this visual help MWMS decide?
- Could this visual create dashboard noise?
- Is the data stale?
- Are draft records separated from active records?
- Are parked and rejected items handled properly?
- Should this remain manual?
If several answers are unclear, the analytics output is not ready.
Common Analytics And Visualization Failure Modes
Analytics and visualization has failed if:
- Visuals are created before the decision need is clear.
- Data source is unclear.
- Schema quality is weak.
- Dirty data is visualized.
- Too many metrics are shown.
- Vanity metrics replace decision metrics.
- Stale data is shown as current.
- Insight summary is missing.
- Recommended action is vague.
- Owner is missing.
- Dashboard item has no status.
- Weak signals appear as important.
- Draft records appear as approved.
- Client dashboard includes unapproved data.
- Visual design distracts from meaning.
- Reports repeat numbers without interpretation.
- Charts are too complex for the decision.
- Dashboard creates more noise than clarity.
- Analytics is not reviewed after use.
- Visual output does not improve a decision.
Manual Use Rule
Analytics and visualization workflows should be manually proven before they become dashboards, plugins, automated reports, or client views.
Manual use helps MWMS learn:
- which metrics are useful
- which visuals actually help decisions
- which fields are missing
- which dashboard cards create noise
- which summaries HeadOffice acts on
- which analytics should be repeated
- which analytics should be retired
- which data sources need cleanup
- which reports require better schema
- which client visuals are safe and useful
Manual analytics discipline comes before dashboard automation.
Future Plugin Or UI Relevance
This framework may later support:
- Analytics Workflow Registry
- HeadOffice analytics dashboard
- Newsletter signal analytics panel
- Routed Actions analytics panel
- AI Employee outcome dashboard
- Failure analytics dashboard
- Finance exposure dashboard
- Experimentation result dashboard
- Ads performance dashboard
- Opportunity pipeline visualization
- AIBS client dashboard builder
- analytics plugin orchestration layer
Possible future fields:
- analytics_id
- analytics_name
- analytics_type
- decision_need
- owning_brain
- supporting_brains
- data_source
- source_quality
- required_fields
- cleaning_rules
- metric_or_pattern
- visualization_format
- insight_summary
- recommended_action
- owner
- update_frequency
- validation_requirement
- human_review_requirement
- destination
- failure_conditions
- analytics_status
- last_reviewed
- created_at
- updated_at
No technical build is authorized by this framework alone.
Governance Role
HeadOffice owns the MWMS Analytics And Visualization Workflow Framework.
HeadOffice is responsible for:
- defining analytics and visualization governance
- preventing dashboard clutter
- ensuring data source quality is visible
- ensuring schema quality is checked before visualization
- ensuring metrics support decisions
- ensuring visuals include insight summaries
- ensuring risk and owner fields appear where needed
- ensuring dashboard items are validated before active display
- ensuring client-facing analytics are reviewed before delivery
- protecting M’s active build areas
- protecting MCR source of truth
- deciding when analytics workflows are ready for technical implementation
Individual Brains may propose local analytics views, but HeadOffice governs cross-Brain, HeadOffice-level, finance-related, dashboard-related, automation-related, developer-related, and client-facing analytics.
Relationship To Other MWMS Standards
This framework supports and must align with:
- MWMS AI Schema And Decision Ready Output Framework
- MWMS KPI Dashboard And Insight Summary Framework
- MWMS Structured Analysis And Insight Workflow Framework
- MWMS Operational Decision Intelligence Framework
- MWMS Forecasting And Scenario Planning Framework
- MWMS Recurring Intelligence And Reporting Pipeline Framework
- MWMS AI Agent Operations Core
- MWMS AI Context Routing Framework
- MWMS AI Permission Gatekeeper Framework
- MWMS AI Plugin Orchestration Framework
- MWMS AI Output Validation Standard
- MWMS AI Output Validation Checklist
- MWMS Agentic Reporting Standard
- MWMS Agentic Reporting Template
- MWMS AI Agent Outcome Measurement Framework
- MWMS AI Agent Outcome Log Record
- MWMS AI Agent Failure Handling And Escalation Protocol
- MWMS AI Agent Failure Log Record
- MWMS Brain Routing Rule
- MWMS Brain To Brain Request Protocol
- MWMS Supabase Event Schema
- AI Business Systems Brain Blueprint
This framework adds the analytics and visualization workflow layer to the MWMS decision-intelligence and dashboard system.
Drift Protection
This framework protects MWMS from:
- Building dashboards before decision needs are clear
- Visualizing dirty data
- Trusting weak schema
- Tracking too many metrics
- Displaying vanity metrics
- Showing stale data as current
- Creating dashboard cards with no action
- Creating insight summaries with no meaning
- Displaying risks without owners
- Mixing draft and active records
- Turning newsletter noise into dashboard clutter
- Creating client visuals without approval
- Measuring visual polish instead of decision value
- Automating dashboards before manual proof
- Letting dashboards become a second source of truth instead of a decision layer
Any analytics output that does not clarify decisions should be revised, parked, retired, or rejected.
Architectural Intent
The architectural intent of the MWMS Analytics And Visualization Workflow Framework is to make MWMS intelligence visible without making it noisy.
MWMS will produce a large amount of structured information.
That information must be converted into views that help HeadOffice and the Brains act.
The long-term goal is that every MWMS visual output can answer:
- What decision does this support?
- What source data is used?
- Is the source clean?
- Is the schema valid?
- What metric or pattern matters?
- Why does it matter?
- What visual format best explains it?
- What action is recommended?
- Who owns the next step?
- Is human review required?
- Should this be shown, parked, revised, or retired?
When MWMS controls analytics and visualization this way, dashboards become decision-support systems instead of attractive clutter.
Change Log
v1.0 — Initial Draft
Created the MWMS Analytics And Visualization Workflow Framework to define how MWMS turns clean structured records, signals, metrics, reports, outcomes, failures, finance notes, experiment results, and operational data into analytics, visual summaries, insight cards, dashboard panels, and decision-ready views.
This framework establishes analytics workflow stages, analytics output types, visualization format rules, analytics record templates, examples, readiness checks, failure modes, future plugin/UI relevance, governance role, drift protection, and architectural intent.
It establishes that visuals must clarify decisions, not decorate data.