Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions CITATION.cff
Original file line number Diff line number Diff line change
@@ -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
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion LICENSE-DOCS
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
2 changes: 2 additions & 0 deletions protocol/01_PROTOCOL_V0.2.md
Original file line number Diff line number Diff line change
@@ -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:
Expand Down
2 changes: 2 additions & 0 deletions protocol/02_INTERACTION_AND_STATE_MODEL.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 2 additions & 0 deletions protocol/03_DECISION_RIGHTS_AND_AUTONOMY.md
Original file line number Diff line number Diff line change
@@ -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.**
Expand Down
2 changes: 2 additions & 0 deletions protocol/04_SHARED_LANGUAGE_POLICY.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 2 additions & 0 deletions protocol/05_EVALUATION_AND_LEARNING.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 2 additions & 0 deletions protocol/06_OPEN_SOURCE_AND_PROJECT_PRINCIPLES.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 2 additions & 0 deletions protocol/07_DECISIONS_AND_OPEN_QUESTIONS.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 2 additions & 0 deletions protocol/observation-model/01-run-record.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 2 additions & 0 deletions protocol/observation-model/02-event-vocabulary.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 2 additions & 0 deletions protocol/observation-model/03-fidelity-levels.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 2 additions & 0 deletions protocol/observation-model/04-recording-boundaries.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
4 changes: 2 additions & 2 deletions tools/known-findings.txt
Original file line number Diff line number Diff line change
@@ -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
Loading