a builder's codex
codex · playbooks · pSEO framework playbook

pSEO framework playbook

Annotated framework · build loop + five rules

pSEO Without Getting Nuked

01

Set the non-negotiables

Mandatory human edit per page. 500+ unique words. 30%+ embedding differentiation between pages from the same template. Monthly pruning below impression threshold.

02

Design the template structure

Per directory: template.md with {variable} placeholders, variables.csv, differentiation-rubric.md, review-checklist.md. The template is the unit of quality, not the page.

03

Human-approve the template, not each page

One approval unlocks batch generation. Hybrid sites with review-gated templates recovered from the March 2024 HCU within hours. Pure auto-publish sites lost 95–98% of traffic.

04

Run the build loop

Generate → differentiation audit (embedding distance) → human-value audit → sample review (1 in 10) → final brand-voice check at template level.

05

Monitor and prune weekly

Search Console impressions + positions per template. Any pSEO page below threshold after 90 days: noindex or delete. Pruning is not optional maintenance. It is how you keep the healthy pages ranking.

AEO integration: stand-alone passages + schema on every pSEO page →

Programmatic SEO without getting nuked in the next Helpful Content update. The March 2024 Google update took out 95–98% of traffic for zero-oversight pSEO sites; hybrid sites with review-gated templates recovered within hours. The differentiator is human-in-the-loop, not scale.

Source synthesis: post-HCU forensics, Lily Ray on AI Overview substrate (A single seeded fake claim can self-confirm in AI Overviews), the citation/mention gap (Citation rate and mention rate are different metrics; comparative content closes the gap).

Non-negotiable rule set

  1. Mandatory human edit pass per generated page. No auto-publish.
  2. ≥500 unique words per page that are not template boilerplate.
  3. ≥30% differentiation between any two pages from the same template (measured on paragraph-level embedding distance).
  4. Monthly pruning. Any pSEO page below N impressions after 90 days is noindexed or deleted.
  5. Weekly signal monitoring. Search Console impressions + positions trend per template.

Template structure

Each template lives in a directory with:

Build loop

template builder agent
  ↓ assemble variables + template + examples
  ↓ generate candidate page
  ↓ differentiation audit (embedding distance)
  ↓ human-value audit (does this answer a real question?)
template-publish gate (human approves the TEMPLATE, not each page)
  ↓ template unlocked for batch generation
seo writer → page instances with mandatory copy-reviewer pre-check
  ↓ sample review (1 in 10)
  ↓ final brand-voice check at template level
publish via LP builder or content-publish flow

Safety gates

Common failure modes

Quality gates

What this connects to

Open the interactive view →