Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "meta-ads-designer",
"description": "Design and generate posters, flyers, Meta/social ads and promo graphics that look art-directed instead of AI-generated.",
"version": "5.9.0",
"version": "5.10.0",
"author": { "name": "AI Evolution Labs", "url": "https://github.com/aievolutionpl" },
"homepage": "https://github.com/aievolutionpl/meta-ads-designer",
"license": "MIT",
Expand Down
26 changes: 26 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,32 @@ All notable changes to Meta Ads Designer. Versions follow [SemVer](https://semve

---

## [5.10.0] — 2026-09-24

The 2026 feed layer: what current Meta ads look like, which structures persuade, and what changed on the platform. Researched from Behance and Dribbble portfolio patterns, Penji's Meta design guidance, Meta's Ads Guide and about thirty 2026 sources on creative performance, trends and placement changes. Third-party figures are labelled as such and never presented as promised results.

### Added
- **`R45` Commit to one visual language** — a style is a complete language (type, colour, image treatment, layout, one signature device). One per creative; brand identity outranks trend; imperfection is a process choice, not a filter; a portfolio board is not an ad.
- **`R46` Format follows proof and funnel** — choose the persuasion skeleton before the style. A format exists only when its proof exists: no verified number, no stat drop; no real review, no review card.
- **`R47` Diversity is delivery** — Meta's Andromeda retrieval groups near-identical creatives. Campaign sets vary persona, motivation, hook, format and style; controlled tests still rotate one variable.
- **`R48` Design for the 2026 placement system** — the unified March 2026 Stories/Reels safe zone (top 14%, bottom 35%, sides 6%), 4:5 export at 1440×1800, text-field truncation, Advantage+ enhancements including image expansion and generated backgrounds, "AI info" labels, and a new hard fail, `R48-fake-ui`, for fake play buttons, close icons and notification badges.
- **`references/style-atlas-2026.md`** — twelve visual languages (oversized type, colour-block still life, direct-flash editorial, cinematic coloured light, quiet minimal, documentary phone-real, native interface, performance sticker, tactile zine, reality warp, seasonal world, device-in-hand), each with DNA, fit, a model-independent prompt fragment and its typical failure; format pairings; trend slop; a method for reading reference boards, worked on the Behance "meta advertising" page.
- **`references/static-ad-formats.md`** — fifteen static formats with 4:5 skeletons, copy budgets, proof requirements and integrity rules; funnel fit; format by vertical; hook-to-format pairings; carousel sequencing.
- **`examples/07-2026-style-directions.md`** — five fictional format-plus-style briefs with prompts and typesetting handoffs, and one Andromeda-ready campaign set.
- **`assets/style-atlas-2026.png`** and its source `assets/generated/style-atlas.html` — six deterministic, typeset demonstration ads for the README.

### Changed
- **`scripts/qa.py`** — the 9:16 keep-out now follows Meta's unified safe zone, expressed as a share of height and measured from the canvas edge (the stricter of margin and chrome wins). Previously the fixed 250px/320px values were added on top of the margin, which both over-restricted the top and let copy sit in the Reels action area at the bottom. The format check accepts Meta's recommended 1440×1800 (4:5) and 1440×2560 (9:16) exports. Three new self-tests.
- **`references/qa-gate.md`** — the vision pass returns `visual_language` (flags `"mixed"`, R45) and `fake_functional_ui` (`R48-fake-ui`).
- **`references/platform-compliance.md`** — new §6: text fields, text-on-image guidance, Advantage+ design consequences, AI disclosure and misleading formats, with sources.
- **`references/variation-matrix.md`** — new §6 on concept diversity for delivery, with a persona × motivation concept grid.
- **`references/creative-performance-loop.md`** — fatigue signals and refresh rhythm from 2026 benchmarks.
- **`references/hook-engineering.md`**, **`references/anti-slop-registry.md`** (§1b, 2026 tells), **`references/niche-playbooks.md`**, **`references/layout-system.md`**, **`core.md`** (§20), **`design-rules.md`**, **`SKILL.md`** — the new layer wired into the workflow, the routing table and the paste-in inject.

`R01`–`R44` are unchanged — additive, no renumbering.

---

## [5.9.0] — 2026-09-09

Model-independent art direction and prompt craft.
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ This is a **rules repo** — the value is the design doctrine. Every contributio

| File | Role | When to edit it |
|------|------|-----------------|
| **`visual-advertising-engine.md`** | The canonical standard (44 rules) | **Adding/refining a rule → edit here FIRST.** This is the source of truth. English. |
| **`visual-advertising-engine.md`** | The canonical standard (48 rules) | **Adding/refining a rule → edit here FIRST.** This is the source of truth. English. |
| `design-rules.md` | The readable charter (English canonical) | Summarize a rule already in the engine. |
| `core.md` | The complete general-knowledge inject | Add only if a rule is so essential it must be in the inject. |
| `SKILL.md` | Agent manual | Procedural/workflow changes. |
Expand Down
23 changes: 20 additions & 3 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ An AI agent skill for choosing **composition, typography, colour and visual dire

[Polski](README.md) · [Agent instructions](SKILL.md) · [Quick start](#quick-start) · [Examples](examples/README.md)

![Version](https://img.shields.io/badge/version-5.9.0-222222)
![Version](https://img.shields.io/badge/version-5.10.0-222222)
![License](https://img.shields.io/badge/license-MIT-222222)
![Model independent](https://img.shields.io/badge/prompts-model_independent-222222)

Expand Down Expand Up @@ -36,6 +36,19 @@ The same concepts can also take a quieter editorial direction:

*A second demonstration board. The art direction changes; the skill is not restricted to either style.*

## New in 5.10: the 2026 feed layer

![Style Atlas 2026: six fictional ads, each pairing a static format with one visual language](assets/style-atlas-2026.png)

*Six fictional ads typeset deterministically in HTML ([source](assets/generated/style-atlas.html)): no image model, no client assets, no performance claims. Each pairs a persuasion format with one visual language.*

The skill now knows what current Meta ads look like and why some structures persuade:

- **Style atlas 2026** — twelve visual languages, from oversized type posters and direct-flash editorial to notes-app natives, performance stickers and tactile zines, each with its type, colour, signature device, a prompt fragment and the way it fails.
- **Static formats** — fifteen persuasion skeletons (stat drop, review stack, product + callouts, comparison, offer stack…), each available only when its proof exists.
- **2026 platform facts** — Meta's unified Reels/Stories safe zone (14% top, 35% bottom), 4:5 export at 1440×1800, Advantage+ image expansion and generated backgrounds, "AI info" labels, and Andromeda's grouping of near-identical ads.
- **Four new rules, R45–R48** — one visual language per ad, format follows proof, diversity is delivery, design for the 2026 placement system.

## How it works

```mermaid
Expand All @@ -48,7 +61,7 @@ flowchart LR

1. **Brief** — establish audience, verified offer, goal, format and available assets.
2. **Idea** — choose what makes the benefit visible: product, action, detail, situation or type.
3. **Art direction** — define the focal element, reading order, copy space, fonts and palette.
3. **Art direction** — pick a format the proof supports and one visual language, then define the focal element, reading order, copy space, fonts and palette.
4. **Prompt** — write the composition, exact copy and relevant constraints.
5. **Review** — check prompt consistency; once rendered, inspect readability, spelling and reference fidelity.

Expand Down Expand Up @@ -95,9 +108,13 @@ A prompt communicates intent. It cannot guarantee identical fonts, pixel coordin
| [core.md](core.md) | Self-contained chat instruction |
| [Art direction](references/art-direction.md) | Marketing goal to composition and typography |
| [Prompt craft](references/prompt-craft.md) | Writing and reviewing prompts |
| [Style atlas 2026](references/style-atlas-2026.md) | Twelve visual languages, trend slop, reading reference boards |
| [Static ad formats](references/static-ad-formats.md) | Persuasion skeletons, proof, funnel and vertical fit |
| [Worked prompts](examples/05-model-independent-directions.md) | Flyer, food and local service |
| [Visual Advertising Engine](visual-advertising-engine.md) | Canonical rules R01–R44 |
| [2026 style directions](examples/07-2026-style-directions.md) | Format plus style briefs and an Andromeda-ready campaign set |
| [Visual Advertising Engine](visual-advertising-engine.md) | Canonical rules R01–R48 |
| [Layout system](references/layout-system.md) | Starting values for grids, margins and type |
| [Platform guidance](references/platform-compliance.md) | Safe zones, text limits, Advantage+, AI labels |
| [QA gate](references/qa-gate.md) | Reviewing actual rendered images |
| [More examples](examples/README.md) | Briefs, prompts and design decisions |

Expand Down
23 changes: 20 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Skill dla agentów AI, który pomaga dobierać **kompozycję, typografię, kolor

[English](README.en.md) · [Instrukcja skilla](SKILL.md) · [Szybki start](#szybki-start) · [Przykłady](examples/README.md)

![Version](https://img.shields.io/badge/version-5.9.0-222222)
![Version](https://img.shields.io/badge/version-5.10.0-222222)
![License](https://img.shields.io/badge/license-MIT-222222)
![Model independent](https://img.shields.io/badge/prompts-model_independent-222222)

Expand Down Expand Up @@ -36,6 +36,19 @@ Ten sam zestaw pomysłów można rozwinąć w spokojniejszym kierunku editorial:

*Druga plansza demonstracyjna. Zmienia się charakter art direction, a nie zakres możliwości skilla.*

## Nowość w 5.10: warstwa 2026

![Style Atlas 2026: sześć fikcyjnych reklam, każda łączy format statyczny z jednym językiem wizualnym](assets/style-atlas-2026.png)

*Sześć fikcyjnych reklam złożonych deterministycznie w HTML ([źródło](assets/generated/style-atlas.html)): bez modelu obrazu, bez materiałów klientów, bez obietnic wyników. Każda łączy format perswazji z jednym językiem wizualnym.*

Skill wie teraz, jak wyglądają aktualne reklamy Meta i dlaczego pewne struktury przekonują:

- **Atlas stylów 2026** — dwanaście języków wizualnych: od plakatu z wielką typografią i edytorialu z fleszem, przez natywne notatki, banery performance ze stickerem, po taktylny zin. Każdy ma typografię, kolor, sygnaturowy detal, fragment promptu i typowy błąd.
- **Formaty statyczne** — piętnaście szkieletów perswazji (stat drop, stos recenzji, produkt z calloutami, porównanie, offer stack…). Format jest dostępny tylko wtedy, gdy istnieje jego dowód.
- **Fakty platformy 2026** — ujednolicona strefa bezpieczna Reels/Stories (14% góra, 35% dół), eksport 4:5 w 1440×1800, rozszerzanie obrazu i generowane tła w Advantage+, etykiety „AI info” oraz grupowanie niemal identycznych reklam przez Andromedę.
- **Cztery nowe reguły, R45–R48** — jeden język wizualny na reklamę, format wynika z dowodu, różnorodność daje zasięg, projekt pod system placementów 2026.

## Jak działa

```mermaid
Expand All @@ -48,7 +61,7 @@ flowchart LR

1. **Brief** — agent ustala odbiorcę, prawdziwą ofertę, cel, format i dostępne materiały.
2. **Pomysł** — wybiera, co pokaże korzyść: produkt, działanie, detal, sytuacja lub typografia.
3. **Art direction** — określa dominantę, kolejność czytania, przestrzeń na tekst, fonty i paletę.
3. **Art direction** — wybiera format, na który pozwala dowód, i jeden język wizualny, a potem określa dominantę, kolejność czytania, przestrzeń na tekst, fonty i paletę.
4. **Prompt** — zapisuje konkretną kompozycję, dokładne treści i ograniczenia.
5. **Ocena** — sprawdza spójność promptu; po wygenerowaniu obrazu również czytelność, pisownię i zgodność z materiałami.

Expand Down Expand Up @@ -95,9 +108,13 @@ Prompt wyraża intencję projektową. Nie gwarantuje identycznego fontu, położ
| [core.md](core.md) | Samodzielna instrukcja do wklejenia w czacie |
| [Art direction](references/art-direction.md) | Od celu marketingowego do kompozycji i typografii |
| [Prompt craft](references/prompt-craft.md) | Pisanie i sprawdzanie promptów |
| [Atlas stylów 2026](references/style-atlas-2026.md) | Dwanaście języków wizualnych, trend slop, czytanie plansz referencyjnych |
| [Formaty statyczne](references/static-ad-formats.md) | Szkielety perswazji, dowód, lejek i dopasowanie do branży |
| [Przykłady promptów](examples/05-model-independent-directions.md) | Flyer, gastronomia i usługa lokalna |
| [Visual Advertising Engine](visual-advertising-engine.md) | Kanoniczne reguły R01–R44 |
| [Kierunki 2026](examples/07-2026-style-directions.md) | Briefy „format + styl” i zestaw kampanii pod Andromedę |
| [Visual Advertising Engine](visual-advertising-engine.md) | Kanoniczne reguły R01–R48 |
| [Layout system](references/layout-system.md) | Punkty wyjścia dla siatki, marginesów i skali tekstu |
| [Platformy](references/platform-compliance.md) | Strefy bezpieczne, limity tekstu, Advantage+, etykiety AI |
| [QA gate](references/qa-gate.md) | Ocena rzeczywiście wygenerowanych obrazów |
| [Pozostałe przykłady](examples/README.md) | Briefy, prompty i omówienie decyzji |

Expand Down
Loading
Loading