Skip to content

Commit 49e0ebe

Browse files
docs: prototype notice, disclaimers & ethics cross-links (#53)
Makes clear each repo is an **early-stage research prototype** (not a product), adds the relevant warnings/disclaimers, explicitly welcomes interest & collaboration, and links the ethics/UX context that pins down the ethics side: - [phronesis](https://github.com/hyperpolymath/phronesis) — practical-wisdom language (normative substrate) - [phronesiser](https://github.com/hyperpolymath/phronesiser) — normative ethical constraints for AI agents - [vexometer](https://github.com/hyperpolymath/vexometer) — interaction-ethics / UX (Irritation Surface Analyser) - [palimpsest-license](https://github.com/hyperpolymath/palimpsest-license) — ethical-use licence family Adds `PROTOTYPE` notice + a README banner. Docs-only. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 6f657c5 commit 49e0ebe

2 files changed

Lines changed: 96 additions & 0 deletions

File tree

PROTOTYPE.adoc

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
// SPDX-License-Identifier: CC-BY-SA-4.0
2+
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
3+
= ⚠️ Prototype status, disclaimers & how this fits the ethics work
4+
5+
[.lead]
6+
*Anamnesis is an early-stage research prototype, not a product.* It explores
7+
one idea — parsing tangled multi-LLM conversation threads back into clean,
8+
project-bucketed knowledge — and shares it openly for critique.
9+
10+
== What "prototype" means here
11+
12+
* *Experimental.* The multi-language pipeline (OCaml parser, Elixir
13+
orchestrator, …), the ABI/FFI surface, data formats and extraction
14+
heuristics are all provisional and may change or be abandoned.
15+
* *Unproven.* Extraction and reconciliation are best-effort. It will miss
16+
things, mis-bucket things, and mis-attribute things.
17+
* *No warranty.* Provided "as is", with no warranty of any kind, to the
18+
extent permitted by the licence. See `LICENSE` / `NOTICE`.
19+
20+
== Data & privacy disclaimer (please read)
21+
22+
Anamnesis ingests *conversation logs* — which routinely contain other
23+
people's words, secrets, and personal data. Handle accordingly.
24+
25+
* *Consent and provenance matter.* Conversations may include third parties
26+
who never agreed to be parsed, summarised, or re-shared. Only feed in data
27+
you have the right to process, and don't misrepresent where a summary came
28+
from.
29+
* *Secrets leak through logs.* Chat histories frequently contain API keys,
30+
tokens and credentials. Treat all inputs and outputs as sensitive; do not
31+
publish generated summaries without review.
32+
* *Summaries can distort.* Automated reconciliation can drop the caveats and
33+
keep the confident-sounding claim. Don't treat Anamnesis output as an
34+
authoritative record of what was decided or why.
35+
* *Not security-audited.* Do not point it at sensitive data in production
36+
without your own review.
37+
38+
== Interest and collaboration warmly welcome
39+
40+
This is shared to *invite scrutiny*, not to advertise a finished thing.
41+
42+
* Open an *issue* or *discussion* with failure cases, privacy concerns, or
43+
"it should also capture…".
44+
* Critique of the *ethics framing* (below) is especially valued.
45+
* See `CONTRIBUTING` and `CODE_OF_CONDUCT` before opening a PR.
46+
47+
== Where the ethics thinking lives
48+
49+
Turning private conversations into durable, searchable knowledge is an
50+
*ethics* act — about consent, provenance, and honest summarisation. The
51+
estate develops that reasoning in dedicated sibling projects, and Anamnesis
52+
defers to them:
53+
54+
[cols="1,3",options="header"]
55+
|===
56+
| Project | Role in the ethics picture
57+
58+
| https://github.com/hyperpolymath/phronesis[*Phronesis*]
59+
| A "practical wisdom" language — the estate's substrate for normative
60+
reasoning, distinct from a model's raw knowledge.
61+
62+
| https://github.com/hyperpolymath/phronesiser[*Phronesiser*]
63+
| Adds *normative ethical constraints* to AI agents via Phronesis — the home
64+
for rules like "don't retain or re-share what you weren't given the right
65+
to".
66+
67+
| https://github.com/hyperpolymath/vexometer[*Vexometer*]
68+
| The *interaction-ethics / UX* side: an "Irritation Surface Analyser" for
69+
the human cost of tools. A knowledge system that buries people in noisy or
70+
wrong summaries imposes a real cost — this is how that gets named.
71+
72+
| https://github.com/hyperpolymath/palimpsest-license[*Palimpsest License*]
73+
| The ethical-use licence family this repo ships under; its Exhibit A asks
74+
for transparency in automated processing and honest provenance — directly
75+
relevant to summarising conversations.
76+
|===
77+
78+
For the ethics rationale specifically, start with *Phronesiser* (the
79+
*normative* side) and *Vexometer* (the *human-experience* side).

README.adoc

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,24 @@
1+
// SPDX-License-Identifier: CC-BY-SA-4.0
2+
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
13
= Anamnesis
24

35
image:https://img.shields.io/badge/License-MPL--2.0-blue.svg[License: PMPL-1.0,link="https://github.com/hyperpolymath/palimpsest-license"]
46
image:https://img.shields.io/badge/Philosophy-Palimpsest-indigo.svg[Palimpsest,link="https://github.com/hyperpolymath/palimpsest-license"]
7+
image:https://img.shields.io/badge/status-prototype-orange.svg[Prototype,link="PROTOTYPE.adoc"]
8+
9+
[WARNING]
10+
====
11+
*Early-stage research prototype — not a product.* Interfaces and heuristics
12+
are experimental and may change or be abandoned. It ingests *conversation
13+
logs*, which often contain other people's data and secrets — only feed in
14+
what you have the right to process, and review outputs before sharing.
15+
Interest, critique and collaboration are warmly welcome. +
16+
See link:PROTOTYPE.adoc[*PROTOTYPE.adoc*] for the full disclaimer and how
17+
this connects to the ethics work —
18+
https://github.com/hyperpolymath/phronesiser[Phronesiser] (normative
19+
constraints) and https://github.com/hyperpolymath/vexometer[Vexometer]
20+
(interaction ethics / UX).
21+
====
522

623

724
*A conversation knowledge extraction and reconciliation system for multi-LLM development workflows.*

0 commit comments

Comments
 (0)