Skip to content

feature/Slide-proposal-topic · L-261107-75b313 #25

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lchoquel merged 1 commit into from
Nov 7, 2026
Merged

feature/Slide-proposal-topic · L-261107-75b313 #25

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,15 @@
# Changelog

## [Unreleased]

### Changed

- **`slide_designer` returns each theme paired with its mockup (Breaking)**: `generate_design_proposals_from_rough_brief` returns the new `DesignProposals` concept instead of an `Html` page: `brief`, the polished brief, and `proposals`, a list of `DesignProposal`, each a `theme` with the `mockup` image drawn in it, where the themes and the images previously reached a caller only as two lists matched by position inside the page. The HTML report moves to the newly exported `generate_design_proposals_report`, which takes the same `brief` and shows each mockup in one card beside its own theme. A caller that wants the page names that pipe at the new tag, and one that wants the old pipe exactly stays at `@v0.3.0`.

### Fixed

- **`slide_designer` draws the deck's own title**: the image step now reads the polished brief and draws its `topic` word for word as the deck's title, with the other slides' placeholder content fitting the topic, the audience and the goal, where it previously saw the theme alone and invented a subject and a period of its own. Polishing the brief now keeps the topic exactly as typed.

## [v0.3.0] - 2026-11-07

### Added
Expand Down
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ This repository is the public library of packaged [MTHDS](https://mthds.ai) meth
| [`cv_analyzer`](methods/cv_analyzer/) | End-to-end candidate screening: match a CV against a job offer, then generate tailored interview questions or draft a courteous refusal email | `screen_candidate` |
| [`invoice_extraction`](methods/invoice_extraction/) | Classify each page as bill or receipt, then extract structured invoice data (amounts with their currency, VAT, vendor, buyer and the purchase line by line) from OCR text and page views | `process_invoice` |
| [`table_extraction`](methods/table_extraction/) | Turn a screenshot of a table into faithful HTML, with a vision review pass to correct text and formatting | `extract_html_table_and_review` |
| [`slide_designer`](methods/slide_designer/) | Turn a rough slide-deck brief into design proposals: multiple visual themes, a rendered mockup image for each, and an HTML report presenting them all | `generate_design_proposals_from_rough_brief` |
| [`slide_designer`](methods/slide_designer/) | Turn a rough slide-deck brief into design proposals: multiple visual themes, each paired with a mockup of the deck drawn in it under the brief's own title, or, through `generate_design_proposals_report`, an HTML report presenting them | `generate_design_proposals_from_rough_brief` |
| [`image_generation`](methods/image_generation/) | Generate images from text: render a description directly, or refine it into an optimized image prompt first | `illustrate` |
| [`image_generation_fast`](methods/image_generation_fast/) | Generate an image quickly: render a description directly with a small, fast image generation model | `generate_image` |
| [`image_card`](methods/image_card/) | Generate an image from a description with a small, fast image generation model, and present the image and its description side by side in an HTML page | `generate_image_card` |
Expand Down
7 changes: 5 additions & 2 deletions methods/slide_designer/METHODS.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,14 @@ name = "slide_designer"
display_name = "Slide Designer"
address = "github.com/Pipelex/methods"
version = "0.3.0"
description = "Turn a rough slide-deck brief into design proposals: polish the brief, generate multiple visual themes, render a mockup image for each, and compose an HTML report presenting them all."
description = "Turn a rough slide-deck brief into design proposals: polish the brief, generate multiple visual themes, and draw in each a mockup of the deck titled with its own topic, returning each theme paired with its mockup, or an HTML report presenting them."
authors = ["Evotis S.A.S"]
license = "MIT"
mthds_version = ">=1.0.0"
main_pipe = "generate_design_proposals_from_rough_brief"

[exports.slide_designer]
pipes = ["generate_design_proposals_from_rough_brief"]
pipes = [
"generate_design_proposals_from_rough_brief",
"generate_design_proposals_report",
]
163 changes: 98 additions & 65 deletions methods/slide_designer/slide_designer.mthds
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
domain = "slide_designer"
description = "Data model for slide prompt generation with reusable themes"
description = "Turning a rough slide-deck brief into design proposals, each a visual theme paired with a mockup drawn in it for the deck's own title"
main_pipe = "generate_design_proposals_from_rough_brief"

# Input concept for design brief
Expand Down Expand Up @@ -84,50 +84,49 @@ layout = { type = "concept", concept_ref = "LayoutSettings", description = "
style = { type = "concept", concept_ref = "StyleSettings", description = "Visual style settings", required = true }
exclusions = { type = "text", description = "Elements to avoid in the design (e.g., no gradients, no stock photos)" }

# Slide content concept
# Output concepts

[concept.Slide]
description = "Content definition for a single slide"
[concept.DesignProposal]
description = "One design proposal for a deck: a visual theme and a mockup of the deck drawn in it"

[concept.Slide.structure]
slide_type = { type = "text", description = "Type of slide layout", required = true, choices = [
"title",
"content",
"comparison",
"process",
"infographic",
"quote",
"closing",
] }
title = { type = "text", description = "Slide title", required = true }
subtitle = { type = "text", description = "Optional subtitle or tagline" }
content = { type = "text", description = "Main content or bullet points for the slide", required = true }
graphics = { type = "text", description = "Description of visual elements or graphics to include" }
layout_override = { type = "text", description = "Optional layout override for this specific slide" }
[concept.DesignProposal.structure]
theme = { type = "concept", concept_ref = "Theme", description = "The proposal's theme: palette, typography, layout and style", required = true }
mockup = { type = "concept", concept_ref = "Image", description = "Four slides of the deck drawn in the theme, the title slide carrying the brief's topic word for word", required = true }

# Output concepts
[concept.DesignProposals]
description = "The design proposals for a deck: the polished brief they answer, and the proposals, each a theme paired with its mockup"

[concept.SlidePrompt]
description = "Generated image prompt ready for slide image generation"
refines = "Text"
[concept.DesignProposals.structure]
brief = { type = "concept", concept_ref = "SlideDesignBrief", description = "The brief as polished: the topic as given, with the tone, goal and audience filled in", required = true }
proposals = { type = "list", item_type = "concept", item_concept_ref = "DesignProposal", description = "The proposals, one per theme", required = true }

# Pipes

[pipe.generate_design_proposals_from_rough_brief]
type = "PipeSequence"
description = "Transform a design brief into multiple themes with visual mockups and HTML report"
description = "Turn a rough deck brief into design proposals: polish the brief, imagine several themes, and draw in each a mockup titled with the deck's own topic, each theme paired with its mockup"
inputs = { brief = "SlideDesignBrief" }
output = "Html"
output = "DesignProposals"
steps = [
{ pipe = "polish_brief", result = "polished_brief" },
{ pipe = "generate_multiple_themes", nb_output = 3, result = "themes" },
{ pipe = "render_visual_proposal", batch_over = "themes", batch_as = "theme", result = "design_proposals" },
{ pipe = "draft_proposal", batch_over = "themes", batch_as = "theme", result = "proposals" },
{ pipe = "assemble_proposals", result = "design_proposals" },
]

[pipe.generate_design_proposals_report]
type = "PipeSequence"
description = "Turn a rough deck brief into design proposals and present them in an HTML report, each mockup in one card with its own theme"
inputs = { brief = "SlideDesignBrief" }
output = "Html"
steps = [
{ pipe = "generate_design_proposals_from_rough_brief", result = "design_proposals" },
{ pipe = "compose_proposals_report", result = "proposals_report" },
]

[pipe.polish_brief]
type = "PipeLLM"
description = "Polish and complete a slide design brief by filling missing fields"
description = "Polish and complete a slide design brief by filling missing fields, keeping the topic word for word"
inputs = { brief = "SlideDesignBrief" }
output = "SlideDesignBrief"
prompt = """
Expand All @@ -136,17 +135,18 @@ You are a professional presentation design consultant. Review this client brief
@brief

Your task:
1. Keep all provided information, but refine the wording if needed for clarity
2. For any missing fields, infer sensible defaults based on the topic and any other provided context
3. Ensure tone, goal, and audience are filled in with the most appropriate choice
4. If brand_guidelines are missing, leave them empty (do not invent specific colors or fonts)
1. Keep the topic exactly as written, word for word: it is the deck's title, and the slides show it as given
2. Keep all other provided information, but refine its wording if needed for clarity
3. For any missing fields, infer sensible defaults based on the topic and any other provided context
4. Ensure tone, goal, and audience are filled in with the most appropriate choice
5. If brand_guidelines are missing, leave them empty (do not invent specific colors or fonts)

Return a complete, polished brief.
"""

[pipe.generate_multiple_themes]
type = "PipeLLM"
description = "Generate a presentation theme from a polished design brief"
description = "Generate several presentation themes from a polished design brief"
inputs = { polished_brief = "SlideDesignBrief" }
output = "Theme[]"
prompt = """
Expand Down Expand Up @@ -180,33 +180,69 @@ Generate a complete theme with:
6. **Exclusions**: Things to avoid based on the brief context
"""

[pipe.draft_proposal]
type = "PipeSequence"
description = "Draw the deck's mockup in one theme and pair the theme with it"
inputs = { theme = "Theme", polished_brief = "SlideDesignBrief" }
output = "DesignProposal"
steps = [
{ pipe = "render_visual_proposal", result = "mockup" },
{ pipe = "pair_proposal", result = "proposal" },
]

[pipe.render_visual_proposal]
type = "PipeImgGen"
description = "Generate a visual mockup image from a theme"
inputs = { theme = "Theme" }
description = "Draw a mockup of four slides of the deck in one theme, its title slide carrying the brief's topic word for word"
inputs = { theme = "Theme", polished_brief = "SlideDesignBrief" }
output = "Image"
aspect_ratio = "landscape_16_9"
model = "@default-premium"
prompt = """
Render a composition of 4 slide mockups based on the following theme:
Render a composition of 4 slide mockups for a presentation whose title is: $polished_brief.topic

The presentation's audience: $polished_brief.audience. Its goal: $polished_brief.goal.

Design all four slides in the following theme:

$theme

---

The composition should be a grid of 4 slides, each with the following layout:
- Title slide
- Title slide, showing the presentation's title exactly as given above, word for word
- Content slide
- Comparison slide
- Process slide

Give the content, comparison and process slides headings and placeholder content that fit the presentation's topic, its audience and its goal. Every slide stays on the presentation's own subject: name no date, period or subject that the title does not.

Make the mosaic edge to edge, no space between the slides.
"""

[pipe.pair_proposal]
type = "PipeCompose"
description = "Pair a theme with the mockup drawn in it"
inputs = { theme = "Theme", mockup = "Image" }
output = "DesignProposal"

[pipe.pair_proposal.construct]
theme = { from = "theme" }
mockup = { from = "mockup" }

[pipe.assemble_proposals]
type = "PipeCompose"
description = "Gather the polished brief and the proposals into one result"
inputs = { polished_brief = "SlideDesignBrief", proposals = "DesignProposal[]" }
output = "DesignProposals"

[pipe.assemble_proposals.construct]
brief = { from = "polished_brief" }
proposals = { from = "proposals" }

[pipe.compose_proposals_report]
type = "PipeCompose"
description = "Generate an HTML report presenting the design proposals"
inputs = { brief = "SlideDesignBrief", polished_brief = "SlideDesignBrief", themes = "Theme[]", design_proposals = "Image[]" }
description = "Present the design proposals in an HTML report, each mockup in one card with its own theme's details"
inputs = { brief = "SlideDesignBrief", design_proposals = "DesignProposals" }
output = "Html"

[pipe.compose_proposals_report.template]
Expand All @@ -221,15 +257,15 @@ template = """
h2 { color: #34495e; margin-top: 30px; }
.brief-section { background: white; padding: 25px; border-radius: 10px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.1); }
.brief-section h3 { color: #e74c3c; margin-top: 0; }
.proposals-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 25px; margin-top: 30px; }
.proposal-card { background: white; border-radius: 12px; overflow: hidden; box-shadow: 0 4px 15px rgba(0,0,0,0.1); }
.proposal-card { display: grid; grid-template-columns: minmax(0, 2fr) minmax(260px, 1fr); background: white; border-radius: 12px; overflow: hidden; box-shadow: 0 4px 15px rgba(0,0,0,0.1); margin-top: 25px; }
.proposal-card img { width: 100%; height: auto; display: block; }
.theme-details { padding: 20px; }
.theme-name { font-size: 1.3em; font-weight: bold; color: #2c3e50; margin-bottom: 15px; }
.color-swatches { display: flex; gap: 8px; margin: 10px 0; }
.color-swatches { display: flex; flex-wrap: wrap; gap: 8px; margin: 10px 0 15px; }
.swatch { width: 30px; height: 30px; border-radius: 5px; border: 1px solid #ddd; }
.detail-row { margin: 8px 0; font-size: 0.9em; }
.detail-label { color: #7f8c8d; font-weight: 500; }
@media (max-width: 900px) { .proposal-card { grid-template-columns: 1fr; } }
</style>
</head>
<body>
Expand All @@ -245,7 +281,8 @@ template = """
{% if brief.existing_references %}<p><strong>References:</strong> {{ brief.existing_references }}</p>{% endif %}
</div>

{% if brief != polished_brief %}
{% set polished_brief = design_proposals.brief %}
{% if brief.topic != polished_brief.topic or brief.tone != polished_brief.tone or brief.goal != polished_brief.goal or brief.audience != polished_brief.audience or brief.brand_guidelines != polished_brief.brand_guidelines or brief.existing_references != polished_brief.existing_references %}
<div class="brief-section">
<h3>Enhanced Brief</h3>
<p><strong>Topic:</strong> {{ polished_brief.topic }}</p>
Expand All @@ -258,32 +295,28 @@ template = """
{% endif %}

<h2>Design Proposals</h2>
<div class="proposals-grid">
{% for proposal in design_proposals %}
<div class="proposal-card">
<img src="{{ proposal.public_url }}" alt="Design proposal {{ loop.index }}">
</div>
{% endfor %}
</div>

<h2>Theme Details</h2>
<div class="proposals-grid">
{% for theme in themes %}
<div class="proposal-card">
<div class="theme-details">
<div class="theme-name">{{ theme.name }}</div>
<div class="color-swatches">
<div class="swatch" style="background: {{ theme.colors.primary }}" title="Primary"></div>
<div class="swatch" style="background: {{ theme.colors.secondary }}" title="Secondary"></div>
<div class="swatch" style="background: {{ theme.colors.accent }}" title="Accent"></div>
</div>
<div class="detail-row"><span class="detail-label">Font:</span> {{ theme.typography.font_family }}</div>
<div class="detail-row"><span class="detail-label">Style:</span> {{ theme.style.overall }}</div>
<div class="detail-row"><span class="detail-label">Layout:</span> {{ theme.layout.aspect_ratio }}</div>
{% for proposal in design_proposals.proposals %}
{% set theme = proposal.theme %}
<div class="proposal-card">
<img src="{{ proposal.mockup.public_url }}" alt="Mockup of the deck in the {{ theme.name }} theme">
<div class="theme-details">
<div class="theme-name">{{ theme.name }}</div>
<div class="color-swatches">
<div class="swatch" style="background: {{ theme.colors.primary }}" title="Primary: {{ theme.colors.primary }}"></div>
<div class="swatch" style="background: {{ theme.colors.secondary }}" title="Secondary: {{ theme.colors.secondary }}"></div>
<div class="swatch" style="background: {{ theme.colors.accent }}" title="Accent: {{ theme.colors.accent }}"></div>
<div class="swatch" style="background: {{ theme.colors.background }}" title="Background: {{ theme.colors.background }}"></div>
<div class="swatch" style="background: {{ theme.colors.text_primary }}" title="Text: {{ theme.colors.text_primary }}"></div>
</div>
<div class="detail-row"><span class="detail-label">Font:</span> {{ theme.typography.font_family }}</div>
{% if theme.typography.heading_style %}<div class="detail-row"><span class="detail-label">Headings:</span> {{ theme.typography.heading_style }}</div>{% endif %}
<div class="detail-row"><span class="detail-label">Style:</span> {{ theme.style.overall }}</div>
{% if theme.style.graphic_style %}<div class="detail-row"><span class="detail-label">Graphics:</span> {{ theme.style.graphic_style }}</div>{% endif %}
<div class="detail-row"><span class="detail-label">Layout:</span> {{ theme.layout.aspect_ratio }}</div>
{% if theme.exclusions %}<div class="detail-row"><span class="detail-label">Avoids:</span> {{ theme.exclusions }}</div>{% endif %}
</div>
{% endfor %}
</div>
{% endfor %}
</body>
</html>
"""