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
- EmanueleNene/claude-skillstheir own version, first seen Nov 16, 2026
- spencerldixon/skillstheir own version, first seen Nov 8, 2026
- islandhopper81/claude-skillstheir own version, first seen Nov 1, 2026
- snuffish/dotfilestheir own version, first seen Nov 1, 2026
- EvolutionAPI/evo-nexustheir own version, first seen Oct 8, 2026
- epam/ai-dial-chattheir own version, first seen Oct 8, 2026
Other versions12 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 12
- EvolutionAPI/evo-nexus★ 545same name
- evolution-foundation/evo-nexus★ 535same name
- epam/ai-dial-chat★ 501same name
- spencerldixon/skills★ 4same name
- fabianmagrini/skills★ 1same name
- foogunlana/skills★ 1same name
- hmshb/autonomous-dev-squad★ 1same name
- jd-solanki/krutrimbox★ 1same name
- aakash-dhar/claude-skills★ 0same name
- EmanueleNene/claude-skills★ 0same name
2 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- creating-skillsSkill
- documentingSkill
- explaining-complexitySkill
- finding-knowledgeSkill
- git-disciplineSkill
- journalingSkill
- start-boardSkill
- werkbank-work-ticketSkill
- work-ticketsSkill
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
- Very specific: line 10
ALWAYS go through store.create_ticket — never write a ticket file by hand.
- Very specific: line 13
NEVER create a ticket from an isolated copy of this repo (git worktree, review clone, scratch checkout): its tickets/ is frozen at fork …
- Distinctive: line 56
Do NOT interrogate the user through all six fields — sensible defaults beat a questionnaire.
- Very specific: line 61
If (and only if) you are about to recommend assignee=opencode, resolve the gate now.
- Distinctive: line 85
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 …
- Very specific: line 327
Commit the new ticket file per git-discipline: git add tickets/ && git commit -m "Add ticket <id>: <short title>".
- Distinctive: line 329
Do not push unless the session's normal push practice applies.
- Distinctive: line 339
Never invent acceptance criteria the user didn't imply — a wrong criterion steers the working agent into the wrong build.
“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.
Files
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, orepic(WB-161). If the user is reporting broken behavior, prefer thewerkbank-report-bugflow (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 carryepic: WB-<parent>); otherwiseaufgabe. - 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_projectfromconfig.json. The named project list lives inconfig.jsonunderprojects(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 viawerkbank.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
opencodeonly when ALL of these hold, otherwiseclaude:- Small and isolated — new files or one well-bounded change, no cross-module refactor, no security-sensitive or concurrency-sensitive code.
- 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'sgatefield to the check's name). - 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)")
EOFThen 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:
- Fall back to
claudeand create the ticket now (fastest path). 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") EOFThen 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.
- Fall back to
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:
- Nummerierte Schritte. Alle Design-Entscheidungen vorher treffen und hinschreiben. Keine offenen Fragen im Ticket.
- Exakte Namen und Pfade — Datei, Funktion, Flag, Typ. Auf ein vorhandenes
Muster zeigen, das man kopieren kann: „GENAU wie
src/bar.pyals Vorlage". - Abschnitt
## Tests / Abnahmemit kopierbaren Kommandos UND erwartetem Ergebnis — nicht „Tests schreiben", sondernpython3 -m pytest tests/test_foo.py -q # erwartet: 3 passed, exit 0. - Abschnitt
## Fertig, wennals Haken-Liste. - Ein Ticket, eine Verantwortung. Zu groß → aufteilen.
gate:setzen — der Name der Prüfung ausconfig.json→gates→<Projektpfad>. Hat das Projekt keine, ins Ticket schreiben, dass eine angelegt werden muss (ohne Gate startet das Board ein opencode-Ticket nicht).- 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
claudegeben.
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")
EOFKurzbeispiel 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ünVorlagen 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)")
EOFPasst 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) oderkontext: 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:
| Feld | Bedeutung | Wann |
nach: WB-400 | startet erst, wenn WB-400 fertig ist | echte Reihenfolge: B baut auf A auf |
nicht_mit: WB-400 | nie GLEICHZEITIG mit WB-400 | keine 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]}")
EOFEin 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.
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
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.

