diff --git a/.github/ISSUE_TEMPLATE/tester-feedback.yml b/.github/ISSUE_TEMPLATE/tester-feedback.yml new file mode 100644 index 00000000..710ecece --- /dev/null +++ b/.github/ISSUE_TEMPLATE/tester-feedback.yml @@ -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 diff --git a/README.md b/README.md index deadad5d..66925694 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,8 @@ ProjectA

An agentic terminal for Windows: many AI coding agents, one calm cockpit.

Mehrere KI-Coding-Agenten parallel arbeiten lassen – jeder in seinem eigenen Terminal, Branch und Worktree.

-

Fokus: sicherer Dauerbetrieb – Not-Aus, Kostenkontrolle, Protokoll.

+

Fertig ist nur, was bewiesen ist: Grün heißt bewiesen, kein Modell prüft sich selbst, der Mensch behält die Kontrolle.

+

Dazu gehören Not-Aus, Kostenkontrolle über Budgetgrenzen und ein nachvollziehbares Protokoll.

Neueste Version Lizenz: MIT @@ -12,6 +13,18 @@ Plattform: Windows +## 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 @@ -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`. @@ -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 diff --git a/docs/TESTEN.md b/docs/TESTEN.md new file mode 100644 index 00000000..f280d0f6 --- /dev/null +++ b/docs/TESTEN.md @@ -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__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). diff --git a/docs/roadmap-2.0.md b/docs/roadmap-2.0.md new file mode 100644 index 00000000..1fc47921 --- /dev/null +++ b/docs/roadmap-2.0.md @@ -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.