calctext/seo-content.instructions.md at main

cassel/calctext

Fork 0

Files

C. Cassel bfe0e01254 initial commit

2026-03-16 19:54:53 -04:00

4.3 KiB

Raw Permalink Blame History

Condition: Include when page visibility = "Public"

Purpose

Ensure every public page is optimized for search engines during specification — not as an afterthought during development.

Required: Check Project Brief SEO Strategy

Before specifying this page, check the project brief's SEO Strategy section:

Find this page in the Page-Keyword Map
Note the primary keyword and secondary keywords
Note the URL slug
Note any structured data requirements

If the page is missing from the keyword map, flag it as an open question.

SEO Specification Checklist

1. URL Slug

**URL:** /{slug}

Short, descriptive, keyword-rich
Lowercase, hyphens between words
No special characters (å→a, ä→a, ö→o)
Consistent with URL structure pattern from project brief

2. Heading Hierarchy

Verify the page has:

Exactly one H1 — Contains primary keyword
Logical H2 → H3 flow — No skipped levels
Keywords in headings — Natural placement, not stuffed
H1 differs from page title tag if needed (H1 = on-page, title = search results)

Document in page spec:

### Heading Hierarchy

| Level | Content | Keyword |
|-------|---------|---------|
| H1 | {Main page heading} | {primary keyword} |
| H2 | {Section heading} | {secondary keyword} |
| H3 | {Subsection heading} | — |

3. Internal Links

Every public page should link to at least 2 other pages on the site.

Descriptive anchor text — "Läs mer om vår AC-service" not "Klicka här"
Related content links — Service ↔ vehicle type, article ↔ service
CTA links — Contact, phone, booking

Document link targets:

### Internal Links

| Anchor Text | Target Page | Context |
|-------------|-------------|---------|
| "Läs mer om service" | /service | About section |
| "Ring oss" | tel:+46485-27070 | CTA section |

4. Image SEO

For every image on the page:

Alt text in all languages — Descriptive, keyword where relevant
File name — Descriptive (verkstad-ac-service.jpg not IMG_001.jpg)
Dimensions specified — Width and height attributes (prevents CLS)
Max file size — < 200KB per image (hero images < 400KB)
Format — WebP with JPEG/PNG fallback
Lazy loading — For below-the-fold images
Responsive — srcset for mobile/desktop versions of large images

5. Meta Content

Include the meta content section (see meta-content.instructions.md):

Page title — ≤ 60 chars, includes primary keyword + brand
Meta description — 150-160 chars, includes keyword + CTA
Social sharing — Title, description, image

6. Structured Data

If the project brief's structured data plan includes this page type:

### Structured Data

**Schema Type:** {e.g., Service, Article, FAQPage}

| Property | Value |
|----------|-------|
| name | {service/article name} |
| description | {from meta description} |
| provider | {business name} |

SEO Section Template

Add this section to the page specification:

## SEO & Search

**Primary Keyword (SE):** {keyword}
**Primary Keyword (EN):** {keyword}
**Primary Keyword (DE):** {keyword}
**URL:** /{slug}

### Page Title (Browser Tab & Search Results)

- SE: "{title} | {brand}" (≤ 60 chars)
- EN: "{title} | {brand}" (≤ 60 chars)
- DE: "{title} | {brand}" (≤ 60 chars)

### Meta Description

- SE: "{description with keyword and CTA}" (150-160 chars)
- EN: "{description with keyword and CTA}" (150-160 chars)
- DE: "{description with keyword and CTA}" (150-160 chars)

### Heading Hierarchy

| Level | SE | EN | DE | Keyword |
|-------|----|----|----|---------|
| H1 | ... | ... | ... | primary |
| H2 | ... | ... | ... | secondary |

### Structured Data

**Type:** {Schema type}

Meta Content Instructions — Detailed meta content specification
SEO Strategy Guide — Comprehensive SEO reference
Specification Quality — Quality checklist

Every public page is a search result. Specify it accordingly.

4.3 KiB Raw Permalink Blame History

SEO Content Instructions