From 6538b21650e07b2cb5547db09eca7c828fe6ec8d Mon Sep 17 00:00:00 2001 From: Thore Cimbal Date: Tue, 18 Aug 2026 12:00:00 +0000 Subject: [PATCH] docs: README and roadmap described a repo and a wiki that no longer exist MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- README.md | 31 +++++++++++++++++++++---------- roadmap.md | 16 +++++++++++----- 2 files changed, 32 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index a136d1f..a44de90 100644 --- a/README.md +++ b/README.md @@ -30,17 +30,28 @@ GitLab-Issue-Template. **Alle Issues leben auf git.lab.** | Pfad | Artefakt | |---|---| -| [`CLAUDE.md`](CLAUDE.md) | **Kanonische Arbeitskonventionen für alle Agenten-Sessions** (Topologie, Framework, Secrets, Karpathy-Guidelines) | -| `vision/` | Eine Vision je Linie: Community (axion1337.chat), Tool (ThreadNet), Plattform (Homelab) | -| `roadmap.md` | Linien, Meilenstein-Kandidaten, Kadenz — GitLab-Milestones halten den Stand | -| `decisions/` | ADRs — Pflicht bei Architekturentscheidungen **und dauerhaften Ausnahmen** | -| `verfahren/` | Wie wir arbeiten: [Deploy-Übergabe/DoD](docs/wiki/deployment/deploy-uebergabe.md), [Refinement & Retro](docs/wiki/admin/refinement.md), AARs (`docs/aar/`), Werkzeuge | -| `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 | +| [`AGENTS.md`](AGENTS.md) | **Kanonische Arbeitskonventionen für alle Agenten-Sessions** (Topologie, Framework, Secrets, Karpathy-Guidelines). `CLAUDE.md` zeigt nur hierher. | +| [`WORKFLOW.md`](WORKFLOW.md) | Gates, Größenklassen, Debugging-Pfad, Refinement-Ritual | +| [`schema.yaml`](schema.yaml) | Frontmatter-Schema — einzige Wahrheit über den Aufbau der Artefakte | +| [`STATUS.md`](STATUS.md) | Generierte Übersicht; **nicht von Hand ändern** (`scripts/gen_status.py`) | +| `roadmap.md` | Linien, Meilenstein-Kandidaten, Kadenz — die Gruppen-Milestones halten den Stand | +| `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)** — -dort stehen Plattform-Wiki, Homelab-Doku und dieses Repo nebeneinander -([ADR-0006](docs/adr/0006-wikis-konsolidieren-docusaurus.md), Konfiguration in -[`homelab/wiki`](https://git.lab/homelab/wiki)). **Geändert wird immer hier, nie dort.** +Die Prüfungen sind die Alarmanlage: `validate.py` und `gen_status.py` laufen bei jedem +Push, `gruppenpruefung.py` und `stillstandspruefung.py` täglich per Zeitplan. Bekanntes +wird in `scripts/befund_quittungen.tsv` **quittiert, nicht toleriert** +([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 diff --git a/roadmap.md b/roadmap.md index aacbbc4..514dad3 100644 --- a/roadmap.md +++ b/roadmap.md @@ -34,11 +34,17 @@ 2026-08-02 ins Lab gewandert, die Gitea-Ausnahme ist zurückgebaut. 2. GAME-01-Erreichbarkeit + vSwitch-Aufnahme — [#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). -4. **Wiki-Oberfläche entscheiden** — [DOC-03 (#20)](https://git.lab/axion1337.chat/management/-/issues/20): - Docusaurus läuft (`axionwiki.lab`), BookStack steht als Gegenentwurf bereit - ([ADR-0007](docs/adr/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md)). Die Frage - dahinter: Doku im Repo oder im Browser? Verfallsdatum Ende August. +3. ✅ **Backlog zentralisiert** (war: Roadmap-/Board-Ausbau in GitLab, Rest von + gitops#46). Anders entschieden als geplant: nicht das Board wurde ausgebaut, + sondern `docs/issues/` wurde kanonisch und GitLab zum generierten Spiegel + ([ADR-0012](docs/adr/0012-issues-im-repo-gitlab-als-spiegel.md), + [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: [CFGMON-14 (#14)](https://git.lab/axion1337.chat/management/-/issues/14) docker-Gruppe = root-äquivalent (Entscheidung sorb),