v2.4.1 — plan naprawczy + housekeeping

Co nowego

• agents/_common.md — wspólne instrukcje dla wszystkich orków
• agents/triggers.json — single source of truth dla triggerów dispatch
• Frontmatter orków: refaktory (folded scalar, bez inline user:/assistant:)
• Skills: krux/auto-disable, context-watch, examples, moods, orchestration
• hooks/krux-toggle.js — try/catch wokół zapisu stanu
• hooks/krux-config.js — usunięto nadmiarowy export VALID_MODES
• Testy: agents-shape, integration, triggers-sync — nowe suity (133 pass)
• Usunięto martwe bin/krux-detect-settings

v2.3.3 — single source of truth dla triggerów orków

Co zmieniono

Ujednolicenie logiki orkiestracji — jedno źródło prawdy.

Problem

Triggery invokacji orków były zdefiniowane w dwóch miejscach jednocześnie:

• Tabela w skills/krux/SKILL.md (operacyjna logika modelu)
• Listy Triggers: w frontmatter każdego agents/ork-*.md

Te dwa źródła mogły się rozjeżdżać przy aktualizacjach i powodować konflikty (np. jak działa było w ork-badacz i ork-wyrocznia).

Rozwiązanie

• agents/ork-*.md — opisy przepisane na czysto funkcjonalne (co ork robi, jakie ma narzędzia). Zero Use this agent when..., zero Triggers:.
• SKILL.md — jedyne źródło prawdy. Dodana nota "Jedyne źródło prawdy o triggerach: ta tabela". Doprecyzowane rozróżnienie badacz/wyrocznia.
• JSON contract — każdy ork ma teraz "Zwróć TYLKO ten JSON — zero tekstu poza nim" w sekcji Output format.
• Trigger table — wzbogacona o ork-wroz (ryzyko, co jeśli), ork-wynalazca (prototype, MVP), disambiguation note dla badacz/wyrocznia.

v2.3.2 — fix frontmatter orków

Co naprawiono

Krytyczny fix: auto-invocation orków nie działał dla 13/14 orków.

Frontmatter description zawierał bloki user:/assistant: — YAML parser Claude Code interpretował je jako nested keys, ignorował pole tools i wyświetlał generic „Agent from krux plugin (Tools: All tools)" zamiast właściwego opisu i zestawu narzędzi. Ork-straznik był jedynym który działał poprawnie (używał już description: >).

Zmiany

• 13 orków — przepisane description na folded scalar (description: >) z listą triggerów; przywrócone poprawne tools per ork
• README — dodane brakujące /krux-bump i /krux-release do tabeli skilli; uzupełniony rm -f w sekcji odinstalowania o .krux-flow-active, .krux-context-watch-off, .krux-context-threshold
• CLAUDE.md — dodana konwencja frontmatteru orka z ostrzeżeniem o <example>/user:/assistant: blokach
• settings.json — usunięte zombie env-vars SNAF, dodany statusLine wskazujący na .krux-statusline.sh

v2.3.1 — sync marketplace.json + 3-way version guard

Co się zmieniło

• Fix: .claude-plugin/marketplace.json trzymał osobną wersję pluginu (2.2.0) niezależną od plugin.json i package.json. Claude Code /plugin UI czyta wersję stąd, więc mimo bumpu v2.3.0 listing pokazywał starą wersję.
• Prevencja: version-sync-guard hook rozszerzony o 3-way check — teraz pilnuje też marketplace.json.
• Workflow: /krux-bump bumpuje atomowo wszystkie trzy pliki (package.json + plugin.json + marketplace.json).
• Testy: +2 scenariusze (marketplace mismatch, brak marketplace.json). 103/103 zielone.
• Docs: CLAUDE.md zaktualizowany — tabela hooków i sekcja Wersjonowanie.

Patch release — brak zmian funkcjonalnych poza tym co już weszło w v2.3.0.

v2.3.0 — routing modelu dla orków

Co nowe

• Persona Krux wybiera model sonnet/opus/haiku przy każdym spawnie orka (parametr model w Agent tool).
• 7 orków do prostych operacji (badacz, sprawdzacz, niszczyciel, skryba, malarz, straznik, wyrocznia) ma hardkod model: sonnet — grep/read/testy/audyt nie potrzebują Opusa.
• 7 orków do rozumowania (architekt, sędzia, tropiciel, kowal, czyściciel, wróż, wynalazca) zostaje z model: inherit — dziedziczą po parent (Krux).
• Nowa sekcja Model — sonnet czy opus w skills/krux/SKILL.md z regułą kciuka: zadanie w jednym pliku + jedna akcja → sonnet; rozumowanie między plikami → opus; trywialne lookup → haiku.

Dlaczego

Subagent startuje zimny niezależnie od wybranego modelu — cache miss już zapłacony przez sam spawn. Sonnet zamiast Opusa dla prostych zadań = ten sam cold start, tańszy token, szybszy output. Default Opus dla grep = przepalanie kasy.

Kompatybilność

Zmiana nie łamie istniejącego użycia. Użytkownik nadal wywołuje /krux:ork-nazwa tak samo; różnica tylko w tym na jakim modelu ork realnie leci.

v2.2.0 — auto-orkiestracja + conformance

Breaking

• Usunięto skille /krux:krux-orki-lancuch i /krux:krux-orki-rownolegle. Krux sam decyduje: solo / łańcuch / równolegle na podstawie kontekstu zadania — bez slash commandów.

Fixes (conformance ze spec Claude Code)

• color: magenta → color: purple w ork-sedzia i ork-straznik (magenta spoza dozwolonej palety red, blue, green, yellow, purple, orange, pink, cyan).
• Usunięto martwy "main": ".claude/plugins/krux.js" z package.json (wskazywał na nieistniejący plik — OpenCode.ai leftover; Claude Code używa auto-discovery, nie entry-pointa JS).
• Sync version w marketplace.json z plugin.json.

Refactor

• hooks/activate.js: async stdin wzorzec (process.stdin.on('data'|'end')) zamiast sync fs.readFileSync(0) — spójny z pozostałymi 6 hookami. Wykryte przez audit ork-straznik.

Weryfikacja

• 14/14 agentów przechodzi statyczną walidację frontmatterów
• 101/101 testów pass
• Auto-orkiestracja sprawdzona end-to-end przez spawn krux:ork-badacz i krux:ork-straznik

v2.1.0 — czystka w armii orków

Breaking changes

• hook-validator → ork-straznik. Slash /krux:hook-validator usunięty. Użyj /krux:ork-straznik.
• Folder skilli krux-orki-równolegle → krux-orki-rownolegle (ASCII-safe). Slash /krux:krux-orki-rownolegle.

Fixes

• Triggery orków — przemapowane czysciciel/kowal/niszczyciel zgodnie z faktycznymi rolami:
  • ork-czysciciel = refactor (wcześniej błędnie dostawał "martwy kod")
  • ork-kowal = backend/API (wcześniej błędnie dostawał "refaktoryzuj")
  • ork-niszczyciel = dead code removal (wcześniej bez jednoznacznych keywordów)
• Tools ork-tropiciel — dodany Edit (body deklarował "naprawia błąd" ale brakowało narzędzia).
• Name prefixy — usunięty błędny krux: z ork-kowal i ork-malarz.
• Literówki — ork-wyrocznia, ork-skryba, ork-tropiciel.
• Chiński znak 防止 w ork-tropiciel → polskie "zapobiegającym".
• Status values ujednolicone do "ok" | "warning" | "error" we wszystkich 15 agentach.

Improvements

• ork-straznik — polskie body z personą orka (wcześniej hook-validator po angielsku).
• Keywords ork-sprawdzacz zawężone (usunięte "sprawdź" jako too general).
• README opisy ról zsynchronizowane z SKILL.md.

Stats

• 20 plików zmienionych, 151 dodanych, 149 usuniętych
• Testy: 101/101 zielone

v2.0.4

Nowe

• Krux-general: auto-wzywanie orków gdy pasuje kontekst
• Standaryzowany JSON output: każdy ork zwraca {status, summary, details, files, tests, verdict}
• krux parsuje summary: 1 zdanie do usera, reszta dla wewnętrznego użytku

Orkowie

14 specjalistów gotowych do delegacji:

• ork-tropiciel, ork-sprawdzacz, ork-sedzia, ork-czysciciel, ork-kowal, ork-architekt, ork-badacz, ork-malarz, ork-niszczyciel, ork-skryba, ork-wynalazca, ork-wroz, ork-wyrocznia, hook-validator

v2.0.3

Fix

• krux-flow-toggle: dodano aliasy stop iterate / koniec iterate do regex wyłączania flow

Test

• Refaktor helpera w test/krux-toggle.test.js

v2.0.2

feat: v2.0.2 — remove disable-model_invocaton from 4 skills