Dokumentation · Anbindung
Eine Projektspezifikation im 7-Schritte-Wizard erarbeiten — mit KI-Chat je Abschnitt, kuratierten Epics und einem Erzeugen-Schritt, der Repo, Projekt und Tracker in einem Zug befüllt.
Das Spec-Studio entwickelt eine Projektspezifikation, bevor überhaupt ein Projekt existiert: Du arbeitest unter /spec-studio in einem geführten, sieben Schritte umfassenden Wizard eine Spezifikation aus — Abschnitt für Abschnitt, mit einer KI zur Seite oder ganz von Hand — und am Ende steht ein fertiges Projekt mit Repository, Grundlagendokument und kuratierten Epics im Tracker. Willst du dagegen ein bereits klar umrissenes Vorhaben nur an ein bestehendes oder neues Repository anschließen, ist der direkte Weg über „Projekt anlegen” (vorheriges Kapitel) weiterhin schneller — das Spec-Studio lohnt sich, wenn die Spezifikation selbst noch entsteht.
Alle Bildschirmfotos zeigen eine Demo-Umgebung mit Beispieldaten.
Einstieg
Auf der Projekte-Seite startet der Knopf „Projekt aus Spezifikation” einen neuen Entwurf: Du vergibst einen Titel, und das Spec-Studio legt einen Draft an, der jederzeit unterbrechbar und wiederaufnehmbar ist. Alle Entwürfe stehen unter /spec-studio in einer Liste, mit Status und letzter Änderung — ein angefangener Entwurf lässt sich dort einfach wieder öffnen, egal an welchem der sieben Schritte du stehen geblieben bist.
Die sechs Abschnitte
Der Wizard führt durch sechs inhaltliche Abschnitte: Vision & Kontext, Ziele & Nicht-Ziele, Fachliche Anforderungen, Stack & Constraints, NFRs & Guardrails und Epics-Schnitt. Jeder Abschnitt hat links einen KI-Chat und rechts das eigentliche Textfeld — das Dokument wächst live mit, während die KI antwortet, und eine aufklappbare Vorschau zeigt das komplette Dokument aus allen bisher gefüllten Abschnitten.
Jeder Abschnitt lässt sich außerdem jederzeit von Hand bearbeiten — das Textfeld ist nie gesperrt, auch während die KI antwortet. Ist der KI-Chat einmal nicht erreichbar, zeigt ein Hinweisbanner das an; du schreibst den Abschnitt dann einfach selbst weiter, ohne dass sonst etwas blockiert. Änderungen werden automatisch gespeichert, kurz nachdem du aufgehört hast zu tippen.
Stack-Profil
Im Abschnitt Stack & Constraints wählst du ein bestehendes Stack-Profil aus oder legst direkt ein neues an (Name, Sprache, Framework) — die Auswahl trägt automatisch eine Kurzzeile in den Abschnittstext ein. Ein Profil ist optional: Ohne Auswahl bleibt der Abschnitt ein reiner Freitext.
Epics kuratieren
Im Abschnitt Epics-Schnitt schlägt die KI auf Knopfdruck eine Liste möglicher Epics vor — du entscheidest, was davon bleibt: Zeilen editieren, löschen, ergänzen oder per Pfeil umordnen. Ersetzt ein neuer Vorschlag eine bereits gefüllte Liste, fragt das Spec-Studio vorher noch einmal nach.
Der Erzeugen-Schritt
Der siebte Schritt „Erzeugen” ist Verwaltern vorbehalten — Mitglieder ohne diese Rolle sehen dort nur einen Hinweis, alle sechs Abschnitte bleiben ihnen aber uneingeschränkt zugänglich. Er führt eine Checkliste mit vier Teilschritten ab, in genau dieser Reihenfolge:
- Repository — ein neues Repository bei GitHub, GitLab oder Bitbucket anlegen, oder ein bestehendes verbinden.
- Projekt — das eigentliche Anvil-Coder-Projekt entsteht, mit dem eingebauten Tracker.
- Grundlagen & Spezifikation — das komplette Dokument landet als Foundation im Repository,
dazu jeder Abschnitt einzeln unter
docs/spec/. - Epics — die kuratierte Liste wandert unverändert in den Tracker, ohne erneuten KI-Pfad.
Jeder Teilschritt merkt sich seinen Erfolg dauerhaft: Brichst du hier ab und kommst später zurück, zeigt die Checkliste genau, wo es weitergeht — bereits erledigte Teilschritte bleiben abgehakt, keiner läuft ein zweites Mal. Der letzte Teilschritt „Fertig” verlinkt direkt auf das neue Projekt und dessen Board.
Häufige Fragen
Der gewünschte Repository-Name ist schon vergeben — was jetzt? Wähle beim Anlegen einen anderen Namen, oder verbinde stattdessen ein bestehendes Repository über denselben Teilschritt.
Der KI-Chat antwortet nicht? Ein Hinweisbanner zeigt an, wenn das KI-Backend gerade nicht erreichbar ist. Die Abschnitte bleiben trotzdem normal editierbar — von Hand weiterschreiben geht jederzeit, und du verlierst nichts.
Ich sehe den Schritt „Erzeugen” nicht richtig nutzbar? Das Auslösen der vier Teilschritte ist Verwaltern vorbehalten. Frag die Inhaber deiner Organisation, oder arbeite an den sechs Abschnitten weiter — die stehen allen Mitgliedern offen.