Grundbegriffe

Tekk nutzt ein kleines, bewusst gewähltes Vokabular. Wer diese sechs Begriffe sicher kennt, versteht den Rest des Produkts mühelos.

Workspace

Ein Workspace ist das Zuhause deines Accounts für ein Vorhaben – mit seinem Board, seinen Goals, Dokumenten, verbundenen Tools und Einstellungen. Zugriff wird pro Workspace vergeben: Ein MCP-API-Key ist auf genau einen Workspace beschränkt, und alles, was Tekk tut, passiert innerhalb eines Workspaces.

Projekt

Ein Projekt ist eine Codebase innerhalb eines Workspaces, verbunden mit einem Git-Repository. Loops lesen den tatsächlichen Code des Projekts und denken darüber nach, deshalb beruhen Proposals auf dem, was wirklich da ist, statt auf Vermutungen. Ein Workspace kann mehr als ein Projekt enthalten.

Spec

Eine Spec ist die Einheit der Arbeit – Tekks Gegenstück zu Task, Issue oder Ticket, aber so geschrieben, dass sie ausführbar ist. Eine gute Spec ist kurz und strukturiert: was gebaut wird, warum, und die Akzeptanzkriterien, die sagen, wann sie fertig ist. Specs liegen auf dem Board und durchlaufen Zustände (todo → in-progress → completed).

Wir sagen Spec, nie „Task“ oder „Ticket“. Das Wort ist bewusst gewählt: Eine Spec soll so präzise sein, dass ein Agent – oder jemand aus dem Team – ohne Meeting danach handeln kann.

Specs haben einen Typ, damit das Board lesbar bleibt: feature, problem, technical, research oder improvement.

Goal

Ein Goal (Ziel) ist die Richtung, die du für einen Workspace vorgibst – das, was du gerade bewegen willst. Mit Goals sagst du Tekk, was „besser“ gerade bedeutet. Die Loops richten ihre Aufmerksamkeit an den aktiven Goals aus; ein scharf formuliertes Goal ist also dein wichtigster Hebel.

Proposal

Ein Proposal ist ein Vorschlag, den Tekk dir von sich aus bringt – etwas, das einem Loop aufgefallen ist und das er für lohnend hält. Du liest es und entscheidest dich dann für Accept, Revise oder Reject:

• Accept (annehmen) → Tekk macht aus dem Proposal einen Spec-Entwurf auf deinem Board.
• Revise (überarbeiten) → du sagst, was sich ändern soll, und Tekk schreibt dasselbe Proposal direkt um, statt ein neues anzulegen, und prüft seine Belege noch einmal gegen deinen aktuellen Code. Nutze das, wenn der Fund stimmt, aber der Lösungsvorschlag oder die Belege nicht. Ein Proposal lässt sich bis zu dreimal überarbeiten.
• Reject (ablehnen) → das Proposal verschwindet, und die Begründung, die du angibst, lenkt künftige Proposals von dieser Art Vorschlag weg.

Loop

Ein Loop ist eine autonome Routine, die auf deinem Projekt läuft, um Verbesserungen zu finden und vorzuschlagen. Verschiedene Loops achten auf verschiedene Dinge (ein Goal, das vorankommen soll, ein Performance-Signal, ein Fehleranstieg aus einem verbundenen Tool). Hat ein Loop etwas, das deine Aufmerksamkeit verdient, erstellt er ein Proposal.

Aus den Loops kommt das „Self-improving“ – ausführlich erklärt in So arbeiten die Loops.