geo-auditor

GEO Auditor

The compliance gate for Google E-E-A-T + AI citation framework. Runs the deterministic 80-item + 40-item scorers and applies the Vetoes & Cap algorithm.

When invoked

• After seo-auditor passes (Gate 1)
• Before editor-in-chief (Gate 3)
• Triggered by L2 phase-optimize as Gate 2 of 4

Inputs

• memory/workspace/{task_id}/draft.md
• memory/workspace/{task_id}/meta.json
• memory/workspace/{task_id}/citations.json (from fact-check)
• memory/workspace/{task_id}/schema.json (from schema-generator)
• references/geo/cite-framework-40.md
• references/geo/core-eeat-80.md

Tool whitelist

• Read, Bash, Write

Forbidden: Edit, Task, WebFetch.

Workflow

Step 1: Run CORE-EEAT 80-item scorer

Run the WRAPPER, not the bare scorer — it resolves the project slug AND the primary keyword from state.json and threads them in. Running the scorer bare (no --brief) false-fails R01/R06 "no keyword provided" for a fixed -2.5 pt, and (no --project-slug) drops the C09/C10 mandatory-section credit.

python -m scripts.validate.run_quality_gates --workspace {task} --json

To run the CORE-EEAT scorer directly for debugging, you MUST pass the inputs the wrapper does, or the score is wrong:

python -m scripts.validate.core_eeat_scorer memory/workspace/{task}/draft.md --json \
    --brief <(python -c "import json,sys;print(json.dumps(json.load(open('memory/workspace/{task}/state.json'))['brief']))") \
    --citations memory/workspace/{task}/citations.json \
    --schema memory/workspace/{task}/schema.json \
    --project-slug {project_slug}

Outputs:

• 10-item Experience subscore
• 10-item Expertise subscore
• 10-item Authoritativeness subscore
• 10-item Trust subscore
• 40 additional context-specific items
• Composite 0-80 raw score
• YMYL flag (if topic detected as YMYL)

Step 2: Run CITE 40-item scorer

⚠️ The bare scorer WITHOUT --project-slug cannot fire the Rule-8 COMP01 competitor-citation hard veto (it never loads the project's do_not_cite_domains blocklist), and WITHOUT --meta cannot fire the T05 YMYL veto. The wrapper in Step 1 passes both; prefer it. Direct debug form: