AI · claude-opus-4-7radosukalaMonday, April 27 at 07:32 PM UTC90cdb82Our-One/our-one

P.9: Comparisons Draft-with-Opus drafter

+495 / −87 files

AI reasoning

The launch plan named this as the highest-ROI polish item because every Elephant Comparison Track A drafts saves ~30+ minutes of prose work. With five Elephants targeted in the content sprint, the math is ~2.5 hours saved against ~2 hours to build — net positive even on the first sprint. After Track A's first wave, the velocity compounds: the operator can draft 5+ Comparisons per hour with citations as the only manual work.

Citations stay manual because the publish validator's cited-quote discipline is what makes Comparisons defensible against legal challenge from incumbents. Opus cannot verify a quote is verbatim against a live URL — that's a real-world action only the operator can take. Drafting the four prose sections with Claude is fine; sourcing the quotes is not.

The slug-collision fallback (date suffix → timestamp suffix) handles the case where Opus picks a slug that already exists, e.g. when re-drafting the same Feature×Incumbent pair after a retraction.

Notes

5–10× content velocity for the Track A Elephant sprint. Operator picks a Feature + an incumbent + optional emphasis; Claude (claude-opus-4-7) drafts the four prose sections (summary, how-they-do-it, how-we-do-it, why-this-matters); the draft saves to status=draft with empty citations; operator lands on the edit page, adds verbatim citations, and publishes.

src/shared/comparisons/opus-drafter.ts: Opus call structured around the existing AI-Notes pattern (caching system prompt, structured tool-use response). System prompt embeds the eleven Constitution commitments in full, names the editorial principles (cited contrast, no emotional escalation, paraphrase the incumbent's actual position, constitutional anchor in our-way prose, concrete-not-abstract, why-different is load-bearing). Tool schema returns slug + title + the four prose sections. Citations are explicitly out of scope — operator verifies verbatim quotes against live URLs at publish.

src/shared/comparisons/actions.ts: new draftComparisonWithOpusAction server action. Looks up the Feature + incumbent + their constitutional ties; calls the Opus drafter; inserts a Comparison row in status=draft with the four redacted prose sections and empty citations[]; auto-resolves slug collisions (date suffix, then timestamp suffix); links the Feature via featureComparisons; redirects to the edit page with ?opusDrafted=1 banner.

Admin route /hall/admin/comparisons/draft-with-opus: form with Feature dropdown + incumbent dropdown + optional emphasis textarea. Lands at ~10–20 seconds post-submit.

Cross-links added:

/hall/admin/comparisons list page: side-by-side "Draft with Opus" + "New Comparison" buttons.
/hall/admin/comparisons/new: cross-link prose at the top pointing to the Opus drafter as the faster path.
/hall/admin/layout.tsx: nav entry "Draft w/ Opus" between New comparison and Questions.
/hall/admin/comparisons/[id]/edit: opusDrafted=1 query param renders a banner reminding the operator to add citations before publish.

Before · After

Click to zoom. Esc or click-outside to close.

After

Before

No prior shot available — first appearance of this route, or the previous deploy was past Vercel’s retention window.

Files changed

Msrc/app/hall/admin/comparisons/[id]/edit/page.tsx+9 / −0
Asrc/app/hall/admin/comparisons/draft-with-opus/page.tsx+125 / −0
Msrc/app/hall/admin/comparisons/new/page.tsx+10 / −0
Msrc/app/hall/admin/comparisons/page.tsx+15 / −7
Msrc/app/hall/admin/layout.tsx+1 / −0
Msrc/shared/comparisons/actions.ts+109 / −1
Asrc/shared/comparisons/opus-drafter.ts+226 / −0

Diff

Lines reveal in sequence as you scroll. First 20 lines per file shown — expand for the rest.

modifiedsrc/app/hall/admin/comparisons/[id]/edit/page.tsx+9 / −0tsx

	@@ -23,6 +23,7 @@ interface Props {
	aiNotePublished?: string;
	aiNoteDiscarded?: string;
	operatorResponseSaved?: string;
+	opusDrafted?: string;
	}>;
	}

	@@ -38,6 +39,7 @@ export default async function EditComparisonPage({ params, searchParams }: Props
	aiNotePublished,
	aiNoteDiscarded,
	operatorResponseSaved,
+	opusDrafted,
	} = await searchParams;

	const db = getDb();
	@@ -106,6 +108,13 @@ export default async function EditComparisonPage({ params, searchParams }: Props
	Operator response saved.
	</p>
	)}

new filesrc/app/hall/admin/comparisons/draft-with-opus/page.tsx+125 / −0tsx

	@@ -0,0 +1,125 @@
+	import Link from "next/link";
+	import { getDb } from "@/shared/db/client";
+	import { incumbents } from "@/shared/db/schema/incumbents";
+	import { listFeatures } from "@/shared/features/queries";
+	import { draftComparisonWithOpusAction } from "@/shared/comparisons/actions";
+
+	export const metadata = { title: "Draft a Comparison with Opus" };
+	export const dynamic = "force-dynamic";
+
+	export default async function DraftWithOpusPage() {
+	const db = getDb();
+	const [incumbentRows, featureRows] = await Promise.all([
+	db.select().from(incumbents).orderBy(incumbents.displayName),
+	listFeatures({ limit: 500 }).catch(() => []),
+	]);
+
+	return (
+	<div className="px-6 py-12 md:py-16">
+	<div className="mx-auto max-w-[44rem]">

modifiedsrc/app/hall/admin/comparisons/new/page.tsx+10 / −0tsx

	@@ -33,6 +33,16 @@ export default async function NewComparisonPage() {
	citations are in place — the publish action validates that ≥2
	citations have non-empty quotes.
	</p>
+	<p className="mt-3 font-sans text-xs text-stone-500">
+	Faster path:{" "}
+	<Link
+	href="/hall/admin/comparisons/draft-with-opus"
+	className="font-medium text-stone-900 underline decoration-stone-300 underline-offset-4 hover:decoration-stone-900"
+	>
+	draft the four prose sections with Opus
+	</Link>
+	{" "}— Claude returns a typed draft in ~10–20 sec, you add citations and edit.
+	</p>

	{incumbentRows.length === 0 ? (
	<div className="mt-8 rounded-xl border border-amber-200 bg-amber-50 px-6 py-5">

modifiedsrc/app/hall/admin/comparisons/page.tsx+15 / −7tsx

	@@ -37,16 +37,24 @@ export default async function AdminComparisonsIndexPage() {
	return (
	<div className="px-6 py-12 md:py-16">
	<div className="mx-auto max-w-[64rem]">
−	<div className="flex items-baseline justify-between">
+	<div className="flex flex-wrap items-baseline justify-between gap-3">
	<h1 className="font-serif text-3xl font-bold tracking-tight text-stone-900 md:text-4xl">
	Comparisons
	</h1>
−	<Link
−	href="/hall/admin/comparisons/new"
−	className="rounded-md bg-stone-900 px-4 py-2 font-sans text-sm font-medium text-[#FDFBF7] hover:bg-stone-700"
−	>
−	New Comparison →
−	</Link>
+	<div className="flex items-center gap-2">
+	<Link
+	href="/hall/admin/comparisons/draft-with-opus"
+	className="rounded-md border border-stone-900 bg-white px-4 py-2 font-sans text-sm font-medium text-stone-900 hover:bg-stone-100"
+	>

modifiedsrc/app/hall/admin/layout.tsx+1 / −0tsx

	@@ -32,6 +32,7 @@ export default async function AdminLayout({
	<span className="text-stone-300">·</span>
	<Link href="/hall/admin/comparisons" className="text-stone-700 hover:text-stone-900">Comparisons</Link>
	<Link href="/hall/admin/comparisons/new" className="text-stone-700 hover:text-stone-900">New comparison</Link>
+	<Link href="/hall/admin/comparisons/draft-with-opus" className="text-stone-700 hover:text-stone-900">Draft w/ Opus</Link>
	<span className="text-stone-300">·</span>
	<Link href="/hall/admin/questions" className="text-stone-700 hover:text-stone-900">Questions</Link>
	<Link href="/hall/admin/questions/new" className="text-stone-700 hover:text-stone-900">New question</Link>

modifiedsrc/shared/comparisons/actions.ts+109 / −1typescript

	@@ -29,7 +29,11 @@ import {
	findComparisonBySlug,
	listFeaturesForComparison,
	} from "./queries";
−	import { findFeatureBySlug } from "@/shared/features/queries";
+	import {
+	findFeatureBySlug,
+	listCommitmentTiesForFeature,
+	} from "@/shared/features/queries";
+	import { draftComparisonWithOpus } from "./opus-drafter";

	const SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
	const URL_RE = /^https?:\/\//i;
	@@ -447,6 +451,110 @@ export async function createMemberDraftComparisonAction(
	redirect(`/features/${primaryFeatureSlug}?draftSubmitted=1`);
	}

+	/**
+	* Operator-triggered Opus draft. Inserts a Comparison row in status=draft
+	* with the four prose sections filled in by Claude and citations left

new filesrc/shared/comparisons/opus-drafter.ts+226 / −0typescript

	@@ -0,0 +1,226 @@
+	import Anthropic from "@anthropic-ai/sdk";
+	import { COMMITMENTS } from "@/shared/constitution";
+
+	const MODEL = "claude-opus-4-7";
+	const MAX_TOKENS = 3000;
+
+	const SYSTEM_PROMPT = `You are drafting a Comparison for Our.one — a public, cited contrast against a named incumbent.
+
+	Our.one is a parent company for user-community-owned products in the AI age. Its Constitution names eleven commitments that bind the company. The Comparisons system is how Our.one publicly contrasts itself with named incumbents (TikTok, Instagram, LinkedIn, Discord, etc.). Each Comparison has four prose sections (summaryMd, competitorBehaviorMd, ourBehaviorMd, whyDifferentMd) plus citations and a slug.
+
+	You draft the four prose sections. The operator adds citations and edits before publishing. The publish validator demands ≥2 cited verbatim quotes from the incumbent's own sources before the Comparison can go public — citations are explicitly NOT your job, because they require verifying quotes against live URLs at the moment of publish.
+
+	The eleven Constitution commitments:
+	${COMMITMENTS.map((c) => `${c.n}. ${c.text}`).join("\n")}
+
+	Editorial principles you must follow:
+
+	1. Cited contrast, never emotional escalation. "TikTok engineers the For-You feed for watch time" is sourced. "TikTok is destroying your kids' brains" is outrage-bait — reject the latter framing.
+	2. Paraphrase the incumbent's actual position. The "their way" section should read as something the incumbent's own engineering team might describe. If the only honest read is mild, say so — the operator picks a different Elephant if the contrast is weak.