Architektura ekosystemu

Skribly to warsztat pracy w modelu local-first, dla ludzi i agentów programujących. Daje im jeden tracker, jeden wygląd i jeden uczciwy zapis pracy; na start nie trzeba konta, a nic nie opuszcza Twojego komputera, dopóki tego nie wyślesz. Stan na 8 listopada 2026 r.

• Najpierw lokalnie, bez konta. Skribly Agent działa na Twoim komputerze, bez konta i bez telemetrii.
• Dowolny agent. Działa z agentami programującymi, których już używasz, na Twoich własnych logowaniach i przez otwarte standardy.
• Zadanie żyje w Twoim repozytorium. Zgłoszenie z Jira, Redmine, GitHub, GitLab, Linear lub Skribly Tracker staje się plikami TASK.md i STATE.md w repozytorium, więc każde narzędzie może je przeczytać.
• Tracker stworzony dla agentów. W Skribly Tracker agent pracuje nad zgłoszeniem jako delegat, a właścicielem pozostaje człowiek.
• Twój styl, Twoja historia. Commity trzymają się stylu repozytorium i nigdy nie dostają stopek współautorstwa AI.
• Twoje dane mogą wyjść. Plan jest taki, że każda aplikacja eksportuje wszystkie swoje dane w otwartych formatach, a żadna funkcja nie działa wyłącznie z hostowanym serwerem Skribly.

Skribly Tracker            Skribly Agent                     Agenci programujący
(lub Jira, Redmine,       gałąź lub worktree,       start   Claude Code, Codex,
 GitHub, GitLab,  zadanie▶ TASK.md i STATE.md,     ──────▶  Cursor Agent, Gemini CLI
 Linear)                   sesja agenta                      i dziewięć kolejnych
      ▲                                                            │
      │ komentarz, status, czas                     reguły         │ zmiany
      │                                     agent-skills ─────────▶│
      │                                     testy, przeglądy,      ▼
      └──────────────────────────────────── audyty, commity   Przeglądasz diff
                                                              i wyniki audytów

1. Planowanie. Zadanie zaczyna się w Skribly Tracker albo trafia z Jira, Redmine, GitHub, GitLab lub Linear.
2. Start. Jedna akcja w Skribly Agent tworzy gałąź, zapisuje zadanie w .skribly/tasks/<KEY>/TASK.md i uruchamia agenta z gotowym promptem.
3. Praca agentów. Każdy może działać we własnym worktree, a aplikacja pokazuje, kto pracuje, czeka lub skończył.
4. Reguły. Testy, przeglądy, audyty i styl commitów pochodzą z jednej biblioteki skilli, agent-skills.
5. Przegląd. Czytasz zmiany oraz wyniki audytów bezpieczeństwa, WCAG i SEO.
6. Zamknięcie. Akceptujesz commit i dodajesz do zadania komentarz oraz zarejestrowany czas.

agent-skills do działania nie potrzebuje niczego więcej: to samodzielna biblioteka dla dowolnego repozytorium i każdego z ośmiu obsługiwanych agentów. Skribly Agent współpracuje z trackerami innymi niż Skribly Tracker, a API Skribly Tracker działa z dowolnym klientem HTTP.

Aplikacje nigdy nie importują się nawzajem. Rozmawiają przez HTTP, a kształt wysyłanych danych jest zdefiniowany raz w @skribly/core.

• @skribly/core łączy wszystko. Zawiera kontrakty używane przez aplikacje: schematy API Trackera v1, klienta Trackera, podpisywanie i weryfikację webhooków, błędy problem+json (RFC 9457), konfigurację środowiska, logi i tłumaczenia. Od wersji 0.2.0 definiuje też poniższe wspólne elementy jako schematy i helpery: tożsamość i zakresy, envelope CloudEvents, manifesty aplikacji, powiadomienia, dziennik audytu i profil projektu. Aplikacje nie korzystają jeszcze z większości z nich.
• @skribly/ui daje jeden wygląd. Trzy warstwy: tokeny projektowe, zwykłe klasy CSS dla dowolnej strony i komponenty React oparte na React Aria, które dbają o obsługę klawiatury i czytników ekranu. Późniejsza zmiana frameworka wymieni tylko górną warstwę. Ta witryna korzysta z tokenów i zwykłych klas.

To są projekty, nie funkcje, z których można dziś korzystać w aplikacjach. Gdy @skribly/core 0.2.0 już definiuje kształty, mówi o tym kolumna Stan; schemat we wspólnym pakiecie nie jest jeszcze funkcją aplikacji.

Wspólny stos planowany dla każdej aplikacji, stan na 8 listopada 2026 r.:

Skribly Agent działa już na Electron, React i Vite. @skribly/core, @skribly/ui i ta witryna działają na Node.js 26. Skribly Tracker jest przepisywany na ten stos.

1. Najpierw lokalnie; konto służy do dzielenia się, nigdy nie jest bramką.
2. Otwarte standardy zamiast zamkniętych systemów wtyczek.
3. Odpowiedzialność pozostaje po stronie człowieka. Agenci są zawsze oznaczeni jako agenci, zatrzymują się na polecenie i nigdy po cichu nie rejestrują czasu ani nie wysyłają kodu.
4. Czas wynika z pracy, nigdy z obserwowania ludzi.
5. Zadanie znajduje się w repozytorium.
6. Jedna tożsamość, jedna powłoka, jedna paleta, jedna skrzynka, jeden wygląd.
7. Dane można wyeksportować w otwartych formatach.
8. Publiczne deklaracje są weryfikowane i opatrzone datą.

• Skribly Agent nie wysyła telemetrii. Gdy aplikacja cokolwiek wysyła, mówi, co i dokąd. Zobacz Bezpieczeństwo.
• Skribly nie będzie oferować zrzutów ekranu, zliczania naciśnięć klawiszy ani ocen produktywności ludzi.
• Celem jest WCAG 2.2 AA, a tam, gdzie to możliwe, AAA. Narzędzia automatyczne nie udowodnią pełnej zgodności, więc każde oświadczenie mówi, co sprawdzono ręcznie. Oświadczenie o dostępności nie jest deklaracją zgodności. Zobacz Dostępność.