DevArtsLab/linear-research-refinement

Linear Research Refinement

Führt einen einzelnen täglichen Forschungsdurchlauf gegen ein lebendes Linear-Forschungsticket durch. Standardziel: DEV-47 (Job-Tracker als Multi-Tenant-SaaS auf Cloudflare produktisieren, DevArts Lab Workspace). Übergib eine andere Issue-ID, um die Fertigkeit für ein anderes Ticket wiederzuverwenden.

Durchlaufprotokoll

1. Ticket abrufen über linear-mcp-server (get_issue oder list_issues nach ID). Zuerst die vollständige Beschreibung und alle Kommentare lesen.

2. Einen Fokusbereich wählen: die offene Frage mit der höchsten Priorität und geringer Vertrauenswürdigkeit oder die älteste unbelegte Behauptung in den Ergebnissen. Gehe tief in einen Bereich, anstatt alles anzufassen.

3. Recherche mit vertrauenswürdigen Quellen: offizielle Dokumentationen, Changelogs, Preisgestaltungsseiten der Anbieter, Upstream-Repositories/Issues. web_search + webfetch verwenden. Jede Quellen-URL und das Prüfdatum notieren.

4. Ticket direkt aktualisieren (save_issue-Patch):

   • Verifizierte Behauptungen mit [verified YYYY-MM-DD: source] markieren
   • Veraltete oder falsche Behauptungen korrigieren
   • Beantwortete Fragen in das Entscheidungsprotokoll verschieben mit: Datum, Entscheidung, Belege, Vertrauensniveau und was die Entscheidung ändern würde
   • Neu entdeckte offene Fragen hinzufügen (warum es wichtig ist + Priorität)
   • Phasen/Pläne aktualisieren, falls die Belege dies rechtfertigen

5. Ein Kommentar pro Durchlauf (save_comment): Fokusbereich, was sich geändert hat, was als nächstes angesehen werden sollte. Markiere Produktentscheidungen (Preisgestaltung, Umfang, Datenschutzabwägungen) für den Benutzer, anstatt sie zu entscheiden.

6. Begrenzt bleiben: ein fokussiertes Inkrement. Tägliche Durchläufe summieren sich.

Regeln

• Nur Recherche und Ticketaktualisierungen. Keine Code- oder Repository-Änderungen.
• Niemals Quellen oder Fähigkeiten erfinden. Nicht überprüfbare Behauptungen als nicht verifiziert mit dem fehlenden Beleg markieren.
• Die Ticketstruktur erhalten; direkt bearbeiten, niemals vollständig neu schreiben.
• Wenn jede Frage gelöst ist: die ältesten verifizierten Behauptungen erneut prüfen (sie veralten) oder den Implementierungsplan vertiefen.
• Das Workspace-Repository darf zum Kontext gelesen, aber nicht bearbeitet werden.

Zeitplanung

Geplante Kopien werden pro Projekt durch das agent-research-kit erstellt (~/projects/devartslab/agent-research-kit/install.sh), das templates/prompt.md.tmpl mit der Issue-ID jedes Projekts rendert. Diese Datei ist die interaktive Referenz; die Prompt-Vorlage des Kits ist der geplante Master.