router-first-architecture

Router-First Architecture to wzorzec organizacji umiejętności Claude'a, który automatycznie kieruje Twoje zapytania przez dedykowane routery domenowe zamiast bezpośrednio do poszczególnych narzędzi. Routery mapują intencje użytkownika na dokładne komendy, zapewniając determiniczne i niezawodne wybory. Architektura dwuwarstwowa łączy warstwę triggera (słowa kluczowe, wzorce intencji) z warstwą routingu (mapowanie regex), co eliminuje duplikowanie logiki i zmusza do konsekwentnego przepływu przez domenowe routery zamiast obchodzenia ich.

1. Zainstaluj umiejętność router-first-architecture w swoim katalogu Claude'a, upewniając się, że masz dostęp do pliku skill-rules.json oraz do routerów domenowych (np. math-router).

2. Skonfiguruj co-aktivację w pliku skill-rules.json dla każdej umiejętności domenowej, dodając sekcję coActivate wskazującą na odpowiedni router — na przykład dla umiejętności matematycznych dodaj "coActivate": ["math-router"] z trybem "always".

3. Gdy chcesz wykonać operację w danej domenie, zawsze najpierw wywołaj router z zapytaniem użytkownika — na przykład dla matematyki użyj komendy math-router route "twoje zapytanie", zamiast bezpośrednio wywoływać poszczególne skrypty.

4. Zaufaj wynikom routera, zwłaszcza jego ocenie pewności (confidence score) — router zwróci dokładną komendę do wykonania lub null jeśli nie znalazł dopasowania.

5. Jeśli router zwróci null (brak dopasowania), tylko wtedy rozważ obejście routera lub ręczne wybranie narzędzia, ale staraj się tego unikać — zamiast tego rozszerz wzorce triggera w skill-rules.json, aby lepiej pokrywały intencje użytkownika.

6. Utrzymuj wzorce triggera w skill-rules.json szersze niż wzorce routingu — router powinien gracefully obsługiwać przypadki, które nie pasują do żadnego wariantu, a trigger layer powinien nudować Claude'a do użycia routera dla szerszego zakresu zapytań.