Claude and I have written two pieces before this one. One was about the WP Retirement Plan itself — why the platform is retiring, not dying, and what replaces it. The other two are the actual engines: how agency-directed content leads SEO/GEO — the architecture side, categories and answer-first structure and schema — and how client-directed content drives engagement — the voice side, the owner’s own frame of reference, the thing no agency can manufacture on their behalf.
Both of those arguments are true and neither is sufficient alone. Architecture without the owner’s voice reads like every other AI-drafted blog on the internet — correct, cited, forgettable. Voice without architecture is honest and warm and never gets found, because nothing about it tells a search or answer engine what it’s for or where it belongs.
This piece isn’t a third argument. It’s the join. Below is what actually sits between those two engines — a brief template, a required-elements checklist, a linked-card pattern, and a prompt — the exact mechanics Claude and I run so the two sides occupy the same article without one quietly overwriting the other.
The skeleton-and-fill model
Here’s the mental model, stated once, plainly: the agency pours a skeleton before a word of prose exists — category, target page, target keyword, an answer-first opening, FAQ and schema slots, a linked-card placement. That skeleton is non-negotiable structure. Then the client’s actual material — a review, a job story, a seasonal note, a plain-language correction — drops into named slots inside that skeleton, without the owner ever needing to touch the structural parts.
That’s the whole trick, and it’s smaller than it sounds. Client input flowing in fast, at low friction, is what the engagement side of this needs. GEO discipline holding regardless of who supplied the words is what the architecture side needs. Neither one survives contact with the other unless there’s a defined seam where they meet — otherwise the agency’s structure gets diluted by loose owner text, or the owner’s real material gets flattened into generic template copy. The seam is the templates that follow.
Template 1 — the AI-facing article brief
Every article, on any site the Agency AI Operating System runs, starts as this frontmatter block before a single sentence gets drafted. It’s adapted directly from our own article template, generalized so it works for any client site:
---
title: "" # benefit-or-curiosity, becomes the H1
slug: ""
category: "" # one of the site's 4–7 canonical categories
tags: [] # 2–5 fine-grained, reusable
target_page: "" # the ONE money page this article is obligated to lift
target_keyword: "" # primary anchor phrase used in the in-body link
content_type: guide|playbook|case|field-notes|opinion|seasonal
client_input_needed: [] # what the owner needs to supply — review? photo? confirm a fact?
internal_links:
- text: ""
href: ""
hero_image: "" # filename once generated; empty = TODO
image_kind: illustration|mascot|real-photo # NEVER ai-people
status: draft
editorial_notes: "" # copy-safety: what's verified, what must never be fabricated
---
Most of those fields are ordinary content-ops housekeeping. One isn’t, and it’s the field that makes this a synthesis template instead of just an SEO template: client_input_needed. That’s the explicit seam — the place where the owner’s real material gets requested before drafting starts, so nobody, human or AI, is guessing at a detail or quietly inventing one to fill a gap. If the field is empty, the article doesn’t need the client’s voice for this particular piece. If it names something — “a recent job story,” “confirm current pricing,” “a photo of the new equipment” — drafting doesn’t start until that’s answered.
Template 2 — the required-elements checklist
This is a literal gate, not a style suggestion. Nothing publishes, regardless of whether Gemma, Sonnet, or the owner drafted it, until every box is checked:
- Hero image generated, on-disk, brand formula followed (real photos for trust/people — never AI people)
- At least one real blockquote (verbatim review, real quote, or sourced stat — never fabricated)
- At least one bulleted or numbered list
- FAQ block, 3–5 Q&As, question-as-heading, direct-answer-first-sentence, plus FAQPage JSON-LD
- 1–2 in-body links to the target money page, natural anchor text, real relative paths only
- A service or Agency-OS linked-card rendered in-article, not just a text link
- Brand signoff present
- Closing CTA to the brand’s conversion page
Same eight boxes on a dental-practice field note, a carpet-cleaner’s seasonal post, and this article you’re reading right now. The checklist doesn’t care about voice or subject matter — it cares whether the piece is structurally complete. That separation is what lets the two engines run in parallel without either one needing to police the other’s job.
Template 3 — the linked-card pattern
Every article demonstrates exactly one capability, and renders that capability’s card in-article — not a generic “contact us” footer, but a specific card the article just proved out in practice. How agency-directed content leads SEO/GEO earns the Copywriting & Content card. How client-directed content drives engagement earns the Client Dashboards & Tools card. The pattern, stated generically — ours renders as an Astro component, another stack would implement the same idea differently:
<LinkedCard
title="[Capability name, e.g. Copywriting & Content]"
href="/agency-ai-operating-system/#[card-anchor]"
blurb="[one sentence — what this capability does, in the reader's terms]"
/>
This article is the rare exception that earns two cards instead of one, because it’s the synthesis of both engines rather than a demonstration of either alone — you’ll see both rendered at the close.
Template 4 — the plain-language-to-copy prompt
This formalizes the actual mechanic behind client-directed engagement: how an owner’s own words, given in plain language, become a properly structured edit to a live page without losing what made them worth including in the first place.
You are revising [site]'s [article/page] to reflect a real update the
owner just gave you. Match the site's existing voice and structure exactly.
Owner's input (verbatim, plain language):
"[owner's own words — do not paraphrase away specifics]"
Rules:
- Do not invent any fact, price, name, or anecdote not present in the
owner's input above.
- Keep the existing category, target_page, and target_keyword unchanged
unless the owner's input explicitly changes what the page is about.
- If the owner's input is a review or quote, reproduce it verbatim in a
blockquote — do not smooth or rephrase it.
- Flag anything ambiguous as <!-- CONFIRM WITH CLIENT --> rather than
guessing.
Output: the revised section only, in the site's existing markdown structure.
Running this as an actual prompt, rather than describing it as a philosophy, is the difference between an agency saying “we listen to our clients” and an agency that can show you the exact instruction set that stops an AI editor from inventing a detail the owner never said. The rule that matters most in there is the smallest one: flag ambiguity, don’t guess. Guessing is where fabricated client specifics come from, and it’s the one failure mode this whole system exists to prevent.
Nearly half the WordPress blogs Claude and I scanned this year — roughly 1,800 U.S. small-business sites — hadn’t posted anything in over twelve months, median gap about 11.5 months. The tooling to publish was never the bottleneck. Knowing what to say, in whose voice, on what schedule — that was.
That’s the same scan behind the WP Retirement Plan piece, and it’s the reason these four templates exist at all. An owner who can technically log in and edit a page still needs someone to hand them a structure to pour their words into — otherwise the page sits untouched for eleven months, same as it did on WordPress.
A walkthrough, start to finish
Worth being direct about what this section is: a hypothetical run-through, not a real client’s article, no name attached, no invented-but-specific metric standing in for one. It exists to show the four templates running back-to-back, in order.
- Brief filled out. Category and target page assigned.
client_input_needednames one thing: a recent job story from the owner, in their own words. - Owner asked, once, specifically. Not “send us content” — a single named ask, captured through a feedback widget or a short plain-language note, not a blank page.
- The prompt runs. The owner’s actual words go through Template 4, verbatim where they matter, flagged rather than guessed wherever they’re ambiguous.
- The draft gets written answer-first, around the owner’s real material, inside the skeleton the brief already defined — category, target page, target keyword untouched.
- The checklist runs. All eight boxes, no exceptions for “it’s mostly done.”
- The linked-card renders, pointing at the one capability this particular article actually demonstrated.
- It publishes.
Nothing in that sequence is a new idea. It’s the architecture argument and the engagement argument, executed back-to-back through the same four templates — which is the entire claim of this piece.
What this actually is
Named plainly, with no hype attached: this four-template system — brief, checklist, linked-card, prompt — is a compressed version of the Agency AI Operating System itself. The same mechanics run across every site under it, at whatever scale that site needs, whether it’s publishing weekly or once a quarter. It isn’t a special process reserved for this article. It’s the process, visible for once instead of running quietly in the background.
FAQ
Do agency structure and client voice actually conflict?
Only when there’s no defined seam between them. Built with named slots — a category and answer-first shell on one side, a client_input_needed field and a listening mechanism on the other — they don’t compete, they compound.
What’s the actual template for briefing an article?
A frontmatter block with category, target page, target keyword, content type, and a client_input_needed field naming exactly what the owner needs to supply before drafting starts. The full template is inline above, in Template 1.
Is there a checklist before something gets published? Yes — eight required elements, checked every time regardless of who drafted it: hero image, a real blockquote, a list, an FAQ with schema, one to two links to the money page, a rendered linked-card, the brand signoff, and a closing CTA.
How does an owner’s plain-English note become a properly structured page edit? Through the prompt in Template 4 — it locks in the site’s existing voice and structure, forbids inventing any fact not in the owner’s own words, and flags anything ambiguous for confirmation instead of guessing at it.
Is this specific to one client’s website? No. It’s the same four templates regardless of the site — only the category names, the target pages, and the owner’s actual input change from one client to the next.
Both engines earn a card here, because this piece is where they meet rather than where either one runs alone.
Copywriting & Content — the architecture side: categories mapped to money pages, answer-first structure, FAQ and schema built in from the brief, not bolted on after. See it at the Copywriting & Content card.
Client Dashboards & Tools — the engagement side: the feedback widget, the plain-language prompt, the seam where an owner’s real words reach the page without an agency guessing on their behalf. See it at the Client Dashboards & Tools card.
If you want to see both of those running as one system rather than two capabilities on a page, that’s the whole point of the Agency AI Operating System.
🔧 Build Log Drafted direct from brief by Claude Sonnet 5 · reviewed against CM voice guardrails in the same session · ~2,050 words / ~2,900 tokens output · Est. elapsed 6m · Est. agency equivalent: $450–650

