Skip to content

license: schemas are MIT, prose is CC BY 4.0 - #7

Merged
RevenuePuzzles merged 1 commit into
mainfrom
claude/schemas-mit-license
Sep 3, 2026
Merged

license: schemas are MIT, prose is CC BY 4.0#7
RevenuePuzzles merged 1 commit into
mainfrom
claude/schemas-mit-license

Conversation

@RevenuePuzzles

Copy link
Copy Markdown
Contributor

What this PR does

The site says "the schema is MIT". The repo said CC BY 4.0. Someone had to move, and the schemas should. The whole point of publishing the heuristics, the trust ladder, and the gap taxonomy as YAML is that other people put them inside things — a CI check, a linter, a product's own config. Creative Commons states plainly that its licenses are not intended for software, and plenty of legal teams will not approve CC-licensed files in a codebase. A license that makes an adopter open a ticket is a license that loses the adoption. Attribution is still wanted, and CITATION.cff makes it one click; it is just no longer a condition of use.

The rule is now one line: machine-readable definitions are MIT, prose is CC BY 4.0. If you embed it, MIT. If you read it, CC BY.

Linked Issue

None. This is a licensing decision made directly, not an ID or vocabulary change — CONTRIBUTING requires a debate Issue for those, not for this.

Type

  • New pattern
  • New gap
  • Teardown
  • Framework edit (must include rationale, ID migration note if renamed, updated examples)
  • Schema fix
  • Doc fix / typo / link
  • Other

No schema content changes — only the # License: header line in each file. No IDs affected.

The inconsistency this also fixes

The schemas did not agree with each other, before any question of what the site said:

File Header said
memory-policy.schema.yaml # License: MIT
aux-heuristics.yaml, trust-architecture.yaml, trust-gap-taxonomy.yaml, trust-contract.yaml # License: CC BY 4.0
agent-spec.schema.yaml (no license line at all)

All six now read # License: MIT (see schemas/LICENSE).

Changes

  • schemas/LICENSE (new) — MIT, stating what it covers and what it does not
  • LICENSING.md — rewritten around the rule, with the reasoning and a practical "what this means" section
  • packages/aux-audit — the carve-out declaring bundled YAML as CC is gone; sync-schemas.mjs now copies schemas/LICENSE into the tarball, so the files carry their license next to them on npm
  • CITATION.cfflicense: [MIT, CC-BY-4.0], accurate for a mixed work
  • README, REPO_STRUCTURE, CONTRIBUTING, docs/schemas.md, profile/README, for-ctos.md, A2-cto-exec-brief.md — restated

On the GitHub badge

The root LICENSE stays CC BY 4.0, so the badge still reads CC BY 4.0. That is correct — GitHub detects the root file, which covers the prose, most of the repository by volume. It is not a statement about schemas/. Rather than leave the badge to imply something wrong, LICENSING.md and the README now say this explicitly, in the place a maintainer checking the license would look.

Contribution bar — checklist

  • I've read CONTRIBUTING.md.
  • If this introduces or renames an ID, I opened a debate Issue first. — no IDs touched.
  • If this adds a pattern, it has a diagram, a runnable example, and an anti-pattern. — n/a.
  • If this adds a gap, it has a reproducible scenario and references a heuristic or trust stage. — n/a.
  • CI passes (schema validation, link check). — verified locally: 34/34 aux-audit tests, check:schemas clean after adding LICENSE to the synced set, check-coverage.py 12/12, yamllint clean, all relative links resolve.
  • No emoji in code or schemas.
  • Short sentences. Named things over adjectives.

Out of scope

repos/agentic-ux-patterns stays CC BY 4.0 — including the example.py files the repo itself describes as copy-paste. The same embedding argument probably applies to them, and leaving them CC reproduces exactly the friction this PR removes elsewhere. But that is a second decision, and making it quietly inside a PR about schemas would be the wrong way to make it. Worth a follow-up.

🤖 Generated with Claude Code

https://claude.ai/code/session_01MhpqWEvwKp7NrmJfdXYq4M


Generated by Claude Code

The site says the schema is MIT. The repo said CC BY 4.0. Someone had to
move, and the schemas should: the whole point of publishing the
heuristics, the trust ladder, and the gap taxonomy as YAML is that other
people put them *inside* things — a CI check, a linter, a product's own
config. Creative Commons states plainly that its licenses are not meant
for software, and plenty of legal teams will not approve CC-licensed
files in a codebase. A license that makes an adopter open a ticket is a
license that loses the adoption.

Attribution is still wanted. CITATION.cff makes it one click. It is no
longer a condition of use.

The rule is now one line: machine-readable definitions are MIT, prose is
CC BY 4.0. If you embed it, MIT. If you read it, CC BY.

- schemas/LICENSE: MIT, stating what it covers and what it does not
- every schemas/*.yaml header now agrees. They did not before:
  memory-policy.schema.yaml already said MIT while the other four said
  CC BY 4.0, and agent-spec.schema.yaml said nothing
- LICENSING.md rewritten around the rule, with why and what-it-means
- packages/aux-audit: the carve-out declaring the bundled YAML as CC is
  gone; sync-schemas.mjs now copies schemas/LICENSE into the tarball so
  the files carry their license next to them on npm
- CITATION.cff: license is [MIT, CC-BY-4.0], accurate for a mixed work
- README, REPO_STRUCTURE, CONTRIBUTING, docs/schemas, profile, for-ctos
  and the A2 CTO brief all restated

The root LICENSE stays CC BY 4.0, so GitHub's badge still reads CC BY
4.0. That is correct: it detects the root file, which covers the prose —
most of the repository by volume. LICENSING.md and README say so
explicitly rather than leaving the badge to imply something wrong about
schemas/.

Not changed: repos/agentic-ux-patterns is still CC BY 4.0, including the
example.py files it describes as copy-paste. The same embedding argument
probably applies to them; that is a separate decision, not one to make
quietly inside a commit about schemas.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MhpqWEvwKp7NrmJfdXYq4M
@RevenuePuzzles
RevenuePuzzles merged commit c97ece7 into main Sep 3, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants