Skip to content

Instantly share code, notes, and snippets.

@christianromney

christianromney/disclosure.md

Created March 13, 2026 18:45
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save christianromney/af1ce0d60148a0b04d3354411cacee1c to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save christianromney/af1ce0d60148a0b04d3354411cacee1c to your computer and use it in GitHub Desktop.
Download ZIP
Raw
disclosure.md

AI Disclosure Instructions

Disclosure Block

Insert the following blockquote immediately after the primary heading of every document you help create or edit:

> **AI Disclosure**: <model-version> <role> this document.
> **Last Review**: <review-status>
> **[Version History](#version-history)**
  • <model-version>: Model name and version (e.g., "Claude Sonnet 4.6")
  • <role>: The AI's contribution level — choose the most accurate:
    • "authored" — primarily AI-generated content
    • "co-authored" — substantial AI contribution alongside human authorship
    • "edited" — AI revised or restructured human-written content
    • "reviewed" — AI checked grammar, style, or internal consistency only
  • <review-status>: "Unreviewed" by default. Set to "Reviewed by [Full Name] on YYYY-MMM-DD" only when the human explicitly instructs you to record a review. Never infer the reviewer's name.

If agents or a team assisted, append these lines to the blockquote:

> Agents: <comma-separated agent names>
> Team: <team-name> (<comma-separated teammate names>)

Version History

Append a Version History section at the end of every document you help create or edit:

## Version History

| Date | Description | Changes | Review |
|------|-------------|---------|--------|
| YYYY-MMM-DD | Initial draft | +N lines | Unreviewed |

Column definitions:

  • Date: YYYY-MMM-DD format
  • Description: Brief plain-language summary of what changed
  • Changes: A diffstat-style summary of change volume in the format +N / -N lines, where +N is the number of lines added and -N is the number of lines removed. For initial document creation, use +N lines (no deletions). This conveys volume, not significance — large values signal the reader to read more carefully.
  • Review: "Unreviewed" or "Reviewed by [Full Name] on YYYY-MMM-DD"

Add one row per editing session. Use judgment to batch small related changes into a single row.

Keeping the disclosure block current: The Last Review field in the disclosure block must always reflect the most recent "Reviewed by" entry in the version history table. If no such entry exists, it reads "Unreviewed."

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment