---
name: arteon-content
description: >
  Comprehensive content system for Arteon Agency - brand voice, writing guidelines,
  content creation, quality standards, fact verification, sales copy, workflow,
  documentation. Combines 7 skills into one deep-dive knowledge base.
---

# Skill: arteon-content

Kompletny system tworzenia treści dla Arteon Agency — od brand voice po publikację.

**Łączy:** arteon-ai-content-intelligence, arteon-content-creation, arteon-content-quality, arteon-content-workflow, arteon-fact-verification-intelligence, arteon-sales-intelligence, arteon-docs-intelligence

## Kiedy używać

- Tworzenie **dowolnych** treści (tools, blog, services, pages)
- Edycja istniejących tekstów
- Review jakości treści
- Lokalizacja/tłumaczenie
- Service pages i sales copy
- Task management i dokumentacja

## Zasady uniwersalne

Wszystkie zasady w tym skillu dotyczą KAŻDEGO typu treści:
realizacje, artykuły, strony usług, narzędzia, CTA, meta, FAQ.
Nie ma oddzielnych reguł per typ strony — te zasady to ogólny
standard pisania treści dla Arteon.

---

# CZĘŚĆ 1: BRAND VOICE

## Ton i styl (PL)

| Element       | Zasada                                                                                                                                                                                                                                            |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ton**       | Mentorski — dzielimy się wiedzą                                                                                                                                                                                                                   |
| **Styl**      | Przyjazny — jak rozmowa przy kawie                                                                                                                                                                                                                |
| **Język**     | Prosty — zrozumiały dla każdego                                                                                                                                                                                                                   |
| **Czytelnik** | "Ty" (2 os. l.poj.)                                                                                                                                                                                                                               |
| **Arteon**    | Forma bezosobowa/dokonana ("Zaprojektowane", "Zrobione", "Przygotowane") — NIE "My/Zrobiliśmy" (firma jednoosobowa). **WYJĄTEK: realizacje/case study** — 1 os. l.mn. OK ("Przygotowaliśmy", "Stworzyliśmy") bo case study opisuje wykonaną pracę |

## Przykłady tonu

```
✅ Mentorski:
"Dobra strona internetowa przyciąga klientów i buduje zaufanie.
Pokażę Ci, jak to osiągnąć."

❌ Korpo:
"Oferujemy kompleksowe rozwiązania webowe dla biznesu."

❌ AI-like:
"W dzisiejszych czasach każda firma potrzebuje strony."

❌ Liczba mnoga na stronach usług/narzędzi (firma jednoosobowa):
"Zaprojektowaliśmy logo, które buduje zaufanie."

✅ Forma bezosobowa (usługi/narzędzia):
"Logo zaprojektowane tak, żeby budowało zaufanie od pierwszego kontaktu."

✅ Liczba mnoga w realizacjach/case study:
"Zaprojektowaliśmy logo z ikoną dachu i literami F i M."
```

---

# CZĘŚĆ 2: FORBIDDEN PHRASES

## Korpo-język

| ❌ Nie używaj           | ✅ Zamień na              | Dlaczego     |
| ----------------------- | ------------------------- | ------------ |
| kompleksowe rozwiązania | konkretny opis co robimy  | Puste słowa  |
| innowacyjne podejście   | opisz faktyczną innowację | Oklepane     |
| kluczowe korzyści       | ważne korzyści            | Korpo        |
| optymalizacja procesów  | co konkretnie przyspiesza | Abstrakcja   |
| stanowi fundament       | jest podstawą             | Sztywne      |
| idealne rozwiązanie     | dobre rozwiązanie         | Przesada     |
| maksymalizacja ROI      | zwrot z inwestycji        | Żargon       |
| holistyczne podejście   | pełne podejście           | Marketingowe |

## AI-typowe frazy

| ❌ Nie używaj               | ✅ Zamień na             | Dlaczego   |
| --------------------------- | ------------------------ | ---------- |
| w dzisiejszych czasach      | (usuń, zacznij od sedna) | Filler     |
| Wyobraź sobie...            | Załóżmy... / Przykład:   | AI-pattern |
| krok po kroku (w nagłówku)  | opisz konkretnie         | Overused   |
| kompletny przewodnik        | (usuń, niech treść mówi) | Clickbait  |
| wszystko co musisz wiedzieć | (usuń)                   | AI-pattern |
| w świecie X                 | (usuń)                   | Filler     |
| nie jest tajemnicą, że      | (usuń)                   | Filler     |

## Zaawansowane wzorce AI (z humanizer)

| Wzorzec                | Problem                       | Fix                                     |
| ---------------------- | ----------------------------- | --------------------------------------- |
| **Rule of Three**      | "innowacja, jakość, sukces"   | Opisz konkretnie, nie listuj abstrakcji |
| **Em dash overuse**    | zbyt wiele — myślników        | Użyj przecinków lub kropek              |
| **Elegant variation**  | ciągłe synonimy jednego słowa | Powtórzenia są OK                       |
| **False ranges**       | "od X do Y" bez skali         | Usuń lub podaj konkretne liczby         |
| **Sycophantic tone**   | "Świetne pytanie!"            | Przejdź do sedna                        |
| **Inflated symbolism** | "This represents..."          | Opisz bez nadawania znaczenia           |

## Tekst "bez duszy" (soulless writing)

Nawet "czysty" tekst może być oczywisto AI jeśli:

- Każde zdanie ma tę samą długość
- Brak opinii, tylko neutralne raportowanie
- Brak niepewności lub mieszanych uczuć
- Brak perspektywy pierwszej osoby
- Brak humoru, charakteru, osobowości

**Jak dodać głos:**

- Miej opinię ("Warto zwrócić uwagę, że...")
- Mieszaj rytm zdań (krótkie. Potem dłuższe, które budują myśl.)
- Przyznaj złożoność ("To skuteczne, ale wymaga czasu")
- Forma bezosobowa dla Arteon ("Zaprojektowane", "Przygotowane") — w edukacyjnych dopuszczalne "pomagamy"

## Anglicyzmy

| ❌ Nie używaj  | ✅ Zamień na          |
| -------------- | --------------------- |
| social media   | media społecznościowe |
| deadline       | termin                |
| feedback       | opinia, uwagi         |
| content        | treść, treści         |
| call to action | wezwanie do działania |
| landing page   | strona docelowa       |
| online         | (usuń — oczywiste)    |

---

# CZĘŚĆ 3: WRITING RULES

## 1. Zacznij od sedna

```
❌ "W dzisiejszych czasach strona internetowa jest niezbędna..."
✅ "Strona internetowa pomaga pozyskiwać klientów na trzy sposoby..."

❌ "Wielu przedsiębiorców zastanawia się..."
✅ "Dobra strona generuje leady. Oto jak to działa..."
```

## 2. Wyjaśniaj terminy natychmiast

```
❌ "Optymalizacja Core Web Vitals jest ważna."
✅ "Core Web Vitals to metryki Google mierzące szybkość i wygodę
   korzystania ze strony. Dobre wyniki pomagają w pozycjonowaniu."

❌ "Potrzebujesz PWA."
✅ "PWA (Progressive Web App) to strona, która działa jak aplikacja
   mobilna — bez instalacji ze sklepu."
```

## 3. Pełne zdania (nie równoważniki)

```
❌ "Szybka realizacja. Konkurencyjne ceny. Doświadczony zespół."
✅ "Realizujemy projekty w 2-4 tygodnie. Nasze ceny są konkurencyjne
   w stosunku do jakości. Zespół ma 10 lat doświadczenia."
```

## 4. Konkretne przykłady

```
❌ "Pomagamy firmom z różnych branż."
✅ "Pracowaliśmy z kancelariami prawnymi, klinikami medycznymi,
   restauracjami i sklepami e-commerce."
```

## 5. Unikaj generalizacji

```
❌ "SEO jest ważne dla każdej firmy."
✅ "SEO pomaga klientom znaleźć Twoją firmę w Google.
   Dla lokalnych usług to często główne źródło nowych klientów."
```

## 6. Opisuj firmy przez działalność, nie etykiety

```
❌ "firma izolacyjna" / "firma wykończeniowa" / "kawiarnia rzemieślnicza"
✅ "firma zajmująca się izolacją budynków"
✅ "firma zajmująca się wykończeniem mieszkań, domów i lokali usługowych"
✅ "mała palarnia kawy z własnym procesem palenia"
```

Ludzki język opisuje CO firma robi. Etykiety przymiotnikowe to skróty
myślowe z briefów — czytelnik ich nie używa.

## 7. Nie upraszczaj nadmiernie (WAŻNE)

Więcej opisów z kontekstem = więcej fraz kluczowych = bardziej naturalnie.
Bogaty opis z detalami brzmi ludzko. Suchy, skrócony tekst brzmi jak AI.

```
❌ Over-simplified: "Logo — sygnet z dachem i literami, autorska czcionka."
✅ Rozbudowane: "Projekt logo dla firmy zajmującej się wykończeniem mieszkań,
   domów i lokali usługowych. Pełen system logo z wariantami do różnych
   zastosowań z autorską edycją czcionki i wpisanymi inicjałami firmy w ikonę."
```

Praktyczne informacje (warianty, zastosowania, formaty) NIGDY nie są zbędne.
Atmosferyczne opisy (klimat, estetyka, charakter) NIGDY nie są "promotional".

## 8. Równoważniki zdań w meta descriptions i opisach (KRYTYCZNE)

Ta sama reguła co w CONTENT_INSTRUCTIONS §9 dotyczy WSZYSTKICH treści:
meta descriptions, short descriptions, CTA descriptions, contentBlocks.

```
❌ "Blog firmowy, formularz wyceny, kolory WCAG, szybkie ładowanie."
✅ "Sprawdź realizację strony z firmowym blogiem, dedykowanym formularzem
   wycen dla klientów i ekspresowym czasem ładowania na wszystkich urządzeniach."
```

Wpleć elementy w naturalny tok zdania z kontekstem i przymiotnikami.

---

# CZĘŚĆ 4: EXAMPLES DOMAIN

## Używaj przykładów z branż

- ✅ **Prawo** (kancelarie prawne)
- ✅ **Medycyna** (kliniki, gabinety)
- ✅ **Gastronomia** (restauracje, catering)
- ✅ **Nieruchomości** (agencje, deweloperzy)
- ✅ **E-commerce** (sklepy online)
- ✅ **Produkcja** (firmy przemysłowe)

## NIE używaj

- ❌ Web development (nasza branża)
- ❌ Grafika/design (nasza branża)
- ❌ Marketing (nasza branża)
- ❌ IT/Software (zbyt techniczne)

## Przykład prawidłowy

```
✅ "Załóżmy, że prowadzisz kancelarię prawną w Warszawie.
   Twoi potencjalni klienci szukają 'adwokat Warszawa' w Google..."

❌ "Załóżmy, że prowadzisz agencję marketingową..."
```

---

# CZĘŚĆ 5: META TAGS

## Title (50-60 znaków)

| Zasada              | Przykład                       |
| ------------------- | ------------------------------ |
| Keyword na początku | "Generator palety kolorów..."  |
| Bez "online"        | ❌ "...online" ✅ "Darmowy..." |
| Benefit-focused     | "...twórz harmonijne palety"   |
| Bez brand na końcu  | ❌ "... \| Arteon"             |

```
✅ "Darmowy generator palety kolorów - twórz harmonijne palety"
❌ "Generator palety kolorów online | Arteon"
❌ "Najlepszy generator kolorów w internecie"
```

### Hero Title dla narzędzi konwerterów (KRYTYCZNE)

Hero title = tag H1. Dla konwerterów musi odzwierciedlać intencję wyszukiwania — oba formaty muszą być widoczne w tytule.

**Formuła PL:** `[Przelicz/Zamień] [FORMAT_A] na [FORMAT_B] – [kontekst, max 5 słów]`
**Formuła EN:** `Convert [FORMAT_A] to [FORMAT_B] – [context, max 5 words]`

Zasady: oba formaty w tytule, czasownik akcji, brak fillerów ("bez zgadywania", "jednym miejscu"), max 70 znaków.

```
✅ "Przelicz RGB na HSL – konwerter kolorów CSS"
✅ "Przelicz em na px – konwerter CSS z ustawianym font-size"
✅ "Zamień HTML na Markdown – konwerter treści"
✅ "Convert RGB to HSL – CSS color converter"
❌ "Kolory CSS w formacie HSL – twórz palety" (brak "RGB")
❌ "Oblicz piksele z em bez zgadywania" (filler, brak "em na px")
❌ "HTML na Markdown – migracja treści z CMS" (use-case zamiast intencji)
❌ "Bajty, KB, MB, GB, TB w jednym miejscu" (brak intencji konwersji)
```

## Description (150-160 znaków)

| Zasada            | Przykład                      |
| ----------------- | ----------------------------- |
| Keyword + benefit | "Stwórz paletę kolorów..."    |
| Call to action    | "...eksportuj do CSS"         |
| Trust signals     | "Bez rejestracji, bez limitu" |

```
✅ "Stwórz paletę kolorów w kilka sekund. Bez rejestracji, bez limitu.
   Eksportuj do CSS, Tailwind, SCSS."

❌ "Narzędzie online do generowania palet kolorów."
❌ "Najlepsze narzędzie do kolorów w internecie za darmo."
```

---

# CZĘŚĆ 6: CONTENT TYPES

## Tool Pages

### Struktura

```
1. Hero (title, description)
2. Tool component
3. How it works (steps)
4. Features/benefits
5. Cultural/contextual content
6. FAQ
7. Related tools carousel
8. CTA (contact form)
```

### JSON Template

```json
{
  "toolKey": "color-palette",
  "locale": "pl",
  "metadata": {
    "title": "Darmowy generator palety kolorów - harmonijne palety",
    "description": "Stwórz paletę kolorów w sekundy. 9 harmonii, eksport CSS/Tailwind. Bez rejestracji.",
    "path": "/narzedzia/generator-palety-kolorow",
    "ogImage": "/assets/tools/color-palette/og.webp"
  },
  "hero": {
    "title": "Generator palety kolorów",
    "description": "Twórz piękne, harmonijne palety w kilka kliknięć"
  },
  "schemas": {
    "software": {
      "name": "Generator palety kolorów",
      "alternateName": ["Kreator palet", "Color palette generator"],
      "featureList": ["9 typów harmonii", "Eksport CSS"]
    }
  },
  "contentBlocks": [
    { "type": "sectionInfo", "title": "O narzędziu", "html": "..." },
    { "type": "faq", "items": [...] }
  ]
}
```

## Blog Articles

### Struktura

```
1. Engaging intro (NO "W dzisiejszych czasach")
2. Problem statement
3. Solution with examples
4. Actionable steps
5. Summary/CTA
6. Internal links (Zobacz też)
```

### Requirements

- **Min. 1400 słów** dla rankowalności
- **Questioning headlines** (prowadzą przez artykuł)
- **Internal links** do usług i narzędzi
- **Problem → rozwiązanie → CTA**
- **Nowe artykuły na górze listy** w blog.json

### JSON Template

```json
{
  "id": 1,
  "slug": "jak-dobrac-kolory-do-strony",
  "title": "Jak dobrać kolory do strony internetowej",
  "excerpt": "Praktyczny przewodnik po teorii koloru...",
  "category": "design",
  "tags": ["kolory", "design", "UX"],
  "datePublished": "2024-01-15",
  "cover": "/assets/blog/slug/cover.webp",
  "content": "..."
}
```

## Service Pages

### Struktura

```
1. Hero - Clear value proposition
2. Benefits - What client gets (FIRST!)
3. Process - How we work
4. Features - What's included
5. Portfolio - Case studies
6. Testimonials - Social proof
7. Pricing - Starting from
8. FAQ - Common questions
9. CTA - Contact form
```

### Pricing Display (Arteon has VAT exemption)

```typescript
// Show "from" pricing - all prices are final (no brutto/netto)
const priceDisplay = {
  websites: 'od 3 500 zł',
  ecommerce: 'od 8 000 zł',
  seo: 'od 1 500 zł/mies.',
  graphics: 'od 500 zł',
};
// NEVER mention "VAT 23%" or similar
```

---

# CZĘŚĆ 7: SALES & LEAD GENERATION

## Service Offerings

| Service            | Path                         | Target     |
| ------------------ | ---------------------------- | ---------- |
| Strony internetowe | `/uslugi/strony-internetowe` | Businesses |
| Sklepy internetowe | `/uslugi/sklepy-internetowe` | E-commerce |
| SEO                | `/uslugi/seo`                | Lead gen   |
| Grafika            | `/uslugi/grafika`            | Branding   |

## Tool → Service Flow

```
User uses free tool
    ↓
Sees CTA: "Potrzebujesz profesjonalnej pomocy?"
    ↓
Clicks → Service page
    ↓
Reads benefits
    ↓
Contacts via form
```

## CTAs

```typescript
// Tool page CTA
const toolCTA = {
  title: 'Potrzebujesz profesjonalnej strony?',
  description: 'Sprawdź jak możesz przyciągnąć więcej klientów dzięki dobrze zaprojektowanej stronie',
  button: 'Skontaktuj się',
  link: '/kontakt',
};

// Service page CTA
const serviceCTA = {
  title: 'Zamów bezpłatną wycenę',
  description: 'Odpowiemy w 24h',
  button: 'Wyślij zapytanie',
  link: '/kontakt',
};
```

## CTA na stronach realizacji (WAŻNE)

- Tytuł: otwarte pytanie ("Potrzebujesz rozbudowy swojej strony?")
- Opis: korzyść dla CZYTELNIKA + co robimy ogólnie + zaproszenie do kontaktu
- NIGDY nie referuj do konkretnego projektu innego klienta w CTA
- NIGDY nie obiecuj "zrobimy to samo" — każdy projekt jest indywidualny
- Przekaz: "pomagamy" nie "zrobimy za Ciebie"

```typescript
// ✅ Dobre CTA dla realizacji
const projectCTA = {
  title: 'Potrzebujesz rozbudowy swojej strony?',
  description: 'Pomagamy rozbudować strony na różnych platformach (Wix, WordPress, Shopify). Skontaktuj się i sprawdź jak możesz przyciągnąć więcej klientów z Google dzięki rozbudowie strony.',
};

// ❌ Złe CTA — referuje do innego klienta, brak indywidualnego podejścia
const badCTA = {
  title: 'Twoja strona na Wix nie przyciąga pacjentów?',
  description: 'Rozbudujemy ją tak jak zrobiliśmy to dla Perły Mocy.',
};
```

## Trust Signals

- Testimonials from real clients
- Case studies with results
- Years of experience
- Number of projects (200+)
- Fast response promise (24h)

## Content Guidelines for Sales

```
✅ Konkretne korzyści
"Strona, która przyciąga klientów i zwiększa sprzedaż"

❌ Ogólniki
"Profesjonalne usługi webowe"

✅ Transparent pricing
"Od 3 500 zł za pełną stronę z CMS"

❌ Ukryte koszty
"Cena do ustalenia"
```

---

# CZĘŚĆ 8: FACT VERIFICATION

## Przepisywanie istniejącej treści (KRYTYCZNE)

Przy edycji/przepisywaniu istniejącej treści (np. projects.json, service pages):

- NIGDY nie dodawaj faktów, liczb ani detali których nie ma w danych źródłowych
- Nie wymyślaj czasu realizacji, nazw technologii, wyników ani kontekstu
- Jeśli brakuje konkretów — zostaw jak jest lub poproś o dane
- "Konkretność" oznacza: wydobądź konkrety z ISTNIEJĄCYCH danych, nie wymyślaj nowych

## All Claims Must Be True

```
❌ "SEO zwiększa ruch o 300%"
   (bez źródła, generalizacja)

✅ "Według badania Ahrefs z 2023, strony na pozycji 1
   otrzymują średnio 27.6% wszystkich kliknięć"
   (źródło, konkretne dane)
```

## Statistics Need Sources

```markdown
✅ Core Web Vitals wpływa na rankingi — Google potwierdziło
to w [oficjalnym ogłoszeniu](link).

❌ 90% użytkowników opuszcza wolne strony.
(skąd ta liczba?)
```

## Hypotheticals Must Be Marked

```
✅ "Załóżmy, że prowadzisz restaurację..."
✅ "Przykład: Firma X zwiększyła sprzedaż o 20%"

❌ "Firmy zwiększają sprzedaż o 20% dzięki SEO"
   (generalizacja bez dowodu)
```

## Common Issues

| Issue        | Bad                      | Good                           |
| ------------ | ------------------------ | ------------------------------ |
| Vague claims | "Najlepszy generator"    | "Generator z 9 harmoniami"     |
| Outdated     | "Google używa FID"       | "Google używa INP od 2024"     |
| Unverifiable | "80% firm nie ma strony" | "Według GUS 2023, 75% firm..." |

## Acceptable Sources

- Oficjalne blogi (Google, React)
- Badania (Ahrefs, Moz, Semrush)
- Raporty branżowe
- Dokumentacja techniczna
- Statystyki rządowe (GUS)

## Unacceptable Sources

- Wikipedia (secondary)
- Fora internetowe
- Nieweryfikowalne źródła
- Bardzo stare dane (>3 lata)

---

# CZĘŚĆ 9: WORKFLOW

## Before Starting Any Content Task

```
1. Check docs/TASKS.md for task details
2. Read docs/CONTENT_INSTRUCTIONS.md
3. Review relevant CATALOG (BLOG, TOOLS, COMPONENTS)
4. Research keywords (if SEO content)
5. Review similar existing content
```

## Content Creation Process

```
1. Write content following these guidelines
2. Self-review against quality checklist
3. Update JSON files
4. Validate JSON syntax
5. Present changes in table format
```

## After Completion

```
1. Present changes in table format
2. Update TASKS.md status
3. Move completed task to DONE_TASKS.md
4. Build test (if required)
```

## Build Requirements

| Scenario                                      | Build Required? |
| --------------------------------------------- | --------------- |
| Text-only changes                             | ❌ No           |
| Content edits in JSON                         | ❌ No           |
| Tasks marked "Weryfikacja: nie jest wymagana" | ❌ No           |
| Code changes                                  | ✅ Yes          |
| UI modifications                              | ✅ Yes          |
| Logic changes                                 | ✅ Yes          |

---

# CZĘŚĆ 10: DOCUMENTATION STRUCTURE

## docs/ Folder

```
docs/
├── TASKS.md              # Current tasks
├── DONE_TASKS.md         # Completed tasks
├── CONTENT_INSTRUCTIONS.md  # Content guidelines
├── BLOG_CATALOG.md       # Blog article registry
├── BLOG_IDEAS_300.md     # Blog ideas backlog
├── COMPONENTS_CATALOG.md # Component registry
├── TOOLS_CATALOG.md      # Tools registry
└── superpowers/plans/    # Feature plans
```

## TASKS.md Format

```markdown
## TASK-001: Tytuł zadania

**Status:** 🟡 W trakcie
**Priorytet:** Wysoki
**Weryfikacja:** npm run build / nie jest wymagana

### Opis

Co trzeba zrobić.

### Kryteria akceptacji

- [ ] Kryterium 1
- [ ] Kryterium 2
```

## Status Icons

| Icon | Meaning     |
| ---- | ----------- |
| ✅   | Completed   |
| 🟡   | In progress |
| ❌   | Blocked     |
| ⏸️   | On hold     |

## Change Documentation

After content changes, ALWAYS present in table:

```markdown
| Element    | Przed                 | Po                     |
| ---------- | --------------------- | ---------------------- |
| Meta title | "Generator online..." | "Darmowy generator..." |
| H1         | "Narzędzie do..."     | "Generator palety..."  |
| CTA        | "Kliknij"             | "Stwórz paletę"        |
```

---

# CZĘŚĆ 11: QUALITY CHECKLISTS

## Content Quality (przed publikacją)

- [ ] Wstęp zaczyna od sedna (nie "W dzisiejszych czasach...")
- [ ] Każdy termin techniczny wyjaśniony natychmiast
- [ ] Brak fraz AI-typowych (Rule of Three, em dash overuse)
- [ ] Brak korpo-języka
- [ ] Brak anglicyzmów (lub wyjaśnione)
- [ ] Pełne zdania (nie równoważniki)
- [ ] Konkretne przykłady z właściwych branż
- [ ] Mieszany rytm zdań (nie wszystkie tej samej długości)

## SEO Quality

- [ ] Meta title 50-60 znaków, keyword na początku
- [ ] Meta description 150-160 znaków
- [ ] Bez "online" w title/description
- [ ] Keyword w H1
- [ ] Internal links do usług/narzędzi
- [ ] HowTo schema dla tools
- [ ] alternateName w schema

## Fact Verification

- [ ] Każde zdanie jest prawdziwe
- [ ] Każda liczba/statystyka ma źródło
- [ ] Źródła są aktualne (max 2-3 lata)
- [ ] Linki działają
- [ ] Przykłady hipotetyczne oznaczone
- [ ] Brak niepotwierdzonych claimów

## Technical

- [ ] JSON syntax valid
- [ ] All locales updated (if applicable)
- [ ] Images have alt text
- [ ] No broken links

---

# CZĘŚĆ 12: FILES REFERENCE

| File                            | Purpose                 |
| ------------------------------- | ----------------------- |
| `docs/TASKS.md`                 | Current tasks           |
| `docs/DONE_TASKS.md`            | Completed tasks         |
| `docs/CONTENT_INSTRUCTIONS.md`  | Full content guidelines |
| `docs/BLOG_CATALOG.md`          | Blog article registry   |
| `docs/TOOLS_CATALOG.md`         | Tools registry          |
| `docs/COMPONENTS_CATALOG.md`    | Component registry      |
| `data/{locale}/tools/*.json`    | Tool content            |
| `data/{locale}/dictionary.json` | UI strings              |
| `data/{locale}/pages/*.json`    | Static pages            |
| `data/pl/blog.json`             | Blog articles           |
| `CLAUDE.md`                     | Project overview for AI |

---

# QUICK REFERENCE

## Starting a content task

```bash
# 1. Check task
cat docs/TASKS.md

# 2. Read guidelines
cat docs/CONTENT_INSTRUCTIONS.md

# 3. Validate JSON after editing
node -e "JSON.parse(require('fs').readFileSync('data/pl/tools/x.json'))"
```

## Meta tag lengths

| Element     | Length        |
| ----------- | ------------- |
| Title       | 50-60 chars   |
| Description | 150-160 chars |

## Forbidden words quick check

- ❌ online, kompleksowe, innowacyjne, kluczowe
- ❌ w dzisiejszych czasach, wyobraź sobie
- ❌ social media, feedback, content, deadline