Projekte

Was es ist

Ein Projekt ist ein registriertes Verzeichnis (meist ein git-Repository) mit einem Planungsdokument. Dieses Dokument ist CHANGELOG.md, strukturiert in drei Abschnitte: ## Released: vX.Y.Z für Fertiges, ## In Entwicklung: vA.B.C für aktive Arbeit und ## Changelog für narrative Release-Notizen. Der Hub liest diese Datei über lib/projects.js und lib/roadmap.js; ROADMAP.md wird als Fallback für nicht migrierte Projekte unterstützt.

Der Backlog wohnt nicht mehr im Planungsdokument. Alle künftigen Ideen gehören auf das Board, nicht in die CHANGELOG.md.

Warum / wann

Ein registriertes Projekt verbindet zwei Dinge. Erstens verknüpft es Board-Karten mit einer echten Codebase: Die autonome Pipeline kann Worktrees anlegen, Coding-Sessions starten und Changelog-Einträge direkt ins Projekt schreiben. Zweitens zeigt die Projekt-Detailansicht einen Live-Snapshot des Stands mit Checkboxen zum Abhaken.

Wer mehrere Repositories in einer Penates-Instanz betreibt, braucht die Projektregistrierung: Sie teilt dem Board, dem Filebrowser und dem Repo-Panel mit, welches Verzeichnis zu welcher Arbeit gehört.

Wie nutzen

Projekt registrieren: Projects-Ansicht öffnen und den Pfad zum lokalen Repository eintragen. Penates liest dort die CHANGELOG.md.
Fortschritt ansehen: Die Detailansicht zeigt Released- und In-Development-Abschnitte. Ein Klick auf ein Item toggled die Checkbox (PATCH /api/projects/:id/items).
Release schneiden: Die Release-Aktion stempelt den aktuellen In-Development-Abschnitt als neue Release-Version ins Planungsdokument.
Ideen generieren: Die Ideagen-Aktion startet eine Coding-Session, die das Projekt liest und neue Board-Karten vorschlägt. Diese Karten landen in der idea-Spalte des Boards.
Dateien durchsuchen: Jedes Projekt hat einen Filebrowser, der auf sein Verzeichnis beschränkt ist.

Grenzen

Beim manuellen Bearbeiten der CHANGELOG.md gelten folgende Regeln: nur Top-Level-Checkboxen (keine eingerückten Unterelemente), keine {}-Zeichen im Item-Text (kollidieren mit dem internen Meta-Suffix), keine Steuerzeichen. Änderungen über die Hub-UI sind parser-sicher validiert. board.json niemals direkt bearbeiten; stattdessen UI oder API verwenden.