tebra-content-os

Research a query cluster and produce a validated Brief JSON with Asana task

Write a compliant draft markdown file from a brief JSON using Opus 4.7

Score a URL against the extractability rubric using the citation-auditor subagent

Audit a live URL for content drift and append refresh recommendations to the draft

Generate weekly citation performance report across all Tebra content assets

Produces a structured content brief from a query cluster string. Queries Firecrawl for competitor SERP content and Exa for LLM-consensus answers, then synthesizes a Brief JSON validated against schemas.py. Writes briefs/<slug>.json. Invoke via /brief <query>.

Writes a compliant draft markdown file from a brief JSON. Uses Opus 4.7 for high-quality content generation. Handles compliance hook deny decisions by revising flagged claims and retrying (max 3 attempts). Returns partial_success after 3 denials so the operator can intervene. Invoke via /draft <brief-slug>.

Scores a web page against the extractability rubric. Given a URL, fetches and renders the page via Chrome DevTools MCP, extracts structured signals (JSON-LD schema types, header hierarchy, Q&A pair count, citation/reference link count, answer-first structure), scores each dimension 0–5 using scripts/citation_score.py, writes a JSONL entry to audit/citation-scores.jsonl, and returns a SubagentResponse with a markdown report in summary_for_user. Invoke via /audit <url> or when the main agent needs an extractability score.

Audits a live URL against its corresponding draft to identify content that has drifted or become stale. Fetches the live page via Chrome DevTools MCP, scrapes competitor updates via Firecrawl, checks LLM consensus shifts via Exa, then appends recommended_changes to the draft frontmatter via scripts/refresh_append.py and logs a refresh event to audit/compliance.jsonl. Invoke via /refresh <url-or-draft-glob>.

Performs a nuanced compliance second-pass on a draft markdown file for hedged medical claims and ambiguous attribution that regex patterns miss. Reads the draft and the source registry, then returns a structured allow/ask/deny decision with line-level evidence. Invoked by draft-writer when the PreToolUse hook escalates or when the draft contains hedged language ("results may vary", "some studies show", "may help", "can reduce") that the Python regex layer cannot confidently classify. Returns the same deny/allow/ask contract as scripts/compliance_check.py.

Fetches authoritative product documentation from Google Drive to ground implementation_guide drafts in verified procedural truth. Only invoked by draft-writer when brief.asset_type == "implementation_guide". Reads the brief, fetches relevant Google Drive docs, and returns verified procedural steps with Citations API block-index grounding. Every step output carries a source reference so draft-writer can embed it in the draft with full traceability.

STATUS: dormant in pre-hire mode. Requires Search Console, GA4, HubSpot, and Slack MCPs to run. Restore path: docs/OPERATING_MODES.md. Generates a weekly citation performance report across all Tebra content assets. Pulls ranking and traffic data from Search Console, GA4, and Peec AI; maps citation mentions to HubSpot deal pipeline; formats the report as a Slack message and a markdown artifact in audit/. Invoked via /citation-report slash command or on a weekly schedule. Returns a SubagentResponse with the Slack message posted and the report artifact path.