agentleFS
edrethardoedrethardo/werkbank-board/.claude/skills/create-ticket/SKILL.md

create-ticket

Skill0 starsChanged 3 months agoMITView on GitHub

Use when the user asks to create a ticket in chat — "erstelle ein Ticket", "leg ein Ticket an", "schreib das als Ticket auf", "mach daraus ein Ticket", "das sollten wir als Ticket festhalten".

12 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 4 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 12 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    ALWAYS go through store.create_ticket — never write a ticket file by hand.

    line 10
  2. Very specific:

    NEVER create a ticket from an isolated copy of this repo (git worktree, review clone, scratch checkout): its tickets/ is frozen at fork …

    line 13
  3. Distinctive:

    Do NOT interrogate the user through all six fields — sensible defaults beat a questionnaire.

    line 56
  4. Very specific:

    If (and only if) you are about to recommend assignee=opencode, resolve the gate now.

    line 61
  5. Distinctive:

    Add a gate first: ask the user for a name (like „Tests laufen durch") and the shell command that proves this class of work is done in this …

    line 85
  6. Very specific:

    Commit the new ticket file per git-discipline: git add tickets/ && git commit -m "Add ticket <id>: <short title>".

    line 327
  7. Distinctive:

    Do not push unless the session's normal push practice applies.

    line 329
  8. Distinctive:

    Never invent acceptance criteria the user didn't imply — a wrong criterion steers the working agent into the wrong build.

    line 339

“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Create a Ticket from Chat

Turn what the user just described into a correctly formatted ticket on the board. ALWAYS go through store.create_ticket — never write a ticket file by hand; the store owns id numbering, filename slugs, and the file format.

NEVER create a ticket from an isolated copy of this repo (git worktree, review clone, scratch checkout): its tickets/ is frozen at fork time, so it assigns a number the live board may already have given away — that is exactly how two tickets ended up sharing WB-93 (WB-101). File tickets in the LIVE board repo, or hand the request to the session that owns it.

1. Gather the fields — ask only for what's missing

From the conversation, fill as much as possible; ask for the rest in plain German, one short question at a time (AskUserQuestion or plain text):

  • title — required. Draft it yourself from the user's words; a good title says the outcome, not the activity.
  • description — required in practice: what should exist afterwards, and any acceptance criteria the user states. If the user gave only a title-sized wish, ask ONE question ("Woran erkennst du, dass es fertig ist?") rather than padding.
  • type — aufgabe (default), bug, or epic (WB-161). If the user is reporting broken behavior, prefer the werkbank-report-bug flow (it asks repro questions); a package big enough that it will have to be broken up into several tickets → epic (it is planned in a chat session, and its children carry epic: WB-<parent>); otherwise aufgabe.
  • priority — hoch | normal (default) | niedrig. Infer from urgency words; only ask when the user signals urgency but you cannot rank it.
  • project — absolute path. Default: default_project from config.json. The named project list lives in config.json under projects (name → path, WB-24): when the user says a project NAME, resolve it there; unknown name → ask instead of guessing. A raw path is fine too — verify it exists before creating. New projects can be registered via werkbank.projects.add_project(config_path, name, path).
  • assignee — estimate who SHOULD work it (user request, 2026-08-16) and set it; the user overrides by naming one. Recommend opencode only when ALL of these hold, otherwise claude:
    1. Small and isolated — new files or one well-bounded change, no cross-module refactor, no security-sensitive or concurrency-sensitive code.
    2. A named check exists for the project in config.json gates (an opencode ticket without a gate refuses to start — check BEFORE recommending, and set the ticket's gate field to the check's name).
    3. Nobody is waiting: priority is niedrig, or the user signalled "irgendwann/ nebenbei". The local lane is 5–10× slower (measured: WB-102, a ~20-line script, ≈20 min) but costs no quota and runs beside the Claude lane. Borderline → claude; a failed opencode attempt that escalates costs more than starting with Claude (measured: WB-92).

Do NOT interrogate the user through all six fields — sensible defaults beat a questionnaire. One confirmation question maximum when everything was inferable.

1a. Gate for opencode — resolve it BEFORE creating (WB-166)

If (and only if) you are about to recommend assignee=opencode, resolve the gate now. The ticket must carry a valid gate: name before it lands on the board — otherwise the first dispatch fails with the German refusal from opencode.no_gate_message. Read the project's gates from config.json:

WB_PROJECT="<absolute project path>" python3 - << 'EOF'
import json, os, sys; sys.path.insert(0, "src")
from werkbank import opencode
cfg = json.load(open("config.json"))
print("\n".join(sorted(opencode.project_gates(os.environ["WB_PROJECT"], cfg)))
      or "(keine)")
EOF

Then decide:

  • Exactly one gate configured → use its name; mention it in the confirmation ("empfohlen: opencode — geprüft über „<name>"").
  • Several gates configured → ask the user which one belongs to this ticket; do NOT guess (a wrong gate greens on unrelated evidence).
  • No gate configured for this project → do NOT create an opencode ticket yet. Offer BOTH honest paths to the user in one sentence:
    1. Fall back to claude and create the ticket now (fastest path).
    2. Add a gate first: ask the user for a name (like „Tests laufen durch") and the shell command that proves this class of work is done in this project, then persist it before creating the ticket:

      WB_PROJECT="<abs path>" WB_GATE_NAME="Tests laufen durch" \
      WB_GATE_CMD="python3 -m pytest tests/ -q" python3 - << 'EOF'
      import json, os
      cfg = json.load(open("config.json"))
      cfg.setdefault("gates", {}).setdefault(os.environ["WB_PROJECT"], {})[
          os.environ["WB_GATE_NAME"]] = os.environ["WB_GATE_CMD"]
      open("config.json", "w").write(json.dumps(cfg, indent=2) + "\n")
      EOF

      Then set gate=<the new name> on the ticket. Do this only when the board is not actively working an opencode ticket for this project — a concurrent gate write can otherwise race the reader.

The claude lane does NOT require a gate; leave the ticket's gate field empty for assignee=claude unless the user explicitly asks for one.

1b. opencode-Modus — Pflicht, sobald assignee: opencode

opencode ist ein kleines lokales Modell. Auf eine Lücke im Ticket reagiert es nicht mit einer Rückfrage, sondern mit einer Vermutung — und eine Vermutung, die zweimal am Gate scheitert, eskaliert an Claude. Das kostet mehr, als das Ticket gleich ordentlich zu schreiben (gemessen: WB-92).

Ein opencode-Ticket MUSS deshalb so aussehen:

  1. Nummerierte Schritte. Alle Design-Entscheidungen vorher treffen und hinschreiben. Keine offenen Fragen im Ticket.
  2. Exakte Namen und Pfade — Datei, Funktion, Flag, Typ. Auf ein vorhandenes Muster zeigen, das man kopieren kann: „GENAU wie src/bar.py als Vorlage".
  3. Abschnitt ## Tests / Abnahme mit kopierbaren Kommandos UND erwartetem Ergebnis — nicht „Tests schreiben", sondern python3 -m pytest tests/test_foo.py -q # erwartet: 3 passed, exit 0.
  4. Abschnitt ## Fertig, wenn als Haken-Liste.
  5. Ein Ticket, eine Verantwortung. Zu groß → aufteilen.
  6. gate: setzen — der Name der Prüfung aus config.json → gates → <Projektpfad>. Hat das Projekt keine, ins Ticket schreiben, dass eine angelegt werden muss (ohne Gate startet das Board ein opencode-Ticket nicht).
  7. Die Tests müssen in der Umgebung grün sein, in der opencode wirklich läuft. Braucht der Test eine GPU oder eine optionale Abhängigkeit, die dort fehlt, ist das Gate unerreichbar und das Ticket eskaliert endlos — dann entweder einen CPU-Weg testen oder das Ticket an claude geben.

Vor dem Anlegen prüfen (fängt die strukturellen Auslassungen, nicht die Qualität):

WB_GATE="Tests laufen durch" python3 - <<'EOF'
import os, sys; sys.path.insert(0, "src")
from werkbank import store
draft = open("/tmp/entwurf.md", encoding="utf-8").read()
# gate= ist die Prüfung, die du in §1a ausgewählt hast — der Entwurf ist
# nur Text und trägt sie noch nicht.
print(store.opencode_ticket_gaps(draft, gate=os.environ["WB_GATE"])
      or "vollständig")
EOF

Kurzbeispiel für die Beschreibung:

1. Lege `src/beispiel/cuda_blur.py` an, GENAU wie `src/beispiel/blur.py` als Vorlage.
2. Ergänze `blur_gpu(frame: np.ndarray, radius: int) -> np.ndarray`.
3. Trage in `config.json` nichts ein — die Umschaltung kommt in WB-193.

## Tests / Abnahme

    python3 -m pytest tests/test_cuda_blur.py -q    # erwartet: 4 passed, exit 0
    python3 -m beispiel.blurbench --cpu                 # läuft ohne GPU durch, exit 0

## Fertig, wenn

[ ] `blur_gpu` existiert und fällt ohne CUDA auf den CPU-Weg zurück
[ ] beide Kommandos oben laufen grün

Vorlagen aus der Praxis: WB-193, WB-194, WB-195 auf diesem Board.

1c. Frischer Kontext oder nicht? (kontext, WB-313)

Jedes Ticket erbt standardmässig den gemerkten Kontext seines Projekts. Das ist oft richtig — und manchmal sehr teuer. Setz kontext: frisch, wenn der Lauf mit dem laufenden Strang inhaltlich nichts zu tun hat:

  • Bugfix oder abgegrenzte Aufgabe ohne Bezug zum laufenden Strang → kontext: frisch
  • Arbeit, die auf dem vorigen Ticket aufbaut (gleiche Dateien, gleicher Umbau) → kontext: weiter (Vorgabe, nichts zu tun)
  • Faustregel aus WB-275: Fällt ein Bug WÄHREND einer langen Produktion auf, gehört er in einen frischen Kontext — nicht in den laufenden. Dass er dort aufgefallen ist, heisst nicht, dass er dorthin gehört.

Der Beleg, warum das ein eigenes Feld wert war: WB-275 ("schwarzer Himmel") war ein Prädikat und genau EIN Write — und kostete $60,83 API-Gegenwert. 56,9 Mio. Prompt-Tokens, davon 99,8 % Cache-Reads eines Kontexts, den ein völlig anderes Ticket aufgebaut hatte. Bezahlt wurde die Beweisführung in einem Kontext, der aus einem fremden Grund schon fast voll war.

Preis der frischen Variante: Der Agent kennt den Vorlauf nicht. Ein Ticket mit kontext: frisch MUSS seinen Kontext selbst mitbringen — exakte Pfade, wie sich der Fehler nachstellen lässt, der Beleg. Ein knapp geschriebenes frisches Ticket ist schlimmer als ein erbendes, weil der Agent nichts hat, worauf er zurückgreifen kann.

1d. Welcher Faden? (faden, WB-345..357)

kontext beantwortet „Vorgeschichte ja oder nein". faden beantwortet WELCHE Vorgeschichte. Vorher gab es pro Projekt genau eine gemerkte Unterhaltung, also erbte jedes Ticket, was in dem Ordner zuletzt passiert war.

Erst nachsehen, was es schon gibt — niemals einen Namen raten:

WB_PROJECT="<absoluter Projektpfad>" python3 - << 'EOF'
import os, sys; sys.path.insert(0, "src")
from werkbank import faeden, store
rows = faeden.overview(store.load_tickets("tickets"), os.environ["WB_PROJECT"],
                       faeden.load_resets(faeden.resets_path("state.json")))
for r in rows:
    print(f"{r['name']:<22}{r['tickets']:>4} Tickets   traegt {r['carried']:>12,}"
          + ("" if r["carried_split"] else "  (ungetrennt)"))
if not rows:
    print("(noch kein Faden in diesem Projekt)")
EOF

Passt einer davon, nimm GENAU diesen Namen. Ein zweiter Faden neben einem vorhandenen ist der teure Fehler: Beide Hälften wachsen getrennt, keine hat den ganzen Zusammenhang, und auffallen wird es erst an der Rechnung. Gross- und Kleinschreibung führt die Werkbank zusammen (Design = design); alles andere nicht — Design und Designs sind zwei Fäden.

Wann welcher Wert:

  • Wiederkehrendes Arbeitsgebiet (Schnitt, Design, Tests, Datenbank) → benannter Faden. Der erste Lauf darin startet ohnehin leer, kostet also fast nichts; ab dem zweiten erbt er genau das Passende.
  • Einzelne, unverbundene Sache → Feld leer lassen (allgemein, Vorgabe) oder kontext: frisch. Beides ist billiger als ein Faden, den nie wieder jemand benutzt.
  • Im Zweifel leer lassen. Ein Faden zu wenig kostet einmal Kontext, ein Faden zu viel verschmutzt die Übersicht dauerhaft.

Namen sind Arbeitsgebiete, keine Aufgaben. schnitt ist gut, weil über Wochen passendes Wissen hineinwächst. wb-402-knopf-blau ist schlecht: nach einem Ticket tot, und übrig bleibt eine Zeile Rauschen in der Übersicht. Höchstens 40 Zeichen, keine Zeilenumbrüche.

faden und kontext: frisch zusammen heissen „diesen Faden neu anfangen". Nicht als Gürtel-und-Hosenträger benutzen: Der Lauf startet leer UND wird zum neuen Kopf des Fadens — alles davor ist für den Faden verloren. Nur setzen, wenn genau das gemeint ist.

Ohne Wirkung bei opencode und dsh — die haben keine fortsetzbaren Sitzungen. Das Feld darf trotzdem gesetzt sein (es ist nur eine Notiz), aber verlass dich nicht darauf, und versprich es dem Nutzer nicht.

1e. Reihenfolge und Kollisionen (nach, nicht_mit)

Das Board liest Felder, keine Prosa. Ein Satz wie „nicht gleichzeitig mit WB-400" im Beschreibungstext hat für die Warteschlange die Wirkung null.

Am 2026-08-30 gemessen, was das kostet: WB-400 und WB-401 fassten dasselbe Projekt breit an (WB-401 benannte 1014 Stellen in 125 Dateien um). Die Regel stand als Prosa im Ticket. Das Board startete WB-401, und der Lauf arbeitete 1:46 lang über der ungespeicherten Arbeit von WB-400. Dass nichts verloren ging, lag daran, dass eine Chat-Sitzung es zufällig bemerkt und den Prozess beendet hat.

Zwei Felder, beide Komma-Listen von Ticket-Nummern:

FeldBedeutungWann
nach: WB-400startet erst, wenn WB-400 fertig istechte Reihenfolge: B baut auf A auf
nicht_mit: WB-400nie GLEICHZEITIG mit WB-400keine Reihenfolge, aber gleiche Dateien

Faustregel: Braucht das neue Ticket ein Ergebnis des anderen → nach. Fassen beide nur dasselbe an, egal in welcher Reihenfolge → nicht_mit. nach verhindert Gleichzeitigkeit nebenbei mit; wer nach setzt, braucht nicht_mit nicht zusätzlich.

Wann du sie setzen musst: sobald das neue Ticket dieselben Dateien, dieselbe Oberfläche oder denselben Umbau berührt wie ein Ticket, das offen, in der Warteschlange oder in Arbeit ist. Nachsehen, nicht raten:

WB_PROJECT="<absoluter Projektpfad>" python3 - << 'EOF'
import os, sys; sys.path.insert(0, "src")
from werkbank import store
for t in store.load_tickets("tickets"):
    if t.project == os.environ["WB_PROJECT"] and t.status in (
            "offen", "zu_bearbeiten", "in_arbeit", "rueckfrage"):
        print(f"{t.id:8} {t.status:14} {t.title[:52]}")
EOF

Ein Haken, den du kennen musst: Steht das Projekt in config.json unter nonblocking_review, gilt nach schon als erfüllt, sobald das Vorgänger-Ticket in review ist — nicht erst nach der Abnahme durch den Nutzer. Für „erst nach der Abnahme" gibt es kein Feld; das ist eine Einstellung des Nutzers, keine des Tickets.

Erfundene Abhängigkeiten sind teuer: Ein nach auf ein Ticket, das nie fertig wird, blockiert die Kette für immer. Setz sie, wenn sie stimmen, nicht vorsorglich.

2. Create it

# Values go through the ENVIRONMENT, never substituted into the snippet —
# a quote or triple-quote in user text would otherwise end the literal and
# execute the rest as Python (WB-35 review).
WB_TITLE="<title>" WB_DESC="<description>" WB_PROJECT="<absolute project path>" \
WB_PRIO="normal" WB_TYPE="aufgabe" WB_ASSIGNEE="claude" WB_GATE="" \
WB_KONTEXT="weiter" WB_FADEN="" WB_NACH="" WB_NICHT_MIT="" \
python3 - << 'EOF'
import os, sys; sys.path.insert(0, "src")
from werkbank import store
t = store.create_ticket("tickets", title=os.environ["WB_TITLE"],
                        description=os.environ["WB_DESC"],
                        project=os.environ["WB_PROJECT"],
                        priority=os.environ["WB_PRIO"], type=os.environ["WB_TYPE"],
                        assignee=os.environ["WB_ASSIGNEE"],
                        gate=os.environ["WB_GATE"],
                        kontext=os.environ["WB_KONTEXT"],
                        faden=os.environ["WB_FADEN"],
                        nach=os.environ["WB_NACH"],
                        nicht_mit=os.environ["WB_NICHT_MIT"])
print(t.id)
EOF

(When another Werkbank checkout is the cwd, adjust paths accordingly — the tickets dir and src/ sit in the Werkbank repo root.)

3. Confirm and commit

  • Tell the user the ticket number and title back in one sentence ("Angelegt: WB-17 — <Titel>, Priorität normal, liegt in Offen.") and where it will appear (board column Offen). Name the estimated assignee WITH its reason in half a sentence („empfohlen: opencode — klein, geprüft über ‚Tests laufen durch', keine Eile") so the user can veto before starting the ticket.
  • Commit the new ticket file per git-discipline: git add tickets/ && git commit -m "Add ticket <id>: <short title>". Do not push unless the session's normal push practice applies.
  • The board picks the file up on its next poll — no restart needed.

Rules

  • Ein Bugfix, der während einer laufenden Produktion auffällt, gehört in einen frischen Kontext (kontext: frisch) — sonst zahlt er den geerbten Kontext mit, den er nie gebraucht hat (WB-275, WB-313).
  • Creating is not starting: the ticket stays in offen. Only the user's drag (or an explicit "arbeite es ab") dispatches it.
  • Never invent acceptance criteria the user didn't imply — a wrong criterion steers the working agent into the wrong build.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.