← Back to overview

Socrates Documentation

Outputs

What each draft and update delivers.

Output Formats

Three deliveries: per-draft (the three stages), setup (onboarding), update (after approval). Writes go through Socrates; the paste-ready packets below are the fallback when Socrates is unreachable. Lead with what the requester wants; keep wrappers minimal.

Per-draft delivery (Stages 1–3)

First Draft: the full piece + a one-line feedback prompt. Hold heavy blocks until Optimized.

Optimized Draft: the piece (links inserted), a short changelog (feedback applied + optimisation added + quality score N/70), and:

Title tag: [50–60 chars, primary keyword]
Meta description: [150–160 chars, keyword + CTA]
Primary keyword: [term] · LSI: [list]
Schema: [generated JSON-LD — Article/FAQPage/etc., included in full or attached]
Target AI-prompts addressed: [queries]

plus the internal-link report (anchor → destination), a source list (every cited fact + real URL, with tiers/dates), and a distribution note (off-site repurposing/citation play). Then a one-line sign-off prompt.

Final Draft: the clean piece + all the above, re-verified, + the single approval prompt.

Setup delivery (onboarding)

Default: write everything with socrates_create_client_kb and report what was created (folder + items, with links) plus the crawlability findings and any deferred items. Fallback (no Socrates): one labelled paste-ready block per generated/adopted item:

Save as Google Doc [Client] — Brand Guidelines in the [Client] folder of Flood — Client Content Profiles.

Update delivery (after approval)

Default: write changes via Socrates (append_webmap_rows, log_run, upsert_target_prompts, upsert_kb_doc) and report what was updated in one line each. Fallback (no Socrates): an update packet — only the changed items as paste-ready blocks (for the Webmap, just the new rows), with a Last updated bump and a one-line note each.

Open flags (any delivery)

Surface anything blocking publication: [CLIENT TO CONFIRM: …], missing link sources, thin research, unmet constraints, failed crawlability, or a quality score that needed manual sign-off.