AGENTS

Read this before editing or creating any blog markdown under apps/frontend/content/blog/.

This manifest auto-loads when Claude edits a file under this path. The sibling apps/frontend/app/blogs/AGENTS.md covers route-layer + render gates; this manifest is the content-authoring canon that fires while drafting markdown.

Grey-hat firewall (HARD)

NEVER mention forkoff.xyz, Simba, or FORKOFF in body, frontmatter, embed captions, alt text, or CTAs. redditapis is positioned as a standalone dev tool from the buyer's perspective. Per feedback_redditapis_grey_hat_never_mention.

Hard rules at edit time (block before commit)

Inline images (Outrank floor)

• Spoke: 10+ inline images. Pillar: 12+. Cover does NOT count.
• mediaCaptioned[] frontmatter + body markdown image refs.
• Source: redditapis-blog-infographic skill ONLY. NEVER ad-hoc gpt-image-1 + Pillow PNG.
• NEVER cover_render output as inline. Filenames with -cover./__cover__/cover_render = FAIL Gate P.

Embed triple (Twitter + Reddit + YouTube)

• Every post MUST include >=1 Twitter, >=1 Reddit, >=1 YouTube embed.
• Spoke multi-embed floor: 2 each. Pillar: 3 each.
• Reddit oEmbed primary (no auth needed). Proxy enrichment optional via REDDITAPI_KEY.
• Canon: feedback_blog_gate_7_includes_youtube, feedback_reddit_embed_oembed_primary.

Embed brand-safety (per-tenant allowlist)

• Reddit URLs MUST be from the redditapis allowlist: r/redditdev (primary), r/webdev, r/Python, r/learnpython, r/node, r/learnprogramming, r/datasets, r/datascience, r/MachineLearning, r/LocalLLaMA, r/AI_Agents, r/SaaS (dev-API only), r/webscraping (dev intent only). Anything outside = FAIL.
• Same banned-subs list as forkoff: NSFW, political, drug, weapon, partisan, r/bald, r/Snorkblot.
• Canon: feedback_blog_embed_brand_safety_strict.

FAQ

• Top-level faq: frontmatter array, NEVER body ## FAQ heading.
• Canon: feedback_blog_faq_top_level_field.

Voice + word floor

• Word floor: 4,000-8,500 spoke / 8,500-12,000 pillar.
• Em-dash + en-dash strict zero.
• cheap/cheapest/cheaper PERMITTED on redditapis (grey-hat exemption, dev-buyer register fit). Per feedback_brand_voice_cheap_allowed_on_grey_hat_tenants.
• NO cal.com/calcom. Use Calendly OR redditapis internal pages.

Inline + cover paths

• Cover at cover.src: /blog/content/images/<slug>-cover.<ext> (webp preferred).
• Inline at /blog/content/images/<slug>-slot-NN.svg (canonical SVG).
• Gate 32 enforces hostname identity, no marketing-s3 cross-contamination.

Sitemap discipline

• Per feedback_sitemap_routable_not_published_filter: every routable URL ships in sitemap.xml regardless of frontmatter date: field. getAllRoutableArticles() powers sitemap; getArticles() powers index UI. Filtering applies to listing UX, not crawler discovery.

Cannibalization + hub

• Grep existing posts in apps/frontend/content/blog/ for planned primary keyword + synonyms before drafting. Kill or pivot if existing post owns the angle.

Preflight invocation (run before every commit)

/Users/apple/Downloads/Projects/FORKOFF/ops/blog-preflight/redditapis apps/frontend/content/blog/<slug>.md --skip-liveness

~30 gates dispatched including Gate I (inline floor 10/12), Gate P (canonical pipeline), Gate 7Y (embed triple), Gate 7M (multi-embed floor), Gate BSAFE (brand-safety), Gate 32 (pipeline identity), Gate FAQ (shape), Gate CAL (Calendly), Gate 4 (em-dash zero), Gate 50 (no hashtags), Gate 51 (banned vocab), Gate 52 (disclaimer), Gate 53 (product claim).

Cross-reference

• Route-layer + render gates: apps/frontend/app/blogs/AGENTS.md
• Repo root: AGENTS.md
• Drafting skill: forkoff-blog-drafter
• Cross-tenant blog canon: forkoff-blog-ops skill
• Cover pipeline: redditapis-blog-cover + redditapis-blog-infographic skills
• Brand canon: redditapis-design skill
• Memory: ~/.claude/projects/-Users-apple-Downloads-Projects-FORKOFF/memory/MEMORY.md