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:
co-authored by
Claude Opus 5
parent
8e653082b6
commit
6538b21650
@@ -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
|
||||
|
||||
|
||||
+11
-5
@@ -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),
|
||||
|
||||
Reference in New Issue
Block a user