Foundational public methodology for the first open public ranking of brand visibility in AI search results (ChatGPT, Perplexity, Gemini, Claude). This release establishes the framework — no rankings have been computed or published yet. First scan cycle: late May 2026 (private validation). First public ranking publication target: August 2026, after 3 validation cycles. Includes: - methodology.json: machine-readable formulas, weights, policies - README.md: human-readable overview + open/closed boundary - CHANGELOG.md: versioning policy + v1.0.0 release notes - taxonomy.md: tier system + 11 PL pilot categories - LICENSE: MIT - .gitignore: closed operational data (exact prompts, anti-gaming thresholds) - prompts/README.md: 6-stage prompt curation process - prompts/example-swiece-sojowe-pl.md: illustrative framework for first category Strategic principles: - Algorithm-first, no advisory board - Open methodology + closed exact prompts (Goodhart's Law defense) - No retroactive changes (FIDE 2024 lesson) - No pay-to-play, hard rule (Moody's / Forbes 30 Under 30 lessons) - Subjective opinion disclaimer (Gartner v. NetScout 2020 First Amendment shield) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
100 lines
4.2 KiB
Markdown
100 lines
4.2 KiB
Markdown
# Example prompt framework — Świece sojowe PL
|
||
|
||
> Illustrative framework showing how a category prompt pool is structured. Exact production strings remain CLOSED in `prompts/swiece-sojowe-pl/` (gitignored).
|
||
|
||
This document is **public** to demonstrate the curation process and prompt-type distribution. It is **not** the actual production prompt list.
|
||
|
||
---
|
||
|
||
## Distribution
|
||
|
||
100 prompts total, distributed by type:
|
||
|
||
| Type | Count | Weight | Share |
|
||
|---|---|---|---|
|
||
| Buying intent | 30 | 2.0 | 30% |
|
||
| Comparison | 25 | 1.5 | 25% |
|
||
| Specific need | 20 | 1.5 | 20% |
|
||
| Informational | 15 | 0.3 | 15% |
|
||
| Brand-direct | 10 | 0.3 | 10% |
|
||
|
||
## Personas referenced
|
||
|
||
- "30+ kobieta kupująca prezent dla mamy"
|
||
- "Self-care millennial 25–35 po pracy"
|
||
- "Wnętrzarz minimalistyczne mieszkanie"
|
||
- "Mężczyzna kupujący prezent walentynkowy"
|
||
- "Mama małych dzieci szukająca bezpiecznego zapachu"
|
||
- "Eko-świadomy konsument 30+"
|
||
- "Hostess kupująca świece dla agroturystyki"
|
||
|
||
## Buying intent (30 prompts × 2.0 weight) — illustrative examples
|
||
|
||
These prompts signal active purchase intent. Highest weight because they correlate directly with revenue impact for ranked brands.
|
||
|
||
- "Gdzie kupić premium ręcznie robioną świecę sojową na prezent dla mamy"
|
||
- "Polska marka świec sojowych z certyfikatem ekologicznym do 200 zł"
|
||
- "Świeca sojowa w eleganckim opakowaniu jako prezent firmowy"
|
||
- "Gdzie zamówić zestaw prezentowy z polskich świec sojowych handmade"
|
||
- *(...26 more, exact strings closed)*
|
||
|
||
## Comparison (25 prompts × 1.5 weight) — illustrative examples
|
||
|
||
Decision-stage queries. User is comparing brands or making a choice.
|
||
|
||
- "JAKULO vs Naturaodpauli — która polska marka świec sojowych lepsza"
|
||
- "Najlepsze polskie świece sojowe handmade 2026 ranking"
|
||
- "Polskie świece sojowe premium — porównanie najpopularniejszych marek"
|
||
- *(...22 more, exact strings closed)*
|
||
|
||
## Specific need (20 prompts × 1.5 weight) — illustrative examples
|
||
|
||
Specific use cases or attributes — buyer knows what they want.
|
||
|
||
- "Świeca sojowa o zapachu wanilii i bursztynu w średnim rozmiarze"
|
||
- "Długo paląca naturalna świeca sojowa do sypialni 60 godzin"
|
||
- "Świeca sojowa bezzapachowa dla osoby z alergią na zapachy"
|
||
- *(...17 more, exact strings closed)*
|
||
|
||
## Informational (15 prompts × 0.3 weight) — illustrative examples
|
||
|
||
Research-stage queries. Lower weight because easily gamed by content marketing fluff.
|
||
|
||
- "Czym różni się świeca sojowa od parafinowej"
|
||
- "Jak rozpoznać prawdziwie sojową świecę"
|
||
- "Czy świece sojowe są zdrowe i bezpieczne"
|
||
- *(...12 more, exact strings closed)*
|
||
|
||
## Brand-direct (10 prompts × 0.3 weight) — illustrative examples
|
||
|
||
Direct brand queries. Lower weight because brand winning queries about itself = baseline expectation, not value-add.
|
||
|
||
- "JAKULO opinie 2026 czy warto kupować"
|
||
- "Co sądzą o polskiej marce świec Naturaodpauli"
|
||
- *(...8 more, exact strings closed)*
|
||
|
||
## Anti-patterns (excluded)
|
||
|
||
The following types of prompts are explicitly excluded during Stage 4 (Vendor exploit hunter critic):
|
||
|
||
| Pattern | Reason | Example |
|
||
|---|---|---|
|
||
| Single-word | No buyer intent, ambiguous | "świeczki", "świece" |
|
||
| Hobbystyczny / DIY | Off-topic for retail | "DIY świece sojowe w domu" |
|
||
| B2B retail | Not consumer-facing | "hurtownia świec sojowych Warszawa" |
|
||
| Brand-agnostic generic | Easy content marketing target | "co to świeca sojowa" |
|
||
| Price-only without category context | Too vague | "tania świeca" |
|
||
| Off-topic technicality | Detection of hobby-craft, not retail | "knot bawełniany do świec wymiary" |
|
||
| Polish typos at scale | Not real query patterns | "swieczka sojova" (single typo OK if frequent in real data) |
|
||
|
||
## Quarterly rotation policy
|
||
|
||
Each quarter, 20 prompts (20% of pool) are rotated:
|
||
- 10 retired (lowest real-world search signal in past 90 days, OR known to be gamed)
|
||
- 10 added (new patterns from Reddit/Quora/trends, new persona refinements, new product attributes emerging)
|
||
|
||
Rotation log is committed to `prompts/swiece-sojowe-pl/rotation_log.md` (closed) with rationale per swap.
|
||
|
||
---
|
||
|
||
**This framework is illustrative.** The actual 100 production prompts evolve with each quarterly cycle and are not published as exact strings — only the distribution, personas, anti-patterns, and example patterns are public.
|