julian
17c08e6392
- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
164 lines
4.3 KiB
Markdown
164 lines
4.3 KiB
Markdown
# SEO Content Instructions
|
|
|
|
**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:
|
|
|
|
1. Find this page in the **Page-Keyword Map**
|
|
2. Note the **primary keyword** and **secondary keywords**
|
|
3. Note the **URL slug**
|
|
4. 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
|
|
|
|
```markdown
|
|
**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:
|
|
|
|
```markdown
|
|
### 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:
|
|
|
|
```markdown
|
|
### 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](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:
|
|
|
|
```markdown
|
|
### 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:
|
|
|
|
```markdown
|
|
## 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}
|
|
```
|
|
|
|
---
|
|
|
|
## Related
|
|
|
|
- [Meta Content Instructions](meta-content.instructions.md) — Detailed meta content specification
|
|
- [SEO Strategy Guide](../../../data/agent-guides/saga/seo-strategy-guide.md) — Comprehensive SEO reference
|
|
- [Specification Quality](../../../data/agent-guides/freya/specification-quality.md) — Quality checklist
|
|
|
|
---
|
|
|
|
*Every public page is a search result. Specify it accordingly.*
|