docs: README and roadmap described a repo and a wiki that no longer exist

Found while auditing whether everything is documented per the framework. The
automated checks were all green, which is the point: they check artifacts against
the schema, not prose against reality.

The README's structure table named four directories that do not exist - decisions/,
vision/, hosts/, shared/ - and sent readers to axionwiki.lab, which answers 404 and
was retired by ADR-0014, citing the superseded ADR-0006 as if current. AGENTS.md
says plainly that wiki.lab is gone and not to look for it; the repo's own entry
document said the opposite. Replaced with the layout that is actually there, plus
the checks and where acknowledgements live.

roadmap.md carried the same two staleness: "Docusaurus läuft" with an end-of-August
deadline for a question ADR-0014 already answered, and the board build-out from
gitops#46, which was decided the other way round and closed today. Both marked done
with what was actually decided, since a roadmap that claims open work is finished is
worse than one that is merely behind.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Thore Cimbal
2026-08-18 12:00:00 +00:00
co-authored by Claude Opus 5
parent 8e653082b6
commit 6538b21650
2 changed files with 32 additions and 15 deletions
+21 -10
View File
@@ -30,17 +30,28 @@ GitLab-Issue-Template. **Alle Issues leben auf git.lab.**
| Pfad | Artefakt | | Pfad | Artefakt |
|---|---| |---|---|
| [`CLAUDE.md`](CLAUDE.md) | **Kanonische Arbeitskonventionen für alle Agenten-Sessions** (Topologie, Framework, Secrets, Karpathy-Guidelines) | | [`AGENTS.md`](AGENTS.md) | **Kanonische Arbeitskonventionen für alle Agenten-Sessions** (Topologie, Framework, Secrets, Karpathy-Guidelines). `CLAUDE.md` zeigt nur hierher. |
| `vision/` | Eine Vision je Linie: Community (axion1337.chat), Tool (ThreadNet), Plattform (Homelab) | | [`WORKFLOW.md`](WORKFLOW.md) | Gates, Größenklassen, Debugging-Pfad, Refinement-Ritual |
| `roadmap.md` | Linien, Meilenstein-Kandidaten, Kadenz — GitLab-Milestones halten den Stand | | [`schema.yaml`](schema.yaml) | Frontmatter-Schema — einzige Wahrheit über den Aufbau der Artefakte |
| `decisions/` | ADRs — Pflicht bei Architekturentscheidungen **und dauerhaften Ausnahmen** | | [`STATUS.md`](STATUS.md) | Generierte Übersicht; **nicht von Hand ändern** (`scripts/gen_status.py`) |
| `verfahren/` | Wie wir arbeiten: [Deploy-Übergabe/DoD](docs/wiki/deployment/deploy-uebergabe.md), [Refinement & Retro](docs/wiki/admin/refinement.md), AARs (`docs/aar/`), Werkzeuge | | `roadmap.md` | Linien, Meilenstein-Kandidaten, Kadenz — die Gruppen-Milestones halten den Stand |
| `hosts/`, `shared/` | **Bestand + Historie** je Host/Thema — u. a. [Branding](docs/wiki/architecture/branding.md) (Marke, Paletten, wo welches Theme eingestellt ist); offene Punkte sind Issues | | `docs/adr/` | ADRs — Pflicht bei Architektur-/Prozessentscheidungen **und dauerhaften Ausnahmen** |
| `docs/issues/` | Das kanonische Backlog der ganzen Gruppe ([ADR-0012](docs/adr/0012-issues-im-repo-gitlab-als-spiegel.md), [ADR-0019](docs/adr/0019-komponenten-issues-adoptiert.md)) |
| `docs/design/`, `docs/aar/` | Design-Dokumente je Vorhaben; AARs zu Vorfällen und größeren Abweichungen |
| `docs/components/` | Eine Datei je Projekt der Gruppe — wer hier fehlt, wird zum Befund |
| `docs/wiki/`, `docs/sources/` | Wiki-Flächen (u. a. [Deploy-Übergabe/DoD](docs/wiki/deployment/deploy-uebergabe.md), [Refinement & Retro](docs/wiki/admin/refinement.md), [Branding](docs/wiki/architecture/branding.md)) und unveränderliche Quellen |
| `scripts/`, `verfahren/` | Deterministische Werkzeuge — Prüfungen, Spiegel, Migration/Adoption |
Gelesen wird das alles auch gebündelt unter **[axionwiki.lab](https://axionwiki.lab)** — Die Prüfungen sind die Alarmanlage: `validate.py` und `gen_status.py` laufen bei jedem
dort stehen Plattform-Wiki, Homelab-Doku und dieses Repo nebeneinander Push, `gruppenpruefung.py` und `stillstandspruefung.py` täglich per Zeitplan. Bekanntes
([ADR-0006](docs/adr/0006-wikis-konsolidieren-docusaurus.md), Konfiguration in wird in `scripts/befund_quittungen.tsv` **quittiert, nicht toleriert**
[`homelab/wiki`](https://git.lab/homelab/wiki)). **Geändert wird immer hier, nie dort.** ([ADR-0020](docs/adr/0020-bekannte-befunde-quittieren.md)) — eine Prüfung, die dauerhaft
rot steht, meldet nichts mehr.
Gelesen wird die Anwender- und Betriebsdoku unter
**[wiki.axion1337.chat](https://wiki.axion1337.chat)** (Wiki.js,
[ADR-0014](docs/adr/0014-wikijs-loest-docusaurus-ab.md)). Das frühere Docusaurus-Wiki
auf `axionwiki.lab` **existiert nicht mehr** — nicht danach suchen.
## Das Backlog: Issues + Board ## Das Backlog: Issues + Board
+11 -5
View File
@@ -34,11 +34,17 @@
2026-08-02 ins Lab gewandert, die Gitea-Ausnahme ist zurückgebaut. 2026-08-02 ins Lab gewandert, die Gitea-Ausnahme ist zurückgebaut.
2. GAME-01-Erreichbarkeit + vSwitch-Aufnahme — 2. GAME-01-Erreichbarkeit + vSwitch-Aufnahme —
[#2](https://git.lab/axion1337.chat/management/-/issues/2) (Silences bis 2026-08-04!) [#2](https://git.lab/axion1337.chat/management/-/issues/2) (Silences bis 2026-08-04!)
3. Roadmap-/Board-Ausbau in GitLab (Rest von gitops#46: Milestones, Boards). 3.**Backlog zentralisiert** (war: Roadmap-/Board-Ausbau in GitLab, Rest von
4. **Wiki-Oberfläche entscheiden** — [DOC-03 (#20)](https://git.lab/axion1337.chat/management/-/issues/20): gitops#46). Anders entschieden als geplant: nicht das Board wurde ausgebaut,
Docusaurus läuft (`axionwiki.lab`), BookStack steht als Gegenentwurf bereit sondern `docs/issues/` wurde kanonisch und GitLab zum generierten Spiegel
([ADR-0007](docs/adr/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md)). Die Frage ([ADR-0012](docs/adr/0012-issues-im-repo-gitlab-als-spiegel.md),
dahinter: Doku im Repo oder im Browser? Verfallsdatum Ende August. [ADR-0019](docs/adr/0019-komponenten-issues-adoptiert.md)) — seit 2026-08-18 für
alle Tracker der Gruppe, ein Nummernkreis.
4.**Wiki-Oberfläche entschieden** — Wiki.js löst Docusaurus ab
([ADR-0014](docs/adr/0014-wikijs-loest-docusaurus-ab.md)), erreichbar unter
`wiki.axion1337.chat`. `axionwiki.lab` existiert nicht mehr; ADR-0007 ist damit
abgelöst. Offen ist nur noch die Abschottung der Leserechte
([#0103](docs/issues/0103-wiki-zugang-ohne-gruppe-endet-stumm.md)).
5. Sicherheits-Nachlese aus der VPN-Nacht: 5. Sicherheits-Nachlese aus der VPN-Nacht:
[CFGMON-14 (#14)](https://git.lab/axion1337.chat/management/-/issues/14) docker-Gruppe [CFGMON-14 (#14)](https://git.lab/axion1337.chat/management/-/issues/14) docker-Gruppe
= root-äquivalent (Entscheidung sorb), = root-äquivalent (Entscheidung sorb),