Każdy podfolder zawiera README.md (jak skonfigurować, kiedy używać) i install.sh (idempotent, ~30 linii) dla pojedynczego narzędzia.
c2004 używa pojedynczego env var LLM_MODEL jako single source of truth
dla domyślnego modelu (obecnie openrouter/deepseek/deepseek-v4-pro,
ustawione 2026-05-10 po empirycznym A/B teście — patrz
docs/SESSION-2026-05-09-summary.md).
Wszystkie narzędzia LLM-driven dziedziczą ten model przez:
- env var
LLM_MODEL(lub specyficzny —PFIX_MODEL,AIDER_MODEL,REFACTOR_LLM_MODEL) - config plik tool'a (
pyqual.yaml,redsl.yaml,llx.yaml)
WYKRYWANIE (LLM-free): ROZWIĄZYWANIE (LLM): WALIDACJA (LLM-free):
regix [regression] llx [model router] ruff [linter]
redup [duplicates] pfix [error fix] pytest [tests]
prefact [LLM-aware lint] aider [interactive] regix [regressions]
testql [declarative scenarios] redsl [quality gate + vallm [tier-1 syntax]
planfile [ticket store] improve]
vallm/1 [syntax check] windsurf [primary IDE,
sumd [LLM snapshot for reuses agent LLM]
LLM agents]
op3 [multi-layer infra redeploy [markpact-based deploy:
observation] detect → plan → apply]
ORCHESTRATION (LLM-free):
goal [smart commits + versioning + changelog + release workflow]
doql [declarative IaC: app.doql.less → build/sync/drift]
costs [AI cost tracker per commit (badge w README.md)]
toonic [TOON format converter (LLM-optimized compact YAML)]
SPECIALIZED (LLM-free):
protogate [migration tool dla legacy systems (bounded slices)]
rebuild [code evolution intelligence (git history walker)]
mdflow [markdown dependency analyzer + Mermaid diagrams]
metrun [execution intelligence + bottleneck detection]
ON-CHANGE GATES TRIAD (LLM-free, continuous):
wup [intelligent file watcher → priority/full testql probes]
task quality:wup checks watcher config; wup watch runs the loop
+ regix (delta gate, see WALIDACJA above)
+ testql (HTTP probe, see WYKRYWANIE above)
→ koru brief surfaces all three in "On-change gates" section
→ /koru-gate slash command runs the triad on demand
→ see workflows/on-change-gates.md for the full cycle
ALTERNATIVES:
cursor [IDE alternative to Windsurf]
claude-code [CLI agent alternative]
| Tool | Wymaga API key? | Specyficzna config? | Folder |
|---|---|---|---|
| redsl | ✅ OPENROUTER_API_KEY | ✅ redsl.yaml |
redsl/ |
| llx | ✅ OPENROUTER_API_KEY | ✅ llx.yaml (tiers) |
llx/ |
| pfix | ✅ OPENROUTER_API_KEY | ✅ PFIX_* env |
pfix/ |
| vallm | optional (tier-2) | brak | vallm/ |
| prefact | optional (autonomous) | ✅ prefact.yaml |
prefact/ |
| aider | ✅ OPENROUTER_API_KEY | ✅ docker-compose | aider/ |
| planfile | optional (init) | ✅ planfile.yaml |
planfile/ |
| testql | brak | ✅ scenariusze YAML | testql/ |
| regix | brak | ✅ regix.yaml |
regix/ |
| wup | brak | ✅ wup.yaml (z koru template) |
wup/ |
| redup | brak | brak | redup/ |
| sumd/sumr | brak | brak (env vars) | sumd/ |
| redeploy | brak | ✅ markpact specs (*.md) |
redeploy/ |
| goal | optional (PYPI/NPM/GH tokens dla publish) | ✅ goal.yaml |
goal/ |
| doql | brak | ✅ app.doql.less |
doql/ |
| costs | brak | optional ([tool.costs] w pyproject.toml) |
costs/ |
| op3 | brak | brak (Pythonic API + CLI flags) | op3/ |
| toonic | brak | brak (CLI flags) | toonic/ |
| protogate | brak | optional (protogate.yaml) |
protogate/ |
| rebuild | brak | optional (reads pyqual.yaml) |
rebuild/ |
| mdflow | brak | brak (CLI flags) | mdflow/ |
| metrun | brak | brak (CLI flags) | metrun/ |
| windsurf | (subskrypcja IDE) | ✅ .windsurf/rules.md |
../windsurf-agent-guide.md |
| cursor | (subskrypcja IDE) | ✅ .cursorrules |
cursor/ |
| claude-code | ✅ ANTHROPIC_API_KEY | ✅ .claude/ |
claude-code/ |
# Z głównego katalogu c2004
for tool in redsl llx pfix vallm prefact planfile regix redup sumd redeploy goal doql costs op3 toonic protogate rebuild mdflow metrun testql aider; do
bash docs/llm-tools/$tool/install.sh
doneKażdy install.sh jest idempotentny — bezpiecznie uruchamiać wielokrotnie.
Te narzędzia nie są w repo "obok siebie". One tworzą wspólny workflow z dwoma trybami:
- Default path — ticket-driven development z agentem IDE (Windsurf/Cursor/Claude Code), bez zdalnych wywołań LLM.
- Opt-in automation lane — narzędzia LLM-backed (
redsl improve,llx,aider) do smoke-testów, jakościowej infrastruktury i headless auto-fixów, tylko gdy user explicite tego chce.
W praktyce wygląda to tak:
-
Wykrywanie
task monitor:probe, Prometheus ihealing-webhookwykrywają błędy i zapisują je jako tickety wplanfile.yaml. -
Rozwiązywanie
Agent IDE zaczyna od:task tickets:next
i pracuje według:
-
Walidacja
Przed zakończeniem patcha agent powinien przejść co najmniej:task quality:regix:local bash scripts/regix-precommit.sh task test -
Domknięcie
Po fixie ticket zamykamy:task tickets:done -- PLF-XXX
Default ticket-driven path jest stabilniejszy niż opt-in automation lane. Jeśli problem wychodzi w:
task quality:improvetask monitor:test-healhealing-webhook+redsl_improve
to najpierw traktuj to jako problem infrastruktury refaktoryzacji (compose / webhook / quality stack), a nie jako błąd produktu.
Jeśli LLM ma zacząć pracę w c2004, najkrótsza sensowna ścieżka wygląda tak:
task tickets:next
task tickets:show -- PLF-XXX
task quality:regix:local
task monitor:probeNajważniejsze dokumenty:
../windsurf-agent-guide.md../../.windsurf/rules.md../planfile-llm-guide.mdredsl/README.md— jeśli ticket dotyczy OpenRouter automation lane lubtask quality:improve
Każdy plik README.md w podfolderze ma 7 sekcji:
- Co to jest — 1-zdaniowy opis
- Kiedy używać — konkretne scenariusze
- Konfiguracja — env vars, config plik, sample
- Komendy — najczęściej używane
- Integracja z c2004 — gdzie jest podpięte (Taskfile, pre-commit, healing-webhook)
- Troubleshooting — typowe problemy
- Linki — repo, dokumentacja
Patrz SESSION-2026-05-09-summary.md
sekcja 5b — w razie zmiany modelu domyślnego, edycja w 10 plikach:
# Quick check current model:
grep -h "^LLM_MODEL=" .env
grep "deepseek-v4-pro" .env .env.example */.\env* docker-compose.quality.yml \
llx.yaml pyqual.yaml .aider/docker-compose.yml 2>/dev/null