From e8fbc495cb2a4d7df205a3ac9e6921858ee4515a Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 22 Sep 2026 21:56:22 +0000 Subject: [PATCH 1/2] Mark every protocol file as experimental v0.2 and name the earlier working title MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Readers often land on a single protocol file from a search result or a link, without passing through the README. Nothing on those pages said the protocol is experimental or which version it is. The README also never explained why the main protocol file is headed "Human–AI Discovery Protocol" while the project is called earnedshape. Each of the 11 Markdown files under protocol/, including protocol/observation-model/, now carries the same status line directly under its H1: > **Status:** experimental, protocol v0.2. Rules may still change between versions. The line has no links, so it is byte-identical at both directory depths. A version that linked to CHANGELOG was rejected because the relative path differs between protocol/ and protocol/observation-model/, so the line could not be the same everywhere. Renaming the protocol heading was out of scope for this change. Instead, one sentence at the end of the README's licence and version paragraph says that "Human–AI Discovery Protocol" is the earlier working title. tools/known-findings.txt is keyed by line number. The status line adds two lines above the two accepted boundary-lint findings, so those entries move from 112 to 114 and from 89 to 91. They are the same two findings. No new finding is accepted. Tested: tools/boundary_lint.py exits 0 (2 known, 0 new); line 3 of every protocol file matches the status line exactly; the README names the working title exactly once. Risk: because known-findings.txt is keyed by line number, any later edit above those lines in either file must shift the entries again. Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_01H3KoTUo8coyqs8Vyx8StME --- README.md | 2 +- protocol/01_PROTOCOL_V0.2.md | 2 ++ protocol/02_INTERACTION_AND_STATE_MODEL.md | 2 ++ protocol/03_DECISION_RIGHTS_AND_AUTONOMY.md | 2 ++ protocol/04_SHARED_LANGUAGE_POLICY.md | 2 ++ protocol/05_EVALUATION_AND_LEARNING.md | 2 ++ protocol/06_OPEN_SOURCE_AND_PROJECT_PRINCIPLES.md | 2 ++ protocol/07_DECISIONS_AND_OPEN_QUESTIONS.md | 2 ++ protocol/observation-model/01-run-record.md | 2 ++ protocol/observation-model/02-event-vocabulary.md | 2 ++ protocol/observation-model/03-fidelity-levels.md | 2 ++ protocol/observation-model/04-recording-boundaries.md | 2 ++ tools/known-findings.txt | 4 ++-- 13 files changed, 25 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 19a8e67..0d031e3 100644 --- a/README.md +++ b/README.md @@ -80,4 +80,4 @@ Every source the research synthesis relies on is listed and checked in [`researc The scarcest contribution is evidence, not features — especially a discovery where the protocol cost more than it returned. See [`CONTRIBUTING.md`](CONTRIBUTING.md). -Prose is CC BY 4.0, code is MIT ([`docs/licensing.md`](docs/licensing.md)). Protocol `v0.2`; protocol and adapter maturity are versioned separately. +Prose is CC BY 4.0, code is MIT ([`docs/licensing.md`](docs/licensing.md)). Protocol `v0.2`; protocol and adapter maturity are versioned separately. "Human–AI Discovery Protocol", still the heading of [`protocol/01_PROTOCOL_V0.2.md`](protocol/01_PROTOCOL_V0.2.md), is the earlier working title; the protocol is now called earnedshape. diff --git a/protocol/01_PROTOCOL_V0.2.md b/protocol/01_PROTOCOL_V0.2.md index ebf446e..77422ba 100644 --- a/protocol/01_PROTOCOL_V0.2.md +++ b/protocol/01_PROTOCOL_V0.2.md @@ -1,5 +1,7 @@ # Human–AI Discovery Protocol v0.2 +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + ## 1. Objective The protocol supports a human working with AI from an ambiguous starting point toward: diff --git a/protocol/02_INTERACTION_AND_STATE_MODEL.md b/protocol/02_INTERACTION_AND_STATE_MODEL.md index f86333a..af7d7fd 100644 --- a/protocol/02_INTERACTION_AND_STATE_MODEL.md +++ b/protocol/02_INTERACTION_AND_STATE_MODEL.md @@ -1,5 +1,7 @@ # Interaction & State Model v0.2 +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + ## 1. Orthogonal dimensions Do not compress all interaction into one taxonomy. diff --git a/protocol/03_DECISION_RIGHTS_AND_AUTONOMY.md b/protocol/03_DECISION_RIGHTS_AND_AUTONOMY.md index 518ff74..5376a4b 100644 --- a/protocol/03_DECISION_RIGHTS_AND_AUTONOMY.md +++ b/protocol/03_DECISION_RIGHTS_AND_AUTONOMY.md @@ -1,5 +1,7 @@ # Decision Rights & Adaptive Autonomy v0.2 +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + ## 1. Principle > **Initiative is a property of the next move, not a permanent role.** diff --git a/protocol/04_SHARED_LANGUAGE_POLICY.md b/protocol/04_SHARED_LANGUAGE_POLICY.md index c355ddc..a3b45c2 100644 --- a/protocol/04_SHARED_LANGUAGE_POLICY.md +++ b/protocol/04_SHARED_LANGUAGE_POLICY.md @@ -1,5 +1,7 @@ # Shared Conceptual Language Policy v0.2 +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + ## 1. Purpose Long-running Human–AI discovery benefits from shared vocabulary. diff --git a/protocol/05_EVALUATION_AND_LEARNING.md b/protocol/05_EVALUATION_AND_LEARNING.md index d0ee29d..e1d4ffb 100644 --- a/protocol/05_EVALUATION_AND_LEARNING.md +++ b/protocol/05_EVALUATION_AND_LEARNING.md @@ -1,5 +1,7 @@ # Evaluation & Learning Protocol v0.2 +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + ## 1. Principle The protocol itself is a versioned hypothesis. diff --git a/protocol/06_OPEN_SOURCE_AND_PROJECT_PRINCIPLES.md b/protocol/06_OPEN_SOURCE_AND_PROJECT_PRINCIPLES.md index 2b3dc51..cf03025 100644 --- a/protocol/06_OPEN_SOURCE_AND_PROJECT_PRINCIPLES.md +++ b/protocol/06_OPEN_SOURCE_AND_PROJECT_PRINCIPLES.md @@ -1,5 +1,7 @@ # Open-Source & Project Principles v0.2 +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + ## 1. Intent The future project should be suitable for public GitHub development. diff --git a/protocol/07_DECISIONS_AND_OPEN_QUESTIONS.md b/protocol/07_DECISIONS_AND_OPEN_QUESTIONS.md index aa6eb72..8cb83a3 100644 --- a/protocol/07_DECISIONS_AND_OPEN_QUESTIONS.md +++ b/protocol/07_DECISIONS_AND_OPEN_QUESTIONS.md @@ -1,5 +1,7 @@ # Decisions & Open Questions — v0.2 +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + ## A. Current protocol decisions ### D-01 — The asset is a versioned protocol, not a single prompt diff --git a/protocol/observation-model/01-run-record.md b/protocol/observation-model/01-run-record.md index 529affc..f02845e 100644 --- a/protocol/observation-model/01-run-record.md +++ b/protocol/observation-model/01-run-record.md @@ -1,5 +1,7 @@ # Run Record +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + > **Owns:** what a discovery run is, how it is identified, and the metadata without which two runs cannot honestly be compared. ## What a run is diff --git a/protocol/observation-model/02-event-vocabulary.md b/protocol/observation-model/02-event-vocabulary.md index 42e9519..b3cde57 100644 --- a/protocol/observation-model/02-event-vocabulary.md +++ b/protocol/observation-model/02-event-vocabulary.md @@ -1,5 +1,7 @@ # Event Vocabulary +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + > **Owns:** the envelope every event carries, the event kinds, and which subset is required for a conformant run. ## Envelope diff --git a/protocol/observation-model/03-fidelity-levels.md b/protocol/observation-model/03-fidelity-levels.md index 1d013c5..5a3c399 100644 --- a/protocol/observation-model/03-fidelity-levels.md +++ b/protocol/observation-model/03-fidelity-levels.md @@ -1,5 +1,7 @@ # Fidelity Levels +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + > **Owns:** how well a run was observed, and which comparisons that permits. Two surfaces will not be equally observable. Recording that difference is what keeps the evidence honest; ignoring it produces confident conclusions from incomparable data. diff --git a/protocol/observation-model/04-recording-boundaries.md b/protocol/observation-model/04-recording-boundaries.md index b7eb57f..b7fa0de 100644 --- a/protocol/observation-model/04-recording-boundaries.md +++ b/protocol/observation-model/04-recording-boundaries.md @@ -1,5 +1,7 @@ # Recording Boundaries +> **Status:** experimental, protocol v0.2. Rules may still change between versions. + > **Owns:** what an event may never contain. The event stream is the raw material for cross-run analysis, and analysis output eventually leaves the private store as sanitized findings. Boundaries drawn at the point of *recording* are the only ones that hold; boundaries drawn at the point of publication are a promise that a tired person makes at the wrong moment. diff --git a/tools/known-findings.txt b/tools/known-findings.txt index d794218..728a9f9 100644 --- a/tools/known-findings.txt +++ b/tools/known-findings.txt @@ -1,5 +1,5 @@ # Accepted findings. CI fails on anything not listed here. # Each entry is explained in docs/known-findings.md. Removing an entry is a fix; # adding one is a decision that should carry a reason in that document. -protocol/06_OPEN_SOURCE_AND_PROJECT_PRINCIPLES.md:112: R1 -protocol/07_DECISIONS_AND_OPEN_QUESTIONS.md:89: R1 +protocol/06_OPEN_SOURCE_AND_PROJECT_PRINCIPLES.md:114: R1 +protocol/07_DECISIONS_AND_OPEN_QUESTIONS.md:91: R1 From 562033444a674d9e9b33dfa2abeacab006b5de24 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 22 Sep 2026 21:57:26 +0000 Subject: [PATCH 2/2] Add citation metadata and name kschlt as rights holder in both licences People citing the protocol or its research synthesis had nothing to cite from, so every citation was improvised. CITATION.cff (Citation File Format 1.2.0) at the repository root gives them one form: title, abstract (the repository description), type software, repository-code, both licences (MIT for code, CC-BY-4.0 for prose), the four repository topics as keywords, and version "0.2", which is the protocol version. Both licence files previously read "Copyright (c) 2026 earnedshape contributors". That names no one who can grant or enforce the licence. They now name kschlt, the same alias the CITATION.cff author entry uses. The username is the published rights holder by choice, so no full name, email or affiliation appears. The licence terms themselves are unchanged. Alternatives considered: an entity author named "earnedshape contributors" was rejected for the same reason as the old copyright line. A date-released field and a DOI were left out because there is no release or DOI yet; they belong with the first tagged release. Tested: CITATION.cff validates against the official CFF 1.2.0 JSON schema (jsonschema, Draft 7, with format checking); both licence files name kschlt, matching the CFF alias; the boundary lint passes with no new findings. Risk: the CFF version field has to be bumped with each protocol release, starting with v0.2.1. Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_01H3KoTUo8coyqs8Vyx8StME --- CITATION.cff | 17 +++++++++++++++++ LICENSE | 2 +- LICENSE-DOCS | 2 +- 3 files changed, 19 insertions(+), 2 deletions(-) create mode 100644 CITATION.cff diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 0000000..71fbccd --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,17 @@ +cff-version: 1.2.0 +message: "If you use or adapt this protocol or its research synthesis, please cite it as below and name the protocol version you used." +title: "earnedshape" +abstract: "An experimental, tool-agnostic protocol for human–AI product discovery: explicit hypothesis and decision states, human decision rights, progressive commitment and shared language, grounded in cited research." +type: software +authors: + - alias: kschlt +repository-code: "https://github.com/kschlt/earnedshape" +license: + - MIT + - CC-BY-4.0 +version: "0.2" +keywords: + - human-ai-collaboration + - human-in-the-loop + - methodology + - product-discovery diff --git a/LICENSE b/LICENSE index de89634..4bbd389 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2026 earnedshape contributors +Copyright (c) 2026 kschlt Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/LICENSE-DOCS b/LICENSE-DOCS index bd77174..7dc6724 100644 --- a/LICENSE-DOCS +++ b/LICENSE-DOCS @@ -1,6 +1,6 @@ Creative Commons Attribution 4.0 International (CC BY 4.0) -Copyright (c) 2026 earnedshape contributors +Copyright (c) 2026 kschlt The written material in this repository — the protocol specification, the observation model, the capability catalogue, the research synthesis and the