Skip to content

Commit 777206b

Browse files
docs: prototype notice, disclaimers & ethics cross-links (#21)
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 e43dd16 commit 777206b

2 files changed

Lines changed: 75 additions & 0 deletions

File tree

PROTOTYPE.md

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
<!--
2+
SPDX-License-Identifier: CC-BY-SA-4.0
3+
SPDX-FileCopyrightText: 2025-2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
4+
-->
5+
6+
# ⚠️ Prototype status, disclaimers & how this fits the ethics work
7+
8+
> **Aspasia is an early-stage research prototype, not a product.** It
9+
> explores one idea — an *independent neurosymbolic auditor* that
10+
> cross-checks statistical work (Octave + Prolog) — and shares it openly so
11+
> others can test it and push back.
12+
13+
## What "prototype" means here
14+
15+
- **Experimental.** Interfaces, the ABI/FFI surface, config formats and the
16+
audit rules themselves are provisional and may change or be abandoned.
17+
- **Unproven.** The auditor has not itself been independently validated.
18+
Coverage is partial; there are statistical situations it does not yet
19+
understand.
20+
- **No warranty.** Provided "as is", with no warranty of any kind, to the
21+
extent permitted by the licence. See `LICENSE` / `NOTICE`.
22+
23+
## Auditing disclaimer (please read)
24+
25+
Aspasia's whole job is to make you *more confident* in a result. That makes
26+
it dangerous to over-trust — a wrong audit is worse than no audit.
27+
28+
- **The auditor is not an oracle.** A green verdict from Aspasia is *not*
29+
proof that an analysis is correct, that the right test was chosen, or that
30+
an interpretation is sound. A single unverified checker is itself a single
31+
point of failure — the very problem it was built to address.
32+
- **Keep a human statistician in the loop.** Do not use Aspasia to sign off
33+
consequential decisions (clinical, financial, legal, safety) unattended.
34+
- **Correcting the corrector cuts both ways.** Aspasia can be confidently
35+
wrong for exactly the same reasons the LLM it audits can be. Treat its
36+
output as a *second opinion to investigate*, not a ruling.
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 counter-examples, cases it gets
43+
wrong, or "an auditor should also check…".
44+
- Critique of the **ethics framing** (below) is especially valued.
45+
- See `CONTRIBUTING`, `CODE_OF_CONDUCT` and `EXHIBIT-A-ETHICAL-USE.txt`
46+
before contributing.
47+
48+
## Where the ethics thinking lives
49+
50+
Auditing statistics is an *ethics* practice — it is about not misleading
51+
people with numbers, and about honest uncertainty. The estate develops that
52+
reasoning in dedicated sibling projects, and Aspasia defers to them:
53+
54+
| Project | Role in the ethics picture |
55+
|---|---|
56+
| [**Phronesis**](https://github.com/hyperpolymath/phronesis) | A "practical wisdom" language — the estate's substrate for normative reasoning, distinct from a model's raw knowledge. |
57+
| [**Phronesiser**](https://github.com/hyperpolymath/phronesiser) | Adds **normative ethical constraints** to AI agents via Phronesis — the home for *what a responsible verdict owes the person receiving it*. |
58+
| [**Vexometer**](https://github.com/hyperpolymath/vexometer) | The **interaction-ethics / UX** side: an "Irritation Surface Analyser" for the human cost of tools. An auditor that nags or undermines confidence badly is itself a harm — this is how that cost gets named. |
59+
| [**Palimpsest License**](https://github.com/hyperpolymath/palimpsest-license) | The ethical-use licence family this repo ships under; see also this repo's own `EXHIBIT-A-ETHICAL-USE.txt` for the concrete ethical-use expectations. |
60+
61+
For the ethics rationale specifically, start with **Phronesiser** (the
62+
*normative* side) and **Vexometer** (the *human-experience* side); this
63+
repo's `EXHIBIT-A-ETHICAL-USE.txt` grounds both in licence terms.

README.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,18 @@ SPDX-License-Identifier: CC-BY-SA-4.0
33
SPDX-FileCopyrightText: 2025-2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
44
-->
55

6+
> [!WARNING]
7+
> **Early-stage research prototype — not a product, and not an oracle.**
8+
> Interfaces and audit rules are experimental and may change or be abandoned.
9+
> A green verdict is a second opinion to investigate, **not** proof an
10+
> analysis is correct — keep a human in the loop. Interest, critique and
11+
> collaboration are warmly welcome.
12+
> See **[PROTOTYPE.md](PROTOTYPE.md)** for the full disclaimer and how this
13+
> connects to the ethics work —
14+
> [Phronesiser](https://github.com/hyperpolymath/phronesiser) (normative
15+
> constraints) and [Vexometer](https://github.com/hyperpolymath/vexometer)
16+
> (interaction ethics / UX).
17+
618
# The Name
719

820
**Aspasia of Miletus** (~470-400 BCE) taught Socrates the art of

0 commit comments

Comments
 (0)