WhyKit, open source
Zachowaj decyzję. I powód, który za nią stoi.
Za miesiąc wciąż wiesz, dlaczego. WhyKit łączy źródła, dowody i decyzje w zwykłych plikach Markdown. Twój zespół i agenci AI wracają do uzasadnienia, zamiast odtwarzać je z rozmów.
git clone https://github.com/CometWeb-io/whykit.git Podgląd kodu, bez wydania Licencja Apache-2.0 Python 3.11+ i uv, bez zależności runtime
Co robi
Co ustaliliśmy. I dlaczego.
Decyzja bez źródeł szybko staje się opinią. WhyKit zachowuje drogę od materiału źródłowego do dowodu, wyboru i kolejnego przeglądu.
E-001
Wniosek ma swój adres.
Powiąż twierdzenie z dowodem i źródłem. Oddziel sprawdzony fakt od założenia, żeby kolejna osoba albo agent wiedzieli, na czym mogą się oprzeć.
- Czytelne pliki Markdown
- Odwołania do konkretnych dowodów
- Jawne założenia i brakujące informacje
D-001, D-004
Historia zachowuje uzasadnienie.
Przyjętej decyzji nie poprawiasz po cichu. Gdy okoliczności się zmieniają, zapisujesz nową decyzję i wskazujesz, którą zastępuje.
- Powiązanie poprzedniej i nowej decyzji
- Odrzucone opcje obok wybranego rozwiązania
- Kontrola zmian w CLI i CI
review_by
Wróć do decyzji, zanim się zestarzeje.
Pole review_by wskazuje termin ponownej oceny. Linter zgłasza zaległe przeglądy i problemy struktury, więc rejestr zostaje w użyciu.
- Termin przeglądu przy decyzji
- Raport zaległych przeglądów
- Sprawdzenie lokalne albo w CI
Jak działa
Od pustego katalogu do sprawdzonego rejestru.
- Utwórz rejestr whykit init zakłada katalog z szablonem i plikiem AGENTS.md obok repozytorium.
- Dodaj dowód Źródło dostaje stały identyfikator E-NNN w rejestrze dowodów.
- Zapisz decyzję Decyzja D-NNN wskazuje swoje source_ids i termin review_by.
- Sprawdź strukturę whykit lint działa tak samo na twoim komputerze i w CI.
Instalacja
Uruchom z checkoutu.
Do pierwszego wydania instalujesz WhyKit z kopii repozytorium. Rejestr powstaje obok kodu, więc prywatne notatki nie trafiają do repozytorium WhyKit.
- Python 3.11 lub nowszy
- uv do synchronizacji środowiska
- Git z pełną historią dla kontroli zmian
git clone https://github.com/CometWeb-io/whykit.git
cd whykit
uv sync --locked
uv run whykit init ../my-ledger
uv run whykit lint --root ../my-ledgerSprawdź swój rejestr.
uv run whykit lint --root ../my-ledgerGranice
Linter sprawdza strukturę. Ty oceniasz dowody.
Nowy rejestr ma zero błędów, a ostrzeżenia wskazują pytania w AGENTS.md, na które odpowiadasz przed pracą z agentami.
- Sprawdza strukturę i powiązania, prawdziwość źródeł oceniasz ty
- Brak wydania na GitHub i PyPI, instalacja z checkoutu
- Kontrola historii wymaga pełnej historii Git
Kod i dokumentacja
Wszystko jest w repozytorium.
Tak, z publicznego repozytorium na GitHub. To podgląd kodu: nie ma jeszcze wydania ani pakietu na PyPI, więc instalujesz go z checkoutu przez uv.
W plikach Markdown w twoim rejestrze. Historia zmian korzysta z Git. WhyKit nie wymaga hostowanej bazy danych.
Działa obok nich. WhyKit porządkuje źródła, dowody i decyzje w czytelnych plikach, z których korzysta agent, a wyszukiwanie wektorowe i historia czatu zostają w innych narzędziach.
Od analizy strony
do działania.
CometWeb Insight sprawdza pięć obszarów jakości, ustala priorytety poprawek i testuje stronę ponownie po wdrożeniu.