Stand: 2026-03-17

J01-83 72-10 CLI-Cache: erste Cache-V1 vorbereiten (Policy getrennt)
Typ
Subtask
Status
Erledigt
Priorität
Medium
Bearbeitung
-
Sprint
-
Sprint-Rolle
-
Lösung
Fertig
Aktualisiert
2026-03-20T05:23:43.397+0100
Übergeordnet
J01-72

Inhalts-Schlüssel

Diese Seite

Kanonischer öffentlicher Arbeitsstand für J01-83. Der Vorgang schneidet den früher breiter formulierten CLI-Cache-Schritt auf eine kleine, schnell ersetzbare erste Cache-Iteration zu und trennt die Policy-Schärfung bewusst in einen eigenen Folgepunkt aus.

Ziel

Eine kleine Cache-V1 vorbereiten, die Mensch und KI schnell belastbare Rezepte für wiederkehrende Jira-Arbeit gibt und diese Rezepte als aktiven Skill-Baustein nutzbar macht, ohne dafür schon die spätere Sicherheits- oder Curl-Reifung vorwegzunehmen.

Quellen- und Chronologiebasis

  • 2026-02-24: In den J01-Notizen wurde ein CLI-Cache bzw. Rezepte-Katalog als Zwischenschritt festgehalten.
  • 2026-02-24: Der Systemüberblick und ADR-0002 verankerten den Cache-Kontext öffentlich, allerdings noch zusammen mit der stärkeren Policy-Sprache.
  • 2026-02-25 und 2026-02-26: Im tagebuch wurde der Strang als „Cache vs. Codex-Skill“ und danach als „Cache-Artefakt vs. Codex-Skill“ geschärft.
  • 2026-03-14: J01-95 zeigte das passende Muster für diese Runde: kleine lokale V1, schnell nutzbar, später ersetzbar.
  • Negativbefund: In den exportierten docs/agile-Quellen wurde kein eigener Cache-Strang gefunden; deshalb war der Punkt auch kein fehlender Rest in J01-91/archive-topics.md.

Jetzt vorbereitet

  • J01-83 in Jira auf Cache-V1 zugeschnitten
  • Policy-Strang als eigener Jira-Kandidat J01-101 ausgelagert
  • neue öffentliche Arbeitsdoku für J01-83 angelegt
  • Quellenlage im tagebuch als eigener Suchfall und als Rundenprotokoll nachgezogen
  • erste Cache-Zelle im Skill-Repo umgesetzt: shared-tooling/jira-pages/cache-recipes/parent-subtasks.md
  • Ziel von J01-83 auf aktive Skill-Nutzung des Cache-Pfads korrigiert

Erste Cache-Zelle

Die V1 ist jetzt mit einer ersten kleinen Cache-Zelle umgesetzt. Dieses Artefakt beschreibt den Lesefall: Jira-Parent lesen und daraus die enthaltenen Subtasks ableiten.

Der kopierbare Kernaufruf lautet:

atlassian jira http get "/rest/api/3/issue/<PARENT_KEY>?fields=subtasks,summary,status"

Das Rezept enthält nur die für diese V1 nötigen Felder:

  • Ziel
  • kopierbarer Befehl
  • Platzhalter
  • erwartete Output-Felder
  • Erfolgssignale
  • Fehlersignale und Grenzen

Als Erfolg gilt in der V1:

  • Exit-Code 0
  • parsebares JSON
  • vorhandenes Feld fields.subtasks
  • lesbare Subtask-Felder key, fields.summary, fields.status.name

Aktive Skill-Nutzung

J01-83 endet nicht bei einem abgelegten Beispiel. Alle befehl-nutzenden Projekt-Skills sollen den Cache-Pfad aktiv verwenden:

  • zuerst im Cache nach passendem Rezept suchen
  • fehlende Rezepte im selben Arbeitsgang anlegen
  • bestehende Rezepte bei Drift nachziehen

Die erste Cache-Zelle ist damit Vorbild und Einstieg, nicht die gesamte Endform des Cache.

Ausdrücklich nicht Teil der V1:

  • vollständige Antwort als Datei speichern
  • lokaler JSON-Snapshot-Cache
  • neue CLI-Subcommands
  • neue Policy-Schärfung im atlassian-http-client

V1-Zuschnitt

  • genau eine erste Cache-Zelle genügt fuer diese Iteration
  • das erste Rezept beschreibt nur: Zweck, kopierbaren Befehl, Platzhalter, erwartete Output-Felder, Erfolgssignale und Grenzen
  • die V1 verpflichtet aber bereits die befehl-nutzenden Projekt-Skills auf den Cache-Pfad shared-tooling/jira-pages/cache-recipes/
  • die Lösung bleibt bewusst klein und schnell austauschbar
  • Vorbild ist die V1-Haltung aus J01-95, nicht dessen konkreter Inhalt

Überprüfungsplan

Prüfpunkt Erwartung Nachweis / Ort Status
Erste Cache-Zelle liegt im Skill-Repo vor parent-subtasks.md ist vorhanden und beschreibt genau einen wiederkehrenden Lesefall shared-tooling/jira-pages/cache-recipes/parent-subtasks.md erledigt
Befehl-nutzende Projekt-Skills behandeln den Cache als ersten Suchraum koordination und jira-state-sync nennen die Cache-Prüfung und das Nachziehen explizit Projekt-Skill-Repo unter skills/ erledigt
Kanonische öffentliche Arbeitsdoku ist direkt aus Jira erreichbar Jira hält einen Remote-Link auf /de/jira/issues/J01-83/; DE/EN-Aufspaltung bleibt bei GitHub Pages Jira-Remote-Links für J01-83 erledigt
Öffentliche Jira-Seite zeigt denselben Abschlussstand Die öffentliche Jira-Fläche übernimmt Status und öffentliche Links aus Jira ohne Jira-Cloud-Links /de/jira/issues/J01-83/ erledigt

Nicht Teil von J01-83

  • keine breite Rezeptbibliothek
  • keine Snapshot-Pflicht
  • keine neue Cache-Engine oder Antwortpersistenz
  • keine neue Policy-Schärfung im Bereich atlassian-tools/curl
  • keine neue Sicherheits- oder Curl-Härtung als DoD dieser ersten Iteration

Abgrenzung zum Policy-Strang

  • J01-101 trägt die getrennte Policy-Folgearbeit.
  • J01-83 bleibt der Cache-Strang und zieht die Policy-Arbeit nicht wieder implizit in den Scope zurück.