Audit rules overview
smartspec is organized as a set of modules, each focused on one technical SEO concern. Every module emits zero or more findings. Each finding has a severity and a rule ID.
Severities
| Severity | What it means | CI behavior |
|---|---|---|
| critical | The site is broken in a way that blocks Google indexing or breaks mobile rendering. | Fail the build. |
| warning | Something is degraded — fix when you can. | Surface but don't fail. |
| info | Observation — useful context, never blocking. | Ignore unless explicitly asked. |
Categories
Each category maps to one source module under src/audit/modules/. Click into
any category for the rule IDs that ship today.
| Category | Module | Page |
|---|---|---|
| Page metadata | page.ts | On-page |
| Content quality | content-quality.ts | On-page |
| Schema (JSON-LD) | schema.ts | Schema & social |
| Open Graph / Twitter | social.ts | Schema & social |
| Crawl & robots | robots.ts | Crawl & indexing |
| Sitemap | sitemap.ts | Crawl & indexing |
| Redirects | redirects.ts | Crawl & indexing |
| hreflang | hreflang.ts | Crawl & indexing |
| Performance / CWV | performance.ts | Performance |
| Mobile | mobile.ts | Mobile |
| Accessibility (a11y) | a11y.ts | Accessibility |
| Internal & external links | links.ts | Links |
| Images | images.ts | Images |
| Security headers | security.ts | Security |
| Analytics | analytics.ts | Analytics |
| AI crawlers / llms.txt | llms.ts | AI crawlers |
Run only some categories
smartspec audit https://example.com --categories schema,mobile,security
See also
- Vibecoder rules — the 10 rules tuned for AI-builder failure modes.