> For the complete documentation index, see [llms.txt](https://suigar.gitbook.io/suigar-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://suigar.gitbook.io/suigar-docs/seo/channels.md). # SEO channels Last reviewed: 2026-05-28 This file defines the full SEO channel model. Use it to decide what a change affects and what a mature implementation should eventually automate. ## Maturity Levels | Level | Name | Meaning | | ----: | -------------- | ----------------------------------------------------------------------------------------------- | | 0 | Unknown | No owner, no inventory, no evidence. | | 1 | Manual | Basic rules exist, but checks are ad hoc and mostly human memory. | | 2 | Documented | Durable guidance exists and the channel has a current inventory or checklist. | | 3 | Enforced | Scripts, typed helpers, CI checks, or templates prevent common regressions. | | 4 | Measured | Field data, Search Console, analytics, or crawl data feed regular decisions. | | 5 | Self-improving | AI or automation proposes updates from measured results, and humans review higher-risk changes. | ## Channel Matrix | Channel | What It Covers | Current Anchor | Ideal State | | ------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | Technical SEO | Rendering, status behavior, static export, JS crawlability, mobile rendering, links, asset access. | `frontend` SEO helpers, `blog-site` Next metadata, project configs. | Automated rendered-page checks for public routes across frontend, blog, and docs. | | Crawl And Indexing | Sitemap, robots, noindex, canonical eligibility, excluded routes, environment blocking. | `frontend/scripts/sitemap-routes.mjs`, `frontend/public/robots.txt`, `blog-site/src/app/sitemap.ts`, `blog-site/src/app/robots.ts`. | Repo-wide indexability inventory with Search Console validation and environment-aware safeguards. | | Canonicals And Duplicates | Preferred URLs, redirects, duplicate route handling, testnet/mainnet separation. | `PageTitle`, `blogSiteUrl`, `SEO_CFG.siteUrl`. | Automated canonical/crawl comparison for production and non-production hosts. | | Metadata | Titles, descriptions, Open Graph, Twitter cards, title suffixes, snippet quality. | `PageTitle`, `SEO_CFG`, `blog-site` metadata functions. | Unique metadata coverage report with title/description length, duplication, and intent checks. | | Structured Data | JSON-LD, schema type selection, visible-content parity, rich-result eligibility. | `frontend/src/utils/seo.ts`. | Validated schemas for frontend and blog with no unsupported claims. | | Content Quality | Search intent, readability, originality, freshness, claim support, user value. | `docs/seo/guidelines.md`, blog DB post fields. | AI-assisted content audits backed by source ledgers and performance data. | | Blog Generation | Topic strategy, briefs, outlines, AI drafting, source ledgers, review gates, publishing loops. | `docs/seo/blog-generation.md`, `blog-site/db/migrations/`. | AI generates and critiques posts from constraints, then feeds performance learning back into rules. | | Internal Links | Hubs, contextual links, crawlable hrefs, docs/blog/product cross-links, anchor text. | Frontend and blog route links. | Link graph report with orphan detection and suggested contextual links. | | Social Previews | Open Graph/Twitter image, alt, preview copy, share surfaces. | `PageTitle`, blog metadata. | Page-specific preview assets and automated card validation. | | Image SEO | Alt text, image compression, stable public URLs, dimensions, generated-image provenance. | Frontend assets plus blog DB asset rows and alt fields. | Asset inventory with alt/provenance/compression checks. | | Core Web Vitals | LCP, INP, CLS, mobile/desktop page experience, field and lab measurement. | Frontend guidance and existing analytics surfaces. | p75 mobile/desktop monitoring by route cohort with regression alerts. | | Analytics And Measurement | Search Console, GA, click-through, query cohorts, conversions, content refresh signals. | Blog analytics component, app analytics code. | Unified SEO dashboard that turns data into backlog items. | | AI Search And GEO | Entity clarity, answer extraction, AI crawler access, concise source-backed facts, `llms.txt`. | Frontend `llms.txt`, crawler rules, docs/blog content. | Entity map and answer-targeted content QA for Google AI features and external answer engines. | | Off-Site Discovery | Backlinks, social distribution, communities, partner references, docs links, launch channels. | Manual product/social work. | Campaign ledger tying posts/pages to distribution, links, and measured discovery. | ## Required Channel Tags Every meaningful SEO log entry should list one or more tags: * `technical` * `crawl-indexing` * `canonical` * `metadata` * `structured-data` * `content` * `blog-generation` * `internal-links` * `social-preview` * `image-seo` * `core-web-vitals` * `measurement` * `ai-search-geo` * `off-site` ## Promotion Rules * Move a channel from level 1 to 2 only after the rules and current inventory are documented. * Move a channel from level 2 to 3 only after a script, typed abstraction, template, or CI/manual gate catches regressions. * Move a channel from level 3 to 4 only after real performance, crawl, or analytics data is attached to decisions. * Move a channel from level 4 to 5 only after automation proposes improvements from evidence and records human review.