Referencja kontroli @wondelai/harness-audit
EN@wondelai/harness-audit ocenia repozytorium deterministycznie w sześciu ważonych stanowiskach fabryki oprogramowania — Intencji, Harnessie, Pętli, Grafie, Weryfikacji i Wydaniu — i mapuje zebrane dowody na Drabinę Autonomii Dana Shapiro (Poziom 0–5). Każda poniższa kontrola działa lokalnie bez wysyłania danych i prowadzi do trwałego wzorca w tym kanonie.
Deweloperzy, tech leadzi i CTO korzystają z tej referencji, aby sprawdzić, dlaczego repozytorium zatrzymało się na określonym suficie poziomu autonomii, jakie konkretne artefakty odblokowują kolejny szczebel i jak zamienić wyniki skanu w bramki CI. Szczegółową instrukcję uruchamiania, opcjonalnego wywiadu i promptów naprawczych znajdziesz w przewodniku po @wondelai/harness-audit.
Stanowisko 1 — Intencja (Intent)
Dział zatytułowany „Stanowisko 1 — Intencja (Intent)”Ocenia, czy repozytorium daje każdemu agentowi kodującemu zwięzły, niezduplikowany kontekst oraz dyscyplinę specyfikacji przed rozpoczęciem edycji.
| Obszar kontroli | Co spełnia standard | Przewodnik |
|---|---|---|
| Plik instrukcji w korzeniu | AGENTS.md (lub odpowiednik) zawiera realne granice repo i komendy weryfikacji | AGENTS.md i zwięzły kontekst |
| Jedno źródło prawdy | CLAUDE.md odwołuje się do @AGENTS.md zamiast duplikować treść polityk | Wspólne reguły zespołu |
| Budżet długości instrukcji | Plik główny jest zwięzły (≤ 150 linii) bez ogólnego wypełniacza i powielonego boilerplate’u | Oczyszczanie plików kontekstu |
| Reguły zakresowe i skille | Reguły przypisane do ścieżek (.claude/rules/, .cursor/rules/*.mdc) oraz przenośne skille SKILL.md | Skille agentów |
| Artefakty specyfikacji | Szablony PR/zgłoszeń lub struktura specyfikacji i planu zapisująca kryteria przed kodem | Spec-driven development |
Stanowisko 2 — Harness
Dział zatytułowany „Stanowisko 2 — Harness”Ocenia, czy granice uprawnień, hooki cyklu życia, integracje MCP i ochrona sekretów są wymuszane mechanicznie przez środowisko zamiast prośbą w prompcie.
| Obszar kontroli | Co spełnia standard | Przewodnik |
|---|---|---|
| Uprawnienia i sandbox | Jawna polityka uprawnień i sandboxa (wykrywa wycofane reguły jak untrusted w Codexie) | Uprawnienia i sandboxing |
| Hooki cyklu życia | Deterministyczne hooki PreToolUse, PostToolUse lub Stop z ochroną przed pętlą (stop_hook_active) | Hooki agentów |
| Higiena MCP | Brak zarchiwizowanych lub zmyślonych pakietów, martwych endpointów /sse i tokenów w plain-text | Model Context Protocol |
| Ochrona sekretów | .env i .dev.vars w .gitignore, obecny .env.example, zero wycieków poświadczeń w konfiguracji | Tożsamość agentów i sekrety |
Stanowisko 3 — Pętla (Loop)
Dział zatytułowany „Stanowisko 3 — Pętla (Loop)”Ocenia, czy agent potrafi szybko i powtarzalnie zweryfikować własne zmiany jednym deterministycznym poleceniem.
| Obszar kontroli | Co spełnia standard | Przewodnik |
|---|---|---|
| Weryfikacja jednym poleceniem | Zunifikowana komenda check / verify / test + lint + typecheck działająca lokalnie i w CI | Repozytorium gotowe na agentów |
| Ścisłe typowanie statyczne | Włączony tryb ścisły TypeScript lub odpowiednik statycznej analizy typów dla całego kodu | Testowanie i weryfikacja |
| Szybki linter i formater | Skonfigurowany deterministyczny linter i formater z nieinteraktywnym trybem sprawdzania w CI | Pętla informacji zwrotnej |
| Powtarzalność środowiska | Zacommitowany lockfile oraz przypięta wersja runtime zgodna z CI | Repozytorium gotowe na agentów |
Stanowisko 4 — Graf (Graph)
Dział zatytułowany „Stanowisko 4 — Graf (Graph)”Ocenia, czy równolegli agenci mogą wykonywać niezależne zadania bez kolizji gałęzi, portów, baz danych i lokalnego stanu.
| Obszar kontroli | Co spełnia standard | Przewodnik |
|---|---|---|
| Izolacja worktree | Skrypt zarządzania worktree lub konfiguracja .worktreeinclude izolująca checkout na zadanie | Git worktrees |
| Izolacja portów i stanu | Niezależne porty lokalne dla każdego worktree oraz odizolowany stan bazy i cache | Środowiska efemeryczne |
| Podagenci i przepływy | Wyspecjalizowani podagenci tylko do odczytu lub w worktree (.claude/agents/, [agents] w Codexie) | Wzorce orkiestracji |
Stanowisko 5 — Weryfikacja (Verification)
Dział zatytułowany „Stanowisko 5 — Weryfikacja (Verification)”Ocenia, czy zautomatyzowane wyrocznie są wystarczająco silne, aby recenzenci mogli oceniać dowody zamiast czytać każdą wygenerowaną linię.
| Obszar kontroli | Co spełnia standard | Przewodnik |
|---|---|---|
| Testy jednostkowe i E2E | Rzeczywiste testy jednostkowe i end-to-end weryfikujące kontrakty zachowania | Siła wyroczni |
| Ochrona wyroczni | CODEOWNERS lub reguły CI chroniące testy, bramki i workflow przed cichym osłabieniem | Ochrona wyroczni |
| Jakość testów | Niska liczba .skip/.only, zero tautologicznych asercji, minimalne wyciszenia lintera i typów | Wykrywanie kodu pozornego |
| Automatyczne PR review | Skonfigurowany Bugbot (.cursor/BUGBOT.md), review Claude/Codex albo bramki automatycznego review | Code review PR agenta |
| Funkcje dopasowania | Automatyczne bramki warstw architektury, rozmiaru paczki, zależności i bezpieczeństwa | Funkcje dopasowania architektury |
Stanowisko 6 — Wydanie (Release)
Dział zatytułowany „Stanowisko 6 — Wydanie (Release)”Ocenia, czy scalone zmiany agentów trafiają na produkcję bezpiecznie, z audytowalnym pakietem dowodów i gotowością do rollbacku.
| Obszar kontroli | Co spełnia standard | Przewodnik |
|---|---|---|
| Bramki CI na PR | Wymagany automatyczny lint, typecheck i testy uruchamiane dla każdego pull requesta | Wdrażanie i bramki produkcji |
| Szablon PR z dowodami | Lista kontrolna wymagająca wyników weryfikacji, klasy ryzyka, wrażliwych ścieżek i planu rollbacku | Pakiet dowodów |
| Zależności i obserwowalność | Automatyczna weryfikacja zależności oraz śledzenie błędów i strukturalna telemetria produkcji | Zdrowie bazy kodu agentów |
Jak wagi stanowisk i twarde sufity zapobiegają zawyżonym ocenom
Dział zatytułowany „Jak wagi stanowisk i twarde sufity zapobiegają zawyżonym ocenom”Ważone punkty pokazują szerokość pokrycia, natomiast twarde sufity poziomów pilnują fundamentów architektury. Repozytorium z dopracowanym AGENTS.md i zestawem skilli nadal zatrzymuje się na Poziomie 2, jeśli brakuje w nim deterministycznych testów i wymaganych bramek CI:
| Poziom Autonomii | Wymagane minimalne dowody w stanowiskach |
|---|---|
| Poziom 1–2 | Plik instrukcji w korzeniu oraz powtarzalne komendy budowania i testów |
| Poziom 3 | Jedno źródło instrukcji, szybka lokalna pętla weryfikacji, jawne uprawnienia i bramki CI na PR |
| Poziom 4 | Silne stanowisko Weryfikacja (realne testy, ochrona wyroczni, automatyczne PR review) oraz izolacja Grafu |
| Poziom 5 | Pełne pokrycie sześciu stanowisk, w tym pakiety dowodów, funkcje dopasowania i obserwowalność wydań |
Jak zweryfikować repozytorium i wymusić próg w CI
Dział zatytułowany „Jak zweryfikować repozytorium i wymusić próg w CI”Uruchom skaner lokalnie (dodając --lang pl dla raportu po polsku), aby przejrzeć wszystkie niezdane kontrole, a następnie podepnij tryb CI w pull requestach, aby poziom harnessu stale rósł:
npx @wondelai/harness-auditnpx @wondelai/harness-audit --ci --min-score 65Przekaż --deep, gdy potrzebujesz jakościowej oceny stosunku sygnału do szumu w instrukcjach i siły wyroczni testowej przez lokalne CLI claude lub codex; domyślny skan deterministyczny nie wysyła żadnego kodu poza maszynę. Aktualne schematy konfiguracji dla wykrytych braków sprawdzisz w oficjalnej dokumentacji Claude Code, OpenAI Codex, Cursora, Agent Skills i MCP.
Gdy kontrole audytu zgłaszają fałszywe alarmy lub uparte sufity
Dział zatytułowany „Gdy kontrole audytu zgłaszają fałszywe alarmy lub uparte sufity”- Monorepo uzyskuje niższą ocenę niż pojedyncze pakiety. Uruchomienie skanera w katalogu nadrzędnym bez skryptów głównych pomija zestawy testów w podpakietach. Odzyskanie: uruchamiaj audyt w katalogu każdej aktywnej usługi albo dodaj zunifikowany skrypt weryfikacji w korzeniu.
- Wycofane klucze polityk oblewają Stanowisko 2, mimo że lokalna sesja wydaje się działać. Starsze ustawienia, jak
approval_policy = "untrusted"w Codexie czy plik.cursorrules, zawodzą po cichu albo wykładają nowsze runnery. Odzyskanie: przejdź na aktywnesandbox_mode+approval_policy(on-request,never,granular) lub.cursor/rules/*.mdczgodnie z oficjalną dokumentacją. - Wysoka liczba testów nadal wywołuje ostrzeżenia w Stanowisku 5. Zestawy wypchane tautologicznymi asercjami, znacznikami
.skipalbo szerokimi wyciszeniami typów nie dowodzą zachowania. Odzyskanie: oceń testy według siły wyroczni i zablokuj ścieżki testów wCODEOWNERS. - Kontrole przechodzą na jednym laptopie, ale padają w CI. Ustawienia na poziomie użytkownika (
~/.claude/,~/.codex/) nie przenoszą się na runnery CI ani maszyny chmurowe. Odzyskanie: zacommituj wspólne uprawnienia, hooki, reguły i.mcp.jsonbezpośrednio w repozytorium.
Kolejne kroki z katalogu kontroli
Dział zatytułowany „Kolejne kroki z katalogu kontroli”Czy ten artykuł Ci pomógł?
Jedno kliknięcie, bez logowania.
Co z tym zrobisz?
Jak się czytało?
Co przeszkadzało? Możesz zaznaczyć kilka
Twoja rola?
Dzięki. Czytam każdą odpowiedź. Michał Jaskólski
Pomógł Ci ten artykuł?
Każde to jedno kliknięcie. Zamknij, kiedy chcesz.
bez logowania