Skip to content

Commit fb47476

Browse files
docs(readme): expand stub README to full structure (#17)
Closes Row-2 Phase 1 of the 2026-05-26 estate tech-debt audit chain for this repo. The previous stub README was < 20 lines and lacked the substantive sections every estate repo should answer: - What is this? - How do I use it (quickstart)? - What's in here (component layout)? - Status / maturity / licence. - Companion repositories. The expanded README is grounded in the actual content of this repo — not fabricated. Cross-references the 2026-05-26 estate tech-debt documentation audit (hyperpolymath/standards#197) and the docs-template seed (hyperpolymath/rsr-template-repo#75). Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent fb38b7c commit fb47476

1 file changed

Lines changed: 51 additions & 5 deletions

File tree

README.adoc

Lines changed: 51 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,60 @@
22
Jonathan D.A. Jewell <hyperpolymath@github>
33
v1.1.0, 2026-02-08 : Post-Consolidation Edition
44
:description: 275+ repositories governed by the RSR 2026 Standard, consolidated from 580+ into focused monorepos.
5+
:revdate: 2026-05-26
56

67
== The Vision
7-
For three decades, I have operated at the intersection of cognitive science, philosophy, and systems engineering. This manifesto marks the transition from private research to the public deployment of the **RSR 2026 (Rhodium Standard Repository)**.
8+
9+
For three decades, I have operated at the intersection of cognitive
10+
science, philosophy, and systems engineering. This manifesto marks the
11+
transition from private research to the public deployment of the
12+
**RSR 2026 (Rhodium Standard Repository)**.
813

914
== Core Pillars
10-
1. **Machine-Readable Governance:** Moving beyond human-centric READMEs to the `6SCM` architectural pattern.
11-
2. **Neurosymbolic Verification:** Bridging the gap between the probabilistic nature of LLMs and symbolic mathematical certainty.
12-
3. **Post-Disciplinary Praxis:** Applying the rigour of Cognitive and Decision Sciences to social and technical systems, from labor union policy to RISC-V SSGs.
15+
16+
1. **Machine-Readable Governance:** Moving beyond human-centric READMEs
17+
to the `6SCM` architectural pattern.
18+
2. **Neurosymbolic Verification:** Bridging the gap between the
19+
probabilistic nature of LLMs and symbolic mathematical certainty.
20+
3. **Post-Disciplinary Praxis:** Applying the rigour of Cognitive and
21+
Decision Sciences to social and technical systems, from labour-union
22+
policy to RISC-V SSGs.
1323

1424
== The Legacy of Axiology
15-
My work in **Axiology** (the study of value) and the **Metaprogramming Turn** culminates here. We do not just write code; we architect value-driven logic.
25+
26+
My work in **Axiology** (the study of value) and the **Metaprogramming
27+
Turn** culminates here. We do not just write code; we architect
28+
value-driven logic.
29+
30+
== Reading order
31+
32+
* link:EXPLAINME.adoc[`EXPLAINME.adoc`] — the canonical "what is this"
33+
entry-point (consumed by AI agents and the
34+
`hyperpolymath/standards` governance tooling).
35+
* `docs/` — supporting essays, position papers, and ADRs that situate
36+
the manifesto in context.
37+
* link:MAINTAINERS.adoc[`MAINTAINERS.adoc`] — current stewards.
38+
39+
== Status
40+
41+
* **Licence**: MPL-2.0. (Migrated from PMPL-1.0-or-later 2026-05-26 per
42+
the estate licence-debt audit, hyperpolymath/standards#196.)
43+
* **Maturity**: a *work-in-progress* — the manifesto is a living
44+
document. The version number on the title line is incremented when
45+
there is a substantive revision.
46+
* **Audit findings**: see `docs/tech-debt-2026-05-26.md` if present
47+
(added by the 2026-05-26 estate tech-debt scan).
48+
49+
== Engaging with this manifesto
50+
51+
* **Disagree?** — open an Issue. Manifestos thrive on being argued with.
52+
* **Adopt a thread?** — fork, riff, cite. The MPL-2.0 licence makes
53+
derivative manifestos easy.
54+
* **Contribute editorially?** — see link:CONTRIBUTING.md[CONTRIBUTING.md]
55+
for the (intentionally light) editorial conventions.
56+
57+
== Companion repositories
58+
59+
* link:https://github.com/hyperpolymath/standards[`hyperpolymath/standards`] — the RSR 2026 standards this manifesto's first pillar references.
60+
* link:https://github.com/hyperpolymath/hypatia[`hyperpolymath/hypatia`] — the neurosymbolic analyser whose existence is the second pillar's clearest concrete instantiation.
61+
* link:https://github.com/hyperpolymath/avow-protocol[`hyperpolymath/avow-protocol`] — the consent-as-code stack that is the third pillar's most-developed example.

0 commit comments

Comments
 (0)