Thore CimbalandClaude Opus 5
6538b21650
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>
94 lines
5.3 KiB
Markdown
94 lines
5.3 KiB
Markdown
# management
|
|
|
|
Steuerungs-Repo für alles über den einzelnen Projekten: Visionen, Roadmap,
|
|
Entscheidungen (ADR), Arbeitsverfahren, AARs — und der Bestand der Hosts.
|
|
Framework: **Kanban-Rückgrat mit leichten Scrum-Elementen**, begründet und
|
|
im Detail festgelegt in [ADR-0005](docs/adr/0005-pm-framework-kanban.md).
|
|
|
|
*(Bis 2026-08-01 hieß dieses Repo `Backlogs` und führte offene Punkte als
|
|
Markdown — die leben jetzt als Issues, siehe unten.)*
|
|
|
|
## Repo-Topologie (seit 2026-08-01)
|
|
|
|
**Kanonisch lebt dieses Repo auf `git.lab`** (`axion1337.chat/management`, nur im
|
|
Lab bzw. via VPN erreichbar — das Lab ist die Quelle der Wahrheit,
|
|
[ADR-0002](docs/adr/0002-issues-und-management-ins-lab.md)).
|
|
`rohana.axion1337.de/sorb/management` ist ein **Push-Mirror**: git.lab
|
|
überschreibt ihn bei jedem Push per Force. Deshalb **nie direkt zu Gitea
|
|
pushen** — solche Commits gehen beim nächsten Mirror-Lauf verloren (Rettung:
|
|
`.patch` von Gitea ziehen + `git am`, siehe
|
|
[Kanonisierung](docs/wiki/deployment/deploy-uebergabe.md)).
|
|
|
|
**Keine Ausnahmen mehr.** Die **Deploy-Übergabe-Issues** liefen bis 2026-08-02 auf
|
|
dem Gitea-Tracker, weil Hosts außerhalb des Labs `git.lab` nicht erreichten. Mit dem
|
|
Site-to-Site-VPN ([ADR-0004](docs/adr/0004-site-to-site-vpn-hetzner-lab.md)) ist der
|
|
Grund entfallen — bei eingeschaltetem Tunnel erreicht CFGMON git.lab. Sie sind
|
|
umgezogen (LABNET-03), der Gitea-Tracker ist leer, die Vorlage liegt als
|
|
GitLab-Issue-Template. **Alle Issues leben auf git.lab.**
|
|
|
|
## Struktur
|
|
|
|
| Pfad | Artefakt |
|
|
|---|---|
|
|
| [`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 |
|
|
|
|
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
|
|
|
|
Alle offenen Punkte sind **Issues in diesem Projekt** (host-/infra-Scope, mit
|
|
`host:`-Labels; die alten IDs wie `CFGMON-01` bleiben im Titel) bzw. in den
|
|
Produkt-Projekten der Gruppe (Projekt-Scope). Das
|
|
**[Gruppen-Board](https://git.lab/groups/axion1337.chat/-/boards)** zeigt alles
|
|
über die `status:`-Labels:
|
|
|
|
| Label | Bedeutung | Policy |
|
|
|---|---|---|
|
|
| *(keins)* | Backlog | wird im Refinement gesichtet |
|
|
| `status:next` | als Nächstes gezogen | die einzige „Zusage" (Pull nach Kapazität) |
|
|
| `status:doing` | in Arbeit | **WIP-Limit: max. 2** |
|
|
| `status:wartet` | blockiert | nur mit benanntem Grund im Issue |
|
|
|
|
Genau **ein** `status:`-Label pro Issue. Prioritäten weiter über `priority:*`.
|
|
|
|
## Konventionen (unverändert gültig)
|
|
|
|
**IDs** (`CFGMON-01`, `ZONE-01`, …) werden **nie wiederverwendet**; sie leben in
|
|
Issue-Titeln weiter. Neue host-/infra-Punkte bekommen die nächste freie Nummer
|
|
ihres Präfixes als Issue.
|
|
|
|
**Jeder Punkt braucht** eine Beschreibung des tatsächlichen Zustands und einen
|
|
konkreten nächsten Schritt; nicht selbst Verifiziertes wird als solches markiert
|
|
(woher stammt die Aussage?). **Zeitkritisches** bekommt ein Datum, nicht „bald".
|
|
|
|
**Erledigtes und Verworfenes** bleibt sichtbar: Issues werden geschlossen (nicht
|
|
gelöscht), `verworfen` wird im Schlusskommentar begründet — der Unterschied
|
|
zwischen „gemacht" und „bewusst gelassen" ist die häufigste Rückfrage.
|
|
|
|
## Verhältnis zu den Projekt-Repos
|
|
|
|
Konfiguration lebt in den Projekt-Repos (z. B. `threadnet-operating` für den
|
|
CFGMON-Stack), reine Projekt-Bugs/-Features in deren Issues auf git.lab.
|
|
Hierher gehört, was mehrere Hosts/Repos betrifft oder eine Entscheidung ist.
|
|
Ein Punkt, der von zwei Seiten beschrieben wird, verlinkt die andere Seite und
|
|
wird beim Schließen **dort mitaktualisiert**.
|