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 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