Skip to content

Commit bd009ff

Browse files
docs(readme): convert README.adoc -> Markdown (renders on Glama/profile/community-health) (#32)
README was AsciiDoc → renders as raw markup in Markdown consumers (Glama MCP directory, GitHub community-health, GitHub profile). pandoc asciidoc→GFM (badges → clickable), SPDX header kept, duplicate `.adoc` removed. Part of the estate README-format fix. Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
1 parent fb57748 commit bd009ff

2 files changed

Lines changed: 90 additions & 83 deletions

File tree

README.adoc

Lines changed: 0 additions & 83 deletions
This file was deleted.

README.md

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
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+
Jonathan D.A. Jewell \<[j.d.a.jewell@open.ac](j.d.a.jewell@open.ac).uk\>
7+
:toc: macro :toclevels: 2 :license: MPL-2.0 :url-repo:
8+
<https://github.com/hyperpolymath/live-files>
9+
10+
[![License](https://img.shields.io/badge/license-MPL--2.0-blue)](LICENSE) ![RSR
11+
Compliant](https://img.shields.io/badge/RSR-compliant-brightgreen) [![Hypatia Scan](https://github.com/hyperpolymath/live-files/actions/workflows/hypatia-scan.yml/badge.svg)](https://github.com/hyperpolymath/live-files/actions/workflows/hypatia-scan.yml)
12+
13+
<div id="toc">
14+
15+
</div>
16+
17+
# Overview
18+
19+
**live-files** is the RSR 2026 Control Plane for the Hyperpolymath
20+
Epistemic Fleet. It contains the orchestration logic for all satellite
21+
and core repos, managing the tier-based organisational structure of 275+
22+
repositories across the ecosystem.
23+
24+
# Features
25+
26+
- **Filing logic** (`just` `file`) — Moves root-level repos into their
27+
correct tiers (Core, Governance, Infrastructure, SSG, MCP, Research)
28+
29+
- **Restoration** (`must` `restore`) — Fixes symlinks and directory
30+
structures
31+
32+
- **Visibility** (`just` `v`) — Two-ply colour-coded map of the
33+
Epistemic Fleet
34+
35+
- **Tier mapping** — Hierarchical organisation of the entire repo
36+
ecosystem
37+
38+
# Quick Start
39+
40+
```bash
41+
# View the Epistemic Fleet map
42+
just v
43+
44+
# File repos into their correct tiers
45+
just file
46+
47+
# Restore broken symlinks
48+
./must restore
49+
```
50+
51+
# Project Structure
52+
53+
live-files/
54+
+-- 0-AI-MANIFEST.a2ml # AI agent entry point
55+
+-- Justfile # Task runner (no Makefiles)
56+
+-- must # Restoration utility
57+
+-- scripts/
58+
| +-- map_ecosystem.sh # Colour-coded fleet map
59+
+-- .machine_readable/ # SCM metadata files
60+
| +-- .machine_readable/6a2/STATE.a2ml
61+
| +-- .machine_readable/6a2/META.a2ml
62+
| +-- .machine_readable/6a2/ECOSYSTEM.a2ml
63+
| +-- .machine_readable/6a2/AGENTIC.a2ml
64+
| +-- .machine_readable/6a2/NEUROSYM.a2ml
65+
| +-- .machine_readable/6a2/PLAYBOOK.a2ml
66+
+-- .well-known/ # Protocol files
67+
| +-- security.txt
68+
| +-- humans.txt
69+
| +-- ai.txt
70+
+-- .github/
71+
+-- workflows/ # CI/CD workflows
72+
+-- CODEOWNERS
73+
74+
# Standards
75+
76+
- No Makefiles — uses Just/Nickel only
77+
78+
- Oxford British English throughout
79+
80+
- nerdctl for all container tasks
81+
82+
- MPL-2.0 licence
83+
84+
# Licence
85+
86+
This project is licensed under the [Palimpsest Licence
87+
(MPL-2.0)](LICENSE).
88+
89+
Copyright (c) 2025-2026 Jonathan D.A. Jewell (hyperpolymath)
90+
\<[j.d.a.jewell@open.ac](j.d.a.jewell@open.ac).uk\>

0 commit comments

Comments
 (0)