General vs Consultant_Top Executor Types in PPT Master: Architecture and Specifications

The PPT Master repository defines two distinct executor archetypes—the General Executor for flexible visual storytelling and the Consultant_Top (Top-Tier Consulting) Executor for MBB-style executive presentations—each enforcing non-negotiable constraints on narrative frameworks, color philosophy, and data visualization through dedicated specification files.

The hugohe3/ppt-master repository implements a tiered executor system that governs how markdown sources transform into SVG-based slide decks. While the architecture may imply intermediate consulting variants, the source specifications formally distinguish between the General Executor and Consultant_Top Executor (documented as Top-Tier Consulting Executor), representing foundational creative freedom versus premium consulting rigor.

Intended Scenarios and Audience

General Executor: Designed for non-consulting use cases including product introductions, training materials, and marketing campaigns. This executor prioritizes visual impact and audience engagement over rigid data hierarchies. Specifications reside in skills/ppt-master/references/executor-general.md.

Consultant_Top Executor: Engineered for premium MBB-level consulting presentations—board decks, investment roadshows, and C-suite briefings. This executor emphasizes extreme simplicity, data-driven insight, and executive persuasion through mandatory structural frameworks. Defined in skills/ppt-master/references/executor-consultant-top.md.

Narrative Framework Requirements

General Executor: Flexible Visual Rhythm

The General Executor imposes no mandatory story structure. Layouts adapt dynamically per content using visual rhythm techniques—specifically alternating dense information pages with "breathing" pages—to maintain audience freshness. As implemented in executor-general.md#visual-rhythm-control, this approach supports creative narrative flows without rigid hierarchical constraints.

Consultant_Top Executor: SCQA and Pyramid Principle

The Consultant_Top Executor mandates strict adherence to SCQA (Situation-Complication-Question-Answer) paired with the Pyramid Principle: conclusion first, followed by supporting arguments, then granular details. Every slide must follow a strict information hierarchy. This framework is enforced through the specifications in executor-consultant-top.md#scqa-framework.

Visual Design Specifications

Color Philosophy and Constraints

General: Employs bold theme-color usage, gradients, and decorative accents including gradient blocks, rounded cards, and icons to establish brand personality and mood. Reference: executor-general.md#color-usage.

Consultant_Top: Maintains extreme color restraint. Primary data renders in the theme color; all supporting elements appear in gray. Colors serve informational purposes exclusively—indicating focus, positive/negative semantics—while prohibiting decorative gradients beyond the brand bar. Reference: executor-consultant-top.md#strategic-use-of-color.

Layout Patterns and Templates

General: Supports flexible variety including full-image backgrounds, left-right splits, three-column cards, Z-patterns, and waterfall flows. Layouts prioritize visual storytelling over strict data hierarchy. Reference: executor-general.md#general-specific-layout-techniques.

Consultant_Top: Enforces fixed MBB-style templates featuring gradient top bars, assertion-style titles, Takeaway Boxes, central data areas, and confidential footers. The minimalistic design prizes whitespace as an active communication element. Reference: executor-consultant-top.md#content-page-standard-structure.

Data Visualization Standards

General: Emphasizes visual variety through image-filled backgrounds, icon-accented cards, and creative compositions. No strict chart conventions apply; the priority remains aesthetic engagement. Reference: executor-general.md#image-handling-strategy.

Consultant_Top: Requires monochromatic depth-gradient charts, KPI cards with trend arrows, MECE (Mutually Exclusive, Collectively Exhaustive) trees, and driver-factor trees. Strict table styling mandates zebra striping and minimal borders. Every chart must explicitly include value, reference, and interpretation layers. Reference: executor-consultant-top.md#data-contextualization.

Speaker Notes and Presentation Markers

General: Utilizes conversational narration with a storytelling tone. Supports markers [Pause], [Interactive], and [Transition] designed for presenter script reading. Reference: executor-general.md#speaker-notes-style.

Consultant_Top: Requires executive-level, pyramid-structured notes with conclusion-first formatting. Employs specialized markers [Pause], [Scan Room], [Data], [Benchmark], and [Transition] optimized for concise briefing delivery to decision-makers. Reference: executor-consultant-top.md#speaker-notes-style.

Quality Assurance Checklists

General Executor validation checks visual rhythm, decorative balance, image-text ratio, and conversational tone in notes according to executor-general.md#self-check-supplement.

Consultant_Top Executor validation enforces SCQA completeness, data contextualization, MECE compliance, color-with-intent verification, whitespace optimization, pyramid-structured notes, and stage-marker coverage per executor-consultant-top.md#mbb-level-quality-checklist.

Both executors inherit baseline technical constraints from executor-base.md and SVG limitations from shared-standards.md, with typography locked to the body size specification defined in spec_lock_reference.md.

Implementation Examples

The following markdown snippets demonstrate architectural differences when placed in a PPT Master project’s notes/ folder.

General Executor example:

# 01_product_hero

[Transition] Let’s explore the new AI‑powered widget.

<image src="widget.png" style="full-bg"/>

[Pause] Imagine a world where your inbox writes itself.

## Features

- ✨ Seamless integration
- 🚀 Real‑time insights
- 🔒 Enterprise‑grade security

[Interactive] Who would love a zero‑click experience?

Consultant_Top Executor example:

# 01_market_overview

[Transition] The market is expanding at a rapid pace.

<text x="160" y="280" font-size="42" font-weight="bold" fill="#1E293B">23% YoY</text>
<text x="160" y="310" font-size="13" fill="#64748B">Industry avg 15% | Competitor A 20%</text>
<text x="160" y="335" font-size="12" fill="#059669">Our growth outpaces peers</text>

[Data] 23% growth translates to $1.8 B additional revenue. [Pause] 
[Benchmark] Compared with the industry baseline, we are 8 pp ahead.

Key points: (1) Market expanding fast (2) Our growth exceeds peers (3) Strategic opportunity to capture share

Summary

• General Executor optimizes for creative flexibility, visual richness, and brand personality suitable for marketing and training contexts, with flexible narrative structures.
• Consultant_Top Executor enforces rigid MBB consulting standards through mandatory SCQA frameworks, MECE structuring, and data-first minimalism engineered for C-suite audiences.
• Both executors share baseline technical constraints from executor-base.md and SVG standards from shared-standards.md while differing fundamentally in narrative rigor, color philosophy, and quality validation rules.

Frequently Asked Questions

What defines the primary architectural difference between General and Consultant_Top executors in PPT Master?

The General Executor permits flexible visual storytelling without mandatory narrative structures, while the Consultant_Top Executor requires strict adherence to SCQA frameworks and the Pyramid Principle, enforcing conclusion-first data presentation suitable for executive consulting decks.

Is there a middle-tier Consultant Executor between General and Consultant_Top?

The analyzed source specifications in skills/ppt-master/references/ define only two formal executor types: General and Consultant_Top (Top-Tier). While the naming convention suggests a spectrum, executor-general.md and executor-consultant-top.md represent the definitive architectural implementations, with no intermediate consultant specification present in the current codebase.

Where are the base technical constraints shared between executor types defined?

Common SVG constraints and technical specifications reside in skills/ppt-master/references/executor-base.md and shared-standards.md, while typographic baselines are locked in spec_lock_reference.md. These files provide the foundational layer that both executors must observe before applying their specific stylistic rules.

How does the Consultant_Top Executor validate data visualization quality?

The Consultant_Top quality checklist requires MECE compliance, explicit data contextualization (value, reference, and interpretation layers), color-with-intent verification, and monochromatic depth-gradient consistency, ensuring all visual elements serve executive decision-making purposes.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}