Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 48 additions & 0 deletions .github/ISSUE_TEMPLATE/tester-feedback.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
name: Tester-Feedback
description: Beobachtung aus dem Testen der installierten App melden
title: "[Tester]: "
labels: ["tester-feedback"]
body:
- type: markdown
attributes:
value: |
Danke fürs Testen von ProjectA! Drei kurze Antworten genügen.
Bitte keine Zugangsdaten, API-Schlüssel oder persönliche Daten einfügen.
- type: textarea
id: did
attributes:
label: Was hast du gemacht?
description: Die Schritte der Reihe nach, zum Beispiel „Projekt hinzugefügt, dann Worker gestartet".
placeholder: 1. … 2. … 3. …
validations:
required: true
- type: textarea
id: expected
attributes:
label: Was hast du erwartet?
description: Was hätte deiner Meinung nach passieren sollen?
validations:
required: true
- type: textarea
id: happened
attributes:
label: Was ist passiert?
description: Was hast du stattdessen beobachtet? Fehlermeldungen gern im Wortlaut.
validations:
required: true
- type: input
id: version
attributes:
label: Version
description: Steht in der App unter „Info“.
value: v1.5.1
validations:
required: true
- type: textarea
id: screenshot
attributes:
label: Screenshot (freiwillig)
description: Ein Bild hilft oft. Bitte vorher prüfen, dass keine Zugangsdaten oder persönlichen Daten zu sehen sind.
placeholder: Bild hierher ziehen oder beschreiben, was zu sehen war.
validations:
required: false
33 changes: 32 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,27 @@
<img src="assets/banner.svg" alt="ProjectA" width="100%" />
<p><em>An agentic terminal for Windows: many AI coding agents, one calm cockpit.</em></p>
<p><strong>Mehrere KI-Coding-Agenten parallel arbeiten lassen – jeder in seinem eigenen Terminal, Branch und Worktree.</strong></p>
<p><strong>Fokus: sicherer Dauerbetrieb – Not-Aus, Kostenkontrolle, Protokoll.</strong></p>
<p><strong>Fertig ist nur, was bewiesen ist: Grün heißt bewiesen, kein Modell prüft sich selbst, der Mensch behält die Kontrolle.</strong></p>
<p><strong>Dazu gehören Not-Aus, Kostenkontrolle über Budgetgrenzen und ein nachvollziehbares Protokoll.</strong></p>

<a href="https://github.com/Cuarroc/ProjectA-updates/releases/latest"><img alt="Neueste Version" src="https://img.shields.io/github/v/release/Cuarroc/ProjectA-updates?label=Version" /></a>
<a href="LICENSE"><img alt="Lizenz: MIT" src="https://img.shields.io/github/license/Cuarroc/ProjectA?label=Lizenz" /></a>
<a href="https://github.com/Cuarroc/ProjectA/actions/workflows/ci.yml?query=branch%3Amain"><img alt="CI auf main" src="https://img.shields.io/github/actions/workflow/status/Cuarroc/ProjectA/ci.yml?branch=main&label=CI" /></a>
<img alt="Plattform: Windows" src="https://img.shields.io/badge/Plattform-Windows-0078D6" />
</div>

## Inhalt

- [Warum ProjectA?](#warum-projecta)
- [Schnellstart](#schnellstart)
- [Funktionen](#funktionen)
- [Wo steht ProjectA?](#wo-steht-projecta)
- [Status und Grenzen](#status-und-grenzen)
- [Mitmachen als Tester](#mitmachen-als-tester)
- [Dokumentation](#dokumentation)
- [Für Entwickler](#für-entwickler)
- [Lizenz](#lizenz)

## Warum ProjectA?

**Unser Fokus ist sicherer Dauerbetrieb:** Agenten sollen lange für dich
Expand Down Expand Up @@ -60,6 +73,16 @@ Dauerbetrieb selbst ist in v1.5.1 noch ausgeschaltet; siehe „Status und Grenze
| Sitzungen wiederherstellen | Verlauf und Entwürfe überstehen einen Neustart (höchstens 7 Tage). |
| Kommandozeile `pa` | Spricht mit der laufenden App über eine lokale, per Token geschützte API. |

## Wo steht ProjectA?

- **Aktuelle Version: `v1.5.1`.** Was sich ändert, steht im
[`CHANGELOG.md`](CHANGELOG.md).
- **Der Plan für Version 2.0 ist am 06.10.2026 freigegeben.** Die verständliche
Kurzfassung steht in [`docs/roadmap-2.0.md`](docs/roadmap-2.0.md), der
vollständige Plan in [`docs/plan/v2.0/plan.md`](docs/plan/v2.0/plan.md).
- Der automatische Dauerbetrieb bleibt bis auf Weiteres ausgeschaltet; er wird
erst nach belegter Abnahme und nur durch den Menschen freigegeben.

## Status und Grenzen

- **App-Version:** `v1.5.1` – diese Version baut der Quellcode auf `main`.
Expand All @@ -73,6 +96,14 @@ Dauerbetrieb selbst ist in v1.5.1 noch ausgeschaltet; siehe „Status und Grenze
- Agent-CLIs und Anbieterzugänge bringst du selbst mit (siehe oben).
- Interne Projektunterlagen sind überwiegend auf Deutsch.

## Mitmachen als Tester

Du möchtest ProjectA ausprobieren? Installiere die aktuelle Version von der
[Release-Seite](https://github.com/Cuarroc/ProjectA-updates/releases/latest)
und arbeite die kurze Klickliste in [`docs/TESTEN.md`](docs/TESTEN.md) durch.
Deine Beobachtungen meldest du am besten über die Issue-Vorlage
„Tester-Feedback“ – sie fragt genau das ab, was wir zur Fehlersuche brauchen.

## Dokumentation

- [`docs/setup/`](docs/setup/README.md) – Agent-CLIs und Anbieter einrichten
Expand Down
60 changes: 60 additions & 0 deletions docs/TESTEN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
# ProjectA testen – Anleitung für Beta-Tester

Danke, dass du ProjectA ausprobierst! Diese Seite führt dich in etwa einer
halben Stunde durch die wichtigsten Funktionen der aktuellen Version `v1.5.1`
und erklärt, wie du deine Beobachtungen meldest.

## Installation

1. Lade den Installer `ProjectA_<Version>_x64-setup.exe` von der
[Release-Seite](https://github.com/Cuarroc/ProjectA-updates/releases/latest)
herunter und führe ihn aus (nur Windows).
2. Spätere Updates kommen über den eingebauten, mit Minisign signierten
Updater – du musst nichts erneut herunterladen.
3. Installiere mindestens eine Agent-CLI (zum Beispiel Claude Code oder Codex
CLI) und melde dich dort an. ProjectA bringt kein eigenes KI-Modell und
keine Anbieterzugänge mit; es steuert die Werkzeuge, die du schon nutzt.

## Was du ausprobieren kannst

Jeder Punkt ist ein kurzer Klickweg in der installierten App:

1. **Projekt hinzufügen:** Links unter „Projekte“ auf „+“ klicken und ein
beliebiges Git-Repository von deiner Festplatte auswählen.
2. **Worker starten:** Auf „Neuer Worker“ klicken, eine kleine Aufgabe
beschreiben (zum Beispiel „Erstelle eine Datei hallo.txt mit einer Zeile
Text“) und ein Agenten-Profil wählen.
3. **Zusehen:** Den Fortschritt auf dem Board verfolgen, das Terminal des
Workers öffnen und danach seine Änderungen in der Diff-Ansicht ansehen.
4. **Not-Aus testen:** Während ein Worker läuft den Not-Aus auslösen – alle
Agenten werden binnen zehn Sekunden beendet und neue Aufträge sind
blockiert, bis du ihn wieder löst.
5. **Budget und Rollen ansehen:** In den Einstellungen die Budgetgrenzen und
die Rechte je Rolle durchsehen.
6. **Learnings freigeben:** Wenn ein Agent etwas über dein Projekt gelernt hat,
erscheint es unter Learnings – es wird erst wirksam, wenn du es freigibst.
7. **Neustart-Probe:** Die App schließen und wieder öffnen – Verlauf und
Entwürfe deiner Sitzungen bleiben erhalten.

Deine installierte Version findest du in der App unter „Info“.

## Was absichtlich ausgeschaltet ist

Der automatische **Dauerbetrieb** (Continuous Mode, Agenten holen sich selbst
Folgearbeit) ist in v1.5.1 ausgeschaltet und lässt sich nicht per Einstellung
freischalten. Das ist Absicht: Er wird erst freigegeben, wenn seine Abnahme
vollständig belegt ist – und nur durch den Menschen, nie durch einen Agenten.
Ein Linux- oder macOS-Paket gibt es nicht.

## Wie du meldest, was dir auffällt

Öffne im Repository ein
[neues Issue](https://github.com/Cuarroc/ProjectA/issues/new/choose) und wähle
die Vorlage **„Tester-Feedback“**. Sie fragt dich: Was hast du gemacht? Was
hast du erwartet? Was ist passiert? Dazu deine Versionsnummer aus „Info“ –
mehr braucht es nicht. Ein Screenshot hilft, ist aber freiwillig; achte dann
darauf, dass keine Zugangsdaten oder persönlichen Daten zu sehen sind.

ProjectA ist ein persönliches Projekt ohne Support-Zusage: Es kann dauern, bis
jemand antwortet. Bekannte Befunde: [`KNOWN_ISSUES.md`](../KNOWN_ISSUES.md).
Tiefergehende Prüfabläufe: [`docs/drills/`](drills/README.md).
82 changes: 82 additions & 0 deletions docs/roadmap-2.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
# Der Weg zu ProjectA 2.0

Diese Seite erklärt in einfachen Worten, was Version 2.0 werden soll und in
welcher Reihenfolge sie gebaut wird. Sie fasst den freigegebenen Plan
[`docs/plan/v2.0/plan.md`](plan/v2.0/plan.md) zusammen; bei Widersprüchen gilt
der Plan.

## Was 2.0 verspricht

ProjectA 2.0 gilt drei Versprechen: **Grün heißt bewiesen** – nichts gilt als
fertig ohne prüfbaren Beleg. **Kein Modell prüft sich selbst** – jede Änderung
prüft ein Modell eines anderen Anbieters. **Der Mensch behält die Kontrolle** –
über Kosten, Stopp und jede Freigabe.

Dafür wird die Oberfläche neu gebaut: zehn Bildschirme mit echten Daten aus dem
Rust-Kern. Ein Bildschirm ohne Datenquelle zeigt ehrlich „noch nicht
verbunden“ – nie erfundene Werte. Kern von 2.0 sind:

- die **Beweis-Schicht**: jede abgeschlossene Arbeit trägt ihren Beleg
(Prüflauf, Exit-Code, Commit) am Ergebnis; ein neuer Commit entwertet ihn,
- der **Leitstand**: alle laufenden Agenten auf einen Blick, mit Antworten auf
„Braucht dich“ direkt ins Terminal,
- **drei Anbieter-Wege**: Claude, Codex und ein lokales Modell als Pflicht-
Ersatz bei Sperre oder Limit – danach gilt „Pause statt Rechnung“,
- **Kontingente und Failover**: die App prüft Limits selbst und wechselt nach
festen Regeln,
- der **Not-Aus überall sichtbar**, wirksam binnen zehn Sekunden,
- der **Core**: eine App-KI mit klar begrenzten Rechten, die Vorbereitungen
übernimmt, aber nie ihre eigenen Rechte erweitert,
- die **Ersteinrichtung**, die bis zum ersten laufenden Agenten führt.

## Die App in neun Bereichen

Die Seitenleiste führt durch neun Bereiche: **Leitstand** (laufende Arbeit),
**Eingang & Plan**, **Beweise**, **Team**, **Automatik**, **Core** und
**Core · Steuerung** (die App-KI und ihre Grenzen), **Gedächtnis** und
**Einstellungen**. Dazu kommt die Ersteinrichtung beim ersten Start.

Nicht alles davon gehört zum Kern. Alles außerhalb des Kerns wird zwar gebaut,
liegt aber hinter Funktionsschaltern und ist standardmäßig aus: sichtbar wird
es erst mit Freigabe durch den Nutzer – spätere 2.x-Versionen schalten es ohne
neues großes Release zu.

## Der Weg in sechs Wellen

- **Welle 0 – Fundament:** die neue Designsprache (Farben, Bewegung, Bausteine,
Texte), unsichtbar hinter einem Schalter, dazu Architektur- und Sicherheits-
Skizzen.
- **Welle 1 – Beweis-Schicht und Maschine:** Auftrag, Arbeit, Beweis,
Fremdprüfung, Freigabe und Ausliefern laufen durch **einen** Zustandsautomaten;
dazu der Kern des Core.
- **Welle 2 – Kern-Bildschirme:** Leitstand, Agent starten, Beweise und die
übrigen Kernseiten bekommen echte Daten.
- **Welle 3 – Rest des Kerns:** Wachhund, Sicherung und Umzug, Aufzeichnung;
die Nutzerabnahme des Kerns. Parallel erste Bildschirme hinter Schaltern.
- **Welle 4 – Release-Pfad:** Updater, Migration und die restlichen
Bildschirme hinter Schaltern.
- **Welle 5 – Abschluss:** die Gesamtabnahme aller Kernkriterien und das
Einfrieren des Plans.
- **Welle 6 – Nach dem Kern:** Kundenprojekte mit Datenschutz-Schleuse und die
Fernansicht, alles hinter Schaltern.

## Die Tore

- **G0 – Plan freigegeben:** erreicht am 06.10.2026. Seitdem läuft Welle 0.
- **G-Kern – der Kern steht:** alle Kernteile erfüllt, das Sicherheitsreview
ohne offenen schweren Befund, der Nutzer hat den Kern abgenommen.
- **Release 2.0.0:** G-Kern erreicht, die Gesamtabnahme ist grün und der Nutzer
gibt das Release frei. Installiert wird über den eingebauten Updater.

## Kein fester Termin

Es gibt bewusst **keinen festen Termin** für 2.0. Der Durchsatz der Agenten ist
erst seit kurzem gemessen – aus den bisherigen Zahlen folgt keine ehrliche
Terminzusage. Stattdessen gilt: jede Welle und jedes Tor ist an Belege und
Abnahmen gebunden, nicht an ein Datum.

## Was 2.0 bewusst nicht ist

Kein eingeschalteter Dauerbetrieb, kein Zugang aus dem Internet, keine
Geldausgaben durch Agenten, kein Verkauf der App an Dritte. Der Dauerbetrieb
bleibt aus, bis der Nutzer ihn selbst freigibt.
Loading