Skip to content

feat: add author-presentation template with presentation-kit format#162

Merged
Alan-Jowett merged 1 commit intomicrosoft:mainfrom
Alan-Jowett:add-presentation-kit
Apr 1, 2026
Merged

feat: add author-presentation template with presentation-kit format#162
Alan-Jowett merged 1 commit intomicrosoft:mainfrom
Alan-Jowett:add-presentation-kit

Conversation

@Alan-Jowett
Copy link
Copy Markdown
Member

@Alan-Jowett Alan-Jowett commented Apr 1, 2026

Summary

Add a new interactive template for authoring professional technical presentations from LLM session context. Produces a complete presentation kit: PowerPoint slides (via python-pptx), speaker notes, timeline, optional PDF export, and optional demo plan.

New Components

Type Name Path Description
Protocol (reasoning) presentation-design protocols/reasoning/presentation-design.md 6-phase reasoning protocol: audience analysis, narrative arc, slide decomposition, visual design, time budgeting, demo choreography
Format presentation-kit ormats/presentation-kit.md Multi-artifact output format for presentations: PPTX generation rules, theme presets, speaker notes, timeline, demo plan
Template uthor-presentation emplates/author-presentation.md 7-phase interactive template with adversarial plan review before content generation

Design Decisions

  • Configurable persona: The domain varies by presentation topic (a security talk uses security-auditor, an architecture talk uses software-architect), so the persona is a parameter rather than fixed.
  • No new persona needed: Presentation-specific reasoning (narrative arc, visual design, pacing) lives in the presentation-design protocol instead of a persona, keeping concerns separated.
  • No taxonomy needed: Presentations don't produce classified findings, so no taxonomy was added.
  • Adversarial plan review (Phase 3): A dedicated phase stress-tests the slide plan before content generation — checking audience-goal alignment, narrative coherence, evidence grounding, pacing, and failure modes.
  • Python-pptx code generation: The template instructs the LLM to write and execute Python code to produce the actual .pptx file, similar to how ind-and-fix-bugs instructs the LLM to apply code fixes.
  • Theme presets: Five built-in visual themes (Dark Tech, Light Clean, Warm Minimal, Corporate Blue, High Contrast) plus custom option, with sensible defaults.

Checklist

  • All files have SPDX license headers
  • YAML frontmatter is valid and complete
  • Component names match file names (kebab-case)
  • manifest.yaml updated with all new components
  • No vague instructions in protocols or templates
  • Protocol has numbered, ordered phases (6 phases)
  • Template has a quality checklist section
  • New components do not conflict with existing ones
  • CI validation passes (python tests/validate-manifest.py → OK)

Copilot AI review requested due to automatic review settings April 1, 2026 19:12
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new “presentation kit” document intended to let any presenter deliver the PromptKit Deep Dive deck confidently (speaker notes, demo script, FAQ, and timing guidance), aligning with PromptKit’s broader goal of making library usage and workflows easy to adopt and explain.

Changes:

  • Added a slide-by-slide presenter script for the 19-slide Deep Dive deck.
  • Added a 10-minute demo script (CLI quick start + Sonde case study beats).
  • Added an FAQ, pre-talk setup checklist, and a slide timing/compression guide.

@Alan-Jowett Alan-Jowett changed the title docs: add presentation kit for Deep Dive deck feat: add author-presentation template with presentation-kit format Apr 1, 2026
@Alan-Jowett Alan-Jowett force-pushed the add-presentation-kit branch from 6e2230e to 67f3934 Compare April 1, 2026 20:35
Copilot AI review requested due to automatic review settings April 1, 2026 20:35
@Alan-Jowett Alan-Jowett force-pushed the add-presentation-kit branch from 67f3934 to 85df699 Compare April 1, 2026 20:38
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 5 comments.

@Alan-Jowett Alan-Jowett force-pushed the add-presentation-kit branch from 3a81040 to 60495cd Compare April 1, 2026 21:36
Copilot AI review requested due to automatic review settings April 1, 2026 21:47
@Alan-Jowett Alan-Jowett force-pushed the add-presentation-kit branch from 60495cd to 3f940d5 Compare April 1, 2026 21:47
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

Add a new interactive template for authoring professional technical
presentations from LLM session context. The template produces a
complete presentation kit: PowerPoint slides (via python-pptx),
speaker notes, timeline, optional PDF export, and optional demo plan.

New components:
- protocols/reasoning/presentation-design.md: 6-phase reasoning
  protocol covering audience analysis, narrative arc, slide
  decomposition, visual design, time budgeting, and demo choreography
- formats/presentation-kit.md: multi-artifact output format defining
  PPTX generation rules, theme presets, speaker notes structure,
  timeline format, and demo plan format
- templates/author-presentation.md: 7-phase interactive template with
  adversarial plan review before content generation

The template uses a configurable persona (user selects based on
domain) and composes anti-hallucination, self-verification, and
the new presentation-design protocol.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@Alan-Jowett Alan-Jowett force-pushed the add-presentation-kit branch from 3f940d5 to 736aeb5 Compare April 1, 2026 21:55
@Alan-Jowett Alan-Jowett merged commit 0a7159a into microsoft:main Apr 1, 2026
3 checks passed
@Alan-Jowett Alan-Jowett deleted the add-presentation-kit branch April 1, 2026 21:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants