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),