codehava-agent-kit 1.0.1 → 3.0.0

package/templates/.agent/skills/seo/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: seo
+description: "Run a broad SEO audit across technical SEO, on-page SEO, schema, sitemaps, content quality, AI search readiness, and GEO. Use as the umbrella skill when the user asks for a full SEO analysis or strategy."
+risk: unknown
+source: "https://github.com/AgriciDaniel/claude-seo"
+date_added: "2026-03-21"
+user-invokable: true
+argument-hint: "[command] [url]"
+---
+
+# SEO: Universal SEO Analysis Skill
+
+Comprehensive SEO analysis across all industries (SaaS, local services,
+e-commerce, publishers, agencies). Orchestrates 12 specialized sub-skills and 7 subagents
+(+ optional extension sub-skills like seo-dataforseo).
+
+## When to Use
+
+- Use when the user asks for a full SEO audit or broad SEO strategy.
+- Use as the umbrella entry point when multiple SEO dimensions are in scope.
+- Use when the task spans technical SEO, content, schema, sitemaps, and AI search readiness together.
+
+## Quick Reference
+
+| Command | What it does |
+|---------|-------------|
+| `/seo audit <url>` | Full website audit with parallel subagent delegation |
+| `/seo page <url>` | Deep single-page analysis |
+| `/seo sitemap <url or generate>` | Analyze or generate XML sitemaps |
+| `/seo schema <url>` | Detect, validate, and generate Schema.org markup |
+| `/seo images <url>` | Image optimization analysis |
+| `/seo technical <url>` | Technical SEO audit (9 categories) |
+| `/seo content <url>` | E-E-A-T and content quality analysis |
+| `/seo geo <url>` | AI Overviews / Generative Engine Optimization |
+| `/seo plan <business-type>` | Strategic SEO planning |
+| `/seo programmatic [url\|plan]` | Programmatic SEO analysis and planning |
+| `/seo competitor-pages [url\|generate]` | Competitor comparison page generation |
+| `/seo hreflang [url]` | Hreflang/i18n SEO audit and generation |
+| `/seo dataforseo [command]` | Live SEO data via DataForSEO (extension) |
+| `/seo image-gen [use-case] <description>` | AI image generation for SEO assets (extension) |
+
+## Orchestration Logic
+
+When the user invokes `/seo audit`, delegate to subagents in parallel:
+1. Detect business type (SaaS, local, ecommerce, publisher, agency, other)
+2. Spawn subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo
+3. Collect results and generate unified report with SEO Health Score (0-100)
+4. Create prioritized action plan (Critical -> High -> Medium -> Low)
+
+For individual commands, load the relevant sub-skill directly.
+
+## Industry Detection
+
+Detect business type from homepage signals:
+- **SaaS**: pricing page, /features, /integrations, /docs, "free trial", "sign up"
+- **Local Service**: phone number, address, service area, "serving [city]", Google Maps embed
+- **E-commerce**: /products, /collections, /cart, "add to cart", product schema
+- **Publisher**: /blog, /articles, /topics, article schema, author pages, publication dates
+- **Agency**: /case-studies, /portfolio, /industries, "our work", client logos
+
+## Quality Gates
+
+Read `references/quality-gates.md` for thin content thresholds per page type.
+Hard rules:
+- WARNING at 30+ location pages (enforce 60%+ unique content)
+- HARD STOP at 50+ location pages (require user justification)
+- Never recommend HowTo schema (deprecated Sept 2023)
+- FAQ schema for Google rich results: only government and healthcare sites (Aug 2023 restriction); existing FAQPage on commercial sites -> flag Info priority (not Critical), noting AI/LLM citation benefit; adding new FAQPage -> not recommended for Google benefit
+- All Core Web Vitals references use INP, never FID
+
+## Reference Files
+
+Load these on-demand as needed (do NOT load all at startup):
+- `references/cwv-thresholds.md`: Current Core Web Vitals thresholds and measurement details
+- `references/schema-types.md`: All supported schema types with deprecation status
+- `references/eeat-framework.md`: E-E-A-T evaluation criteria (Sept 2025 QRG update)
+- `references/quality-gates.md`: Content length minimums, uniqueness thresholds
+
+## Scoring Methodology
+
+### SEO Health Score (0-100)
+Weighted aggregate of all categories:
+
+| Category | Weight |
+|----------|--------|
+| Technical SEO | 22% |
+| Content Quality | 23% |
+| On-Page SEO | 20% |
+| Schema / Structured Data | 10% |
+| Performance (CWV) | 10% |
+| AI Search Readiness | 10% |
+| Images | 5% |
+
+### Priority Levels
+- **Critical**: Blocks indexing or causes penalties (immediate fix required)
+- **High**: Significantly impacts rankings (fix within 1 week)
+- **Medium**: Optimization opportunity (fix within 1 month)
+- **Low**: Nice to have (backlog)
+
+## Sub-Skills
+
+This skill orchestrates 12 specialized sub-skills (+ 2 extensions):
+
+1. **seo-audit** -- Full website audit with parallel delegation
+2. **seo-page** -- Deep single-page analysis
+3. **seo-technical** -- Technical SEO (9 categories)
+4. **seo-content** -- E-E-A-T and content quality
+5. **seo-schema** -- Schema markup detection and generation
+6. **seo-images** -- Image optimization
+7. **seo-sitemap** -- Sitemap analysis and generation
+8. **seo-geo** -- AI Overviews / GEO optimization
+9. **seo-plan** -- Strategic planning with templates
+10. **seo-programmatic** -- Programmatic SEO analysis and planning
+11. **seo-competitor-pages** -- Competitor comparison page generation
+12. **seo-hreflang** -- Hreflang/i18n SEO audit and generation
+13. **seo-dataforseo** -- Live SEO data via DataForSEO MCP (extension)
+14. **seo-image-gen** -- AI image generation for SEO assets via Gemini (extension)
+
+## Subagents
+
+For parallel analysis during audits:
+- `seo-technical` -- Crawlability, indexability, security, CWV
+- `seo-content` -- E-E-A-T, readability, thin content
+- `seo-schema` -- Detection, validation, generation
+- `seo-sitemap` -- Structure, coverage, quality gates
+- `seo-performance` -- Core Web Vitals measurement
+- `seo-visual` -- Screenshots, mobile testing, above-fold
+- `seo-geo` -- AI crawler access, llms.txt, citability, brand mention signals
+- `seo-dataforseo` -- Live SERP, keyword, backlink, local SEO data (extension, optional)
+- `seo-image-gen` -- SEO image audit and generation plan (extension, optional)
+
+## Error Handling
+
+| Scenario | Action |
+|----------|--------|
+| Unrecognized command | List available commands from the Quick Reference table. Suggest the closest matching command. |
+| URL unreachable | Report the error and suggest the user verify the URL. Do not attempt to guess site content. |
+| Sub-skill fails during audit | Report partial results from successful sub-skills. Clearly note which sub-skill failed and why. Suggest re-running the failed sub-skill individually. |
+| Ambiguous business type detection | Present the top two detected types with supporting signals. Ask the user to confirm before proceeding with industry-specific recommendations. |

package/templates/.agent/skills/seo/references/cwv-thresholds.md

@@ -0,0 +1,108 @@
+<!-- Updated: 2026-02-07 -->
+# Core Web Vitals Thresholds (February 2026)
+
+## Current Metrics
+
+| Metric | Good | Needs Improvement | Poor |
+|--------|------|-------------------|------|
+| LCP (Largest Contentful Paint) | ≤2.5s | 2.5s–4.0s | >4.0s |
+| INP (Interaction to Next Paint) | ≤200ms | 200ms–500ms | >500ms |
+| CLS (Cumulative Layout Shift) | ≤0.1 | 0.1–0.25 | >0.25 |
+
+## Key Facts
+- INP replaced FID (First Input Delay) on **March 12, 2024**. FID was fully removed from all Chrome tools (CrUX API, PageSpeed Insights, Lighthouse) on **September 9, 2024**. INP is the sole interactivity metric.
+- Evaluation uses the **75th percentile** of real user data (field data from CrUX).
+- Google assesses at the **page level** and the **origin level**.
+- Core Web Vitals are a **tiebreaker** ranking signal: they matter most when content quality is similar between competitors.
+- **Thresholds unchanged since original definitions**: ignore claims of "tightened thresholds" from SEO blogs.
+- December 2025 core update appeared to weight **mobile CWV more heavily**.
+- As of October 2025: **57.1%** desktop sites and **49.7%** mobile sites pass all three CWV.
+
+## LCP Subparts (February 2025 CrUX Addition)
+
+LCP can now be broken into diagnostic subparts:
+
+| Subpart | What It Measures | Target |
+|---------|------------------|--------|
+| **TTFB** | Time to First Byte (server response) | <800ms |
+| **Resource Load Delay** | Time from TTFB to resource request start | Minimize |
+| **Resource Load Time** | Time to download the LCP resource | Depends on size |
+| **Element Render Delay** | Time from resource loaded to rendered | Minimize |
+
+**Total LCP = TTFB + Resource Load Delay + Resource Load Time + Element Render Delay**
+
+Use this breakdown to identify which phase is causing LCP issues.
+
+## Soft Navigations API (Experimental)
+
+**Chrome 139+ Origin Trial (July 2025)**: First step toward measuring CWV in SPAs.
+
+- Addresses the long-standing SPA measurement blind spot
+- Currently experimental, **no ranking impact yet**
+- Detects "soft navigations" (URL changes without full page load)
+- May affect future SPA CWV measurement
+
+**Detection:** Check for SPA frameworks (React, Vue, Angular, Svelte) and warn about current CWV measurement limitations.
+
+## Measurement Sources
+
+### Field Data (Real Users)
+- Chrome User Experience Report (CrUX)
+- PageSpeed Insights (uses CrUX data)
+- Search Console Core Web Vitals report
+
+### Lab Data (Simulated)
+- Lighthouse
+- WebPageTest
+- Chrome DevTools
+
+> Field data is what Google uses for ranking. Lab data is useful for debugging.
+
+## Common Bottlenecks
+
+### LCP (Largest Contentful Paint)
+- Unoptimized hero images (compress, use WebP/AVIF, add preload)
+- Render-blocking CSS/JS (defer, async, critical CSS inlining)
+- Slow server response (TTFB >200ms: use edge CDN, caching)
+- Third-party script blocking (defer analytics, chat widgets)
+- Web font loading delay (use font-display: swap + preload)
+
+### INP (Interaction to Next Paint)
+- Long JavaScript tasks on main thread (break into smaller tasks <50ms)
+- Heavy event handlers (debounce, use requestAnimationFrame)
+- Excessive DOM size (>1,500 elements is concerning)
+- Third-party scripts hijacking main thread
+- Synchronous XHR or localStorage operations
+- Layout thrashing (multiple forced reflows)
+
+### CLS (Cumulative Layout Shift)
+- Images/iframes without width/height dimensions
+- Dynamically injected content above existing content
+- Web fonts causing layout shift (use font-display: swap + preload)
+- Ads/embeds without reserved space
+- Late-loading content pushing down the page
+
+## Optimization Priority
+
+1. **LCP**: Most impactful for perceived performance
+2. **CLS**: Most common issue affecting user experience
+3. **INP**: Matters most for interactive applications
+
+## Tools
+
+```bash
+# PageSpeed Insights API
+curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=URL&key=API_KEY"
+
+# Lighthouse CLI
+npx lighthouse URL --output json --output-path report.json
+```
+
+## Performance Tooling Updates (2025)
+
+- **Lighthouse 13.0** (October 2025): Major audit restructuring with reorganized performance categories and updated scoring weights. Lighthouse is a lab tool (simulated conditions): always cross-reference with CrUX field data for real-world performance.
+- **CrUX Vis** replaced the CrUX Dashboard (November 2025). The old Looker Studio dashboard was deprecated. Use [CrUX Vis](https://cruxvis.withgoogle.com) or the CrUX API directly.
+- **LCP subparts** added to CrUX (February 2025): Time to First Byte (TTFB), resource load delay, resource load time, and element render delay are now available as sub-components of LCP in CrUX data.
+- **Google Search Console 2025 features** (December 2025): AI-powered configuration for automated analysis. Branded vs. non-branded queries filter. Hourly data available in API. Custom chart annotations. Social channels tracking.
+
+> **Mobile-first indexing** is 100% complete as of July 5, 2024. Google now crawls and indexes ALL websites exclusively with the mobile Googlebot user-agent. Ensure your mobile version contains all critical content, structured data, and meta tags.

package/templates/.agent/skills/seo/references/eeat-framework.md

@@ -0,0 +1,214 @@
+# E-E-A-T Evaluation Framework
+## Updated per Google Quality Rater Guidelines: September 11, 2025
+## Plus December 2025 Core Update Implications
+
+## Overview
+
+E-E-A-T = **E**xperience, **E**xpertise, **A**uthoritativeness, **T**rustworthiness
+
+Trustworthiness is the most important factor. It is assessed based on the
+other three signals plus direct trust indicators.
+
+## CRITICAL: December 2025 Core Update
+
+> **E-E-A-T now applies to ALL competitive queries, not just YMYL.**
+
+The December 2025 core update was described as a "watershed moment" that:
+- Extended E-E-A-T evaluation to virtually all competitive queries
+- Made author attribution standards tighter across all categories
+- Penalized anonymous or generic authorship even for non-YMYL content
+- Significantly improved AI content quality detection
+
+**Impact by industry:**
+| Industry | Traffic Drops |
+|----------|--------------|
+| Affiliate sites | 71% average decline |
+| Health/YMYL | 67% average decline |
+| E-commerce | 52% average decline |
+
+**Key takeaway:** Even entertainment and lifestyle content now requires demonstrated expertise. Generic content no longer ranks.
+
+## YMYL (Your Money or Your Life)
+
+Topics requiring **highest** E-E-A-T standards (but E-E-A-T now matters everywhere):
+- Health and safety
+- Financial advice and transactions
+- Legal information
+- News and current events
+- **Elections and civic trust** (added Sept 2025)
+- **Democratic processes** (added Sept 2025)
+- Groups of people (potential for harm)
+
+---
+
+## Experience (Weight: 20%)
+
+First-hand knowledge and personal involvement with the topic.
+
+### Signals to Check
+- [ ] Author has demonstrable first-hand experience with the topic
+- [ ] Content includes original photos, screenshots, or data
+- [ ] Case studies or real-world examples with specific details
+- [ ] Personal process documentation or methodology descriptions
+- [ ] Before/after results or outcome data
+- [ ] Specific anecdotes that couldn't be fabricated
+
+### Scoring
+- **Strong**: Multiple first-hand experience signals, original content
+- **Moderate**: Some personal experience evident
+- **Weak**: Generic information, no personal touch
+- **None**: Clearly AI-generated or scraped content
+
+---
+
+## Expertise (Weight: 25%)
+
+Formal qualifications, training, and demonstrated knowledge.
+
+### Signals to Check
+- [ ] Author credentials relevant to topic (bio, certifications)
+- [ ] Technical accuracy and depth appropriate for audience
+- [ ] Claims supported by evidence or sources
+- [ ] Specialized vocabulary used correctly
+- [ ] Up-to-date with current developments in the field
+- [ ] Byline with author name and credentials visible
+
+### Scoring
+- **Strong**: Verified credentials, deep technical accuracy
+- **Moderate**: Demonstrable knowledge, some credentials
+- **Weak**: Surface-level information, no credentials
+- **None**: Factual errors, misinformation
+
+---
+
+## Authoritativeness (Weight: 25%)
+
+Recognition by others as a go-to source.
+
+### Signals to Check
+- [ ] Site recognized as authority in its niche
+- [ ] Author recognized as expert (external citations, speaking, publications)
+- [ ] Content cited by other authoritative sources
+- [ ] Industry awards, certifications, or accreditations
+- [ ] Consistent publication history in the topic area
+- [ ] Featured in reputable media outlets
+- [ ] Professional affiliations
+
+### Scoring
+- **Strong**: Widely recognized authority, cited by others
+- **Moderate**: Growing recognition, some external validation
+- **Weak**: No external recognition
+- **None**: Negative reputation, known for misinformation
+
+---
+
+## Trustworthiness (Weight: 30%)
+
+The most important factor, overall reliability and transparency.
+
+### Signals to Check
+- [ ] Clear contact information (physical address, phone, email)
+- [ ] Privacy policy and terms of service
+- [ ] HTTPS with valid certificate
+- [ ] Transparent about who creates content and why
+- [ ] Customer reviews and testimonials
+- [ ] Corrections and update history visible
+- [ ] No deceptive practices (hidden ads, clickbait)
+- [ ] Secure payment processing (for e-commerce)
+- [ ] Return/refund policy visible
+
+### Scoring
+- **Strong**: Full transparency, verified business, positive reputation
+- **Moderate**: Good trust signals, minor gaps
+- **Weak**: Missing key trust signals
+- **None**: Deceptive practices, scam indicators
+
+---
+
+## September 2025 QRG Updates
+
+### AI Content Assessment
+Raters now formally evaluate whether content appears AI-generated:
+- AI content is **acceptable** if it demonstrates genuine E-E-A-T
+- Low-quality AI content (generic, no unique value) is penalized
+- The presence of AI-generated content is not inherently penalizing
+- What matters: does the content provide unique value regardless of creation method?
+
+### Markers of Low-Quality AI Content
+- Generic phrasing without specificity
+- Lack of original insight or unique perspective
+- No first-hand experience signals
+- Factual inaccuracies
+- Repetitive structure across multiple pages
+- No author attribution or expertise signals
+
+### New Spam Categories
+- **Expired domain abuse**: Buying expired domains for their backlinks
+- **Site reputation abuse**: Using reputable site to host low-quality content
+- **Scaled content abuse**: Mass-producing content without value
+
+### AI Overview Evaluation
+Raters assess quality of AI-generated summaries in search results.
+
+### RSL 1.0 (Really Simple Licensing)
+New machine-readable content licensing standard (December 2025) for AI training:
+- Backed by: Reddit, Yahoo, Medium, Quora, Cloudflare, Akamai, Creative Commons
+- Allows publishers to specify AI licensing terms
+- Augments robots.txt for AI-specific permissions
+
+---
+
+## Experience Signals Are Critical Differentiators
+
+The December 2025 update elevated the "Experience" dimension as a key differentiator:
+- First-person narrative ("I tested this...", "In my experience...")
+- Original photos and screenshots (not stock images)
+- Specific examples with verifiable details
+- Process documentation showing actual work done
+
+**Why:** AI can generate expertise-sounding content but cannot fabricate genuine experience.
+
+---
+
+## Overall Scoring Guide
+
+| Score | Description |
+|-------|-------------|
+| 90-100 | Exceptional E-E-A-T, authority site, recognized expert, full transparency |
+| 70-89 | Strong E-E-A-T, demonstrated expertise, good trust signals |
+| 50-69 | Moderate E-E-A-T, some signals, room for improvement |
+| 30-49 | Weak E-E-A-T, minimal signals, significant gaps |
+| 0-29 | Very low E-E-A-T, no visible signals, potential trust issues |
+
+---
+
+## Improvement Recommendations by Score
+
+### 0-29 (Critical)
+1. Add contact information and about page
+2. Establish author identity with credentials
+3. Implement HTTPS
+4. Remove deceptive elements
+
+### 30-49 (Major)
+1. Add author bios with credentials
+2. Include first-hand experience content
+3. Get external citations/mentions
+4. Add customer testimonials
+
+### 50-69 (Moderate)
+1. Deepen content with original research
+2. Build topical authority through content clusters
+3. Pursue industry recognition
+4. Document processes and methodologies
+
+### 70-89 (Minor)
+1. Maintain freshness with regular updates
+2. Expand author presence across platforms
+3. Pursue speaking/publication opportunities
+4. Add video/multimedia demonstrating expertise
+
+### 90-100 (Maintenance)
+1. Continue publishing high-quality content
+2. Monitor and respond to reputation issues
+3. Keep credentials and certifications current

package/templates/.agent/skills/seo/references/quality-gates.md

@@ -0,0 +1,155 @@
+# Content Quality Gates
+
+## Minimum Word Counts by Page Type
+
+| Page Type | Min Words | Unique Content % | Notes |
+|-----------|-----------|-----------------|-------|
+| Homepage | 500 | 100% | Must clearly communicate value proposition |
+| Service / Feature Page | 800 | 100% | Detailed explanation of offering |
+| Location (Primary) | 600 | 60%+ | City headquarters or main service area |
+| Location (Secondary) | 500 | 40%+ | Satellite locations |
+| Blog Post | 1,500 | 100% | In-depth, valuable content |
+| Product Page | 400 | 80%+ | Unique descriptions, specs |
+| Category Page | 400 | 100% | Unique intro, not just product listings |
+| About Page | 400 | 100% | Company story, team, values |
+| Landing Page | 600 | 100% | Focused conversion content |
+| FAQ Page | 800 | 100% | Comprehensive Q&A |
+
+---
+
+## Location Page Thresholds
+
+### Warning Level (30+ pages)
+- ⚠️ **WARNING** at 30+ location pages
+- Enforce 60%+ unique content per page
+- Content must include:
+  - Unique local information (landmarks, neighborhoods)
+  - Location-specific services or offerings
+  - Local team or staff information
+  - Genuine customer testimonials from that area
+
+### Hard Stop (50+ pages)
+- 🛑 **HARD STOP** at 50+ location pages
+- Require explicit user justification
+- Must demonstrate:
+  - Legitimate business presence in each location
+  - Unique content strategy for each page
+  - Local signals (Google Business Profile, local reviews)
+
+### Why This Matters
+Google's doorway page algorithm penalizes programmatic location pages with thin/duplicate content. Signs of doorway pages:
+- Only city/state name changed between pages
+- No unique local information
+- No local business signals
+- Keyword-stuffed URLs
+
+---
+
+## Safe vs. Risky Programmatic Pages
+
+### Safe at Scale ✅
+| Page Type | Why It's Safe |
+|-----------|---------------|
+| Integration pages | Real setup documentation, unique technical content |
+| Template/tool pages | Downloadable assets, unique functionality |
+| Glossary pages | 200+ word unique definitions |
+| Product pages | Unique specs, images, reviews |
+| User profile pages | User-generated unique content |
+
+### Penalty Risk ❌
+| Page Type | Why It's Risky |
+|-----------|----------------|
+| Location pages with only city swapped | Duplicate content, doorway pages |
+| "Best [tool] for [industry]" | Often thin, no industry-specific value |
+| "[Competitor] alternative" | Requires genuine comparison data |
+| AI-generated mass content | No unique value, E-E-A-T failure |
+
+---
+
+## Title Tag Requirements
+
+| Aspect | Requirement |
+|--------|-------------|
+| Minimum length | 30 characters |
+| Maximum length | 60 characters (Google truncates ~60) |
+| Primary keyword | Near the beginning |
+| Brand name | At end (if included) |
+| Uniqueness | Each page must have unique title |
+
+### Good Examples
+- "Emergency Plumbing Services in Austin | ABC Plumbing"
+- "How to Fix a Leaky Faucet: Step-by-Step Guide"
+- "Enterprise SEO Software | Comprehensive Platform"
+
+### Bad Examples
+- "Home" (too short, not descriptive)
+- "Best Plumbing Services for All Your Plumbing Needs in Austin Texas and Surrounding Areas" (too long)
+- "ABC Plumbing - Plumbing - Plumber - Plumbing Services" (keyword stuffing)
+
+---
+
+## Meta Description Requirements
+
+| Aspect | Requirement |
+|--------|-------------|
+| Minimum length | 120 characters |
+| Maximum length | 160 characters (Google truncates ~155-160) |
+| Call-to-action | Include compelling CTA |
+| Primary keyword | Include naturally |
+| Uniqueness | Each page must have unique description |
+
+---
+
+## Image Alt Text Requirements
+
+| Aspect | Requirement |
+|--------|-------------|
+| Required on | All non-decorative images |
+| Length | 10-125 characters |
+| Content | Describe the image content, not "image" or filename |
+| Keywords | Include naturally where relevant |
+| Decorative images | Use `alt=""` or `role="presentation"` |
+
+### Good Examples
+- "Professional plumber repairing kitchen sink faucet"
+- "Red 2024 Toyota Camry sedan front view"
+- "Team meeting in modern office conference room"
+
+### Bad Examples
+- "image.jpg" (filename, not description)
+- "plumber plumbing plumber services" (keyword stuffing)
+- "Click here" (not descriptive)
+
+---
+
+## Internal Linking Guidelines
+
+| Page Type | Internal Links Target |
+|-----------|----------------------|
+| Blog post (1,500+ words) | 5-10 internal links |
+| Service page | 3-5 internal links |
+| Category page | Links to all child pages |
+| Product page | 2-4 internal links |
+
+### Anchor Text Rules
+- Use descriptive anchor text (not "click here")
+- Vary anchor text (don't always use exact match keywords)
+- Link to relevant, related content
+- Ensure no orphan pages (every page linked from at least one other page)
+
+---
+
+## Content Freshness Signals
+
+| Content Type | Update Frequency |
+|--------------|------------------|
+| News/current events | Within hours/days |
+| Blog posts (evergreen) | Review annually |
+| Product pages | When specs change |
+| Service pages | Review quarterly |
+| Company info | When changes occur |
+
+### Required Elements
+- Publication date visible (for articles/blogs)
+- Last updated date (if significantly revised)
+- Changelog for major updates (optional but good)