Repository instructions for Claude (and any AI assistant)

Repository instructions for Claude (and any AI assistant)

Authorship transparency (READER-FACING RULE)

This blog publicly discloses who wrote each piece of content. Readers must be able to tell at a glance whether a page or post was written by Jayesh, by an AI, or co-authored.

This is a hard rule. Apply it to every page (*.md, *.html) under this repo that renders as published content (posts, About, the home page, and any future page added).

Frontmatter (machine-readable)

Every published page must declare authorship in its YAML frontmatter:

authored_by: human        # written entirely by Jayesh
# or
authored_by: ai           # drafted by an AI assistant, no human rewriting
# or
authored_by: human+ai     # AI-assisted draft that Jayesh edited, OR human draft an AI revised

When authored_by is ai or human+ai, also include:

ai_model: claude-opus-4-7   # or whichever model
ai_date: 2026-05-07         # date the AI contribution was made

Visible disclosure (reader-facing)

Every page must render a visible authorship line. The site layout is responsible for rendering this from the frontmatter — do not rely on each post including it manually.

Examples of the rendered output:

  • authored_by: human → "Written by Jayesh."
  • authored_by: ai → "Generated by AI (claude-opus-4-7, 2026-05-07)."
  • authored_by: human+ai → "Co-authored by Jayesh and AI (claude-opus-4-7, 2026-05-07)."

For mixed content where only specific sections are AI-generated, mark those sections inline with a small label (e.g., a callout or italic note) so readers can tell which paragraphs are AI.

Rules for AI assistants editing this repo

  • When you draft or substantially rewrite a page, set authored_by to ai (if no human revision yet) or human+ai (if extending Jayesh's existing prose), and fill ai_model + ai_date.
  • Never edit a authored_by: human page without either (a) flipping it to human+ai and adding the AI fields, or (b) confirming with Jayesh first.
  • Never remove or weaken an existing authorship disclosure.
  • Trivial mechanical edits (fixing typos, updating broken links, renaming a file) do not require flipping authorship — but anything that changes prose meaning does.

Why this exists

Jayesh wants readers to know what's human and what's machine-written. Trust on the blog depends on this being visible and consistent.