# Audyt harnessu agentowego z @wondelai/harness-audit

URL: https://developertoolkit.ai/pl/workflows/harness/harness-audit-guide/
Description: Zmierz repozytorium lokalnie w sześciu stanowiskach fabryki oprogramowania z @wondelai/harness-audit — oceny Poziomu 0–5, prompty naprawcze i bramki CI.

`@wondelai/harness-audit` to otwarte narzędzie CLI, które ocenia dowolne repozytorium w skali Poziomu 0–5 w sześciu stanowiskach fabryki oprogramowania — Intencji, Harnessie, Pętli, Grafie, Weryfikacji i Wydaniu — analizując zacommitowane pliki, bramki CI, wyrocznie testowe i konfiguracje agentów lokalnie w mniej niż dwie sekundy. Programiści, tech leadzi i CTO używają go, by zastąpić subiektywną samoocenę mierzalnymi dowodami z repozytorium.

Większość zespołów przeszacowuje swój poziom autonomii, ponieważ ankiety badają intencje zamiast realnego stanu Gita. Tech lead może być przekonany o szczelności zabezpieczeń, podczas gdy `CLAUDE.md` przekroczył 400 linii, `.codex/config.toml` wciąż zawiera wycofaną politykę `untrusted`, a CI w żaden sposób nie chroni plików testowych przed osłabianiem przez agentów.

## Co mierzy automatyczny audyt harnessu

Subiektywne formularze zapisują to, jak zespół chciałby pracować. `@wondelai/harness-audit` czyta dokładnie to środowisko, które zastają Claude Code, Codex i Cursor na starcie sesji, mapując wyniki na Drabinę Autonomii Dana Shapiro (styczeń 2026) oraz [sześć stanowisk fabryki oprogramowania](/pl/ladder/one-map/):

| Stanowisko | Co weryfikują deterministyczne kontrole repozytorium | Przewodnik w kanonie |
| --- | --- | --- |
| **1. Intencja** | Zwięzły `AGENTS.md` (≤ 150 linii), cienkie `@AGENTS.md` w `CLAUDE.md`, reguły ścieżkowe, skille i szablony PR/specyfikacji | [AGENTS.md i kontekst](/pl/workflows/context/agents-md-context/) |
| **2. Harness** | Jawna polityka uprawnień i sandboksa (wykrywanie wycofanego `untrusted` w Codexie), hooki z `stop_hook_active`, higiena MCP i ochrona sekretów | [Uprawnienia i sandboksy](/pl/workflows/harness/permissions-and-sandboxing/) · [Hooki agentów](/pl/workflows/harness/agent-hooks/) |
| **3. Pętla** | Jedna komenda weryfikacji (`lint`, `typecheck`, `test`, `build`), ścisłe typowanie, deterministyczny formatter i zacommitowany lockfile | [Repozytorium gotowe na agentów](/pl/workflows/harness/agent-ready-codebase/) |
| **4. Graf** | Skrypty worktree lub `.worktreeinclude`, izolacja portów i stanu oraz definicje subagentów zakresowych | [Worktree Gita](/pl/workflows/harness/git-worktrees/) · [Środowiska efemeryczne](/pl/workflows/harness/ephemeral-environments/) |
| **5. Weryfikacja** | Prawdziwe testy jednostkowe i E2E, ochrona wyroczni w `CODEOWNERS`/CI, niski poziom `.skip` i wyciszeń, automatyczne PR review (np. `.cursor/BUGBOT.md`), funkcje dopasowania | [Siła wyroczni](/pl/workflows/test/oracle-strength/) · [Ochrona wyroczni](/pl/workflows/test/protect-the-oracle/) |
| **6. Wydanie** | Bramki CI na PR, szablon pakietu dowodów, automatyzacja zależności oraz obserwowalność błędów na produkcji | [Pakiet dowodów](/pl/workflows/ship/evidence-bundle/) · [Zdrowie bazy kodu](/pl/workflows/operate/codebase-health/) |

Pełny katalog kontroli znajdziesz w [referencji kontroli harness-audit](/pl/reference/harness-audit-checks/).

## Dlaczego twarde progi poziomów blokują zawyżone oceny

Repozytorium z wzorowym `AGENTS.md` i dwudziestoma skillami — ale bez testów, ochrony wyroczni i bramek CI — nadal działa na Poziomie 2. Zwykła średnia punktów ukryłaby tę lukę, dlatego `@wondelai/harness-audit` egzekwuje twarde ograniczenia poziomów:

| Deklarowany poziom | Minimalny dowód wymagany w repozytorium |
| --- | --- |
| **Poziom 1–2** | Podstawowy plik instrukcji i powtarzalne komendy budowania/testów |
| **Poziom 3** | Jedno źródło instrukcji, deterministyczna pętla weryfikacji, jawna polityka uprawnień i bramki CI |
| **Poziom 4** | Silna Weryfikacja (prawdziwe testy, ochrona wyroczni, automatyczne PR review) oraz izolacja Grafu |
| **Poziom 5** | Pełne pokrycie sześciu stanowisk wraz z pakietami dowodów, funkcjami dopasowania architektury i obserwowalnością |

Twarde progi czynią audyt wiarygodnym narzędziem dla CTO i zespołów platformowych porównujących dziesiątki repozytoriów: wysoki wynik w Intencji nie zamaskuje niechronionej wyroczni ani braku sandboksa.

## Uruchom audyt i zamykaj luki krok po kroku

1. **Uruchom bezkonfiguracyjny skan lokalny.** Wykonaj w katalogu głównym repozytorium — bez kluczy API, bez wywołań sieciowych i bez wysyłania kodu:

   ```bash
   npx @wondelai/harness-audit --lang pl
   ```

2. **Uchwyć sygnały procesowe niewidoczne w plikach.** Dodaj opcjonalny, 7-pytaniowy wywiad terminalowy o adopcji w zespole, wieku kolejki PR i kontroli kosztów:

   ```bash
   npx @wondelai/harness-audit --interview --role lead --lang pl
   ```

3. **Wygeneruj prompt naprawczy albo podejrzyj minimalny szkielet.** Eksportuj instrukcję naprawczą dopasowaną do repozytorium dla Claude Code, Codexa lub Cursora — albo sprawdź bezinwazyjny szkielet przed zapisem plików:

   ```bash
   npx @wondelai/harness-audit --prompt --lang pl --out HARNESS-FIX-PROMPT.md
   npx @wondelai/harness-audit init --dry-run
   ```

4. **Udostępnij raport i włącz bramkę regresji w CI.** Wygeneruj samodzielny raport HTML dla liderów i dodaj sprawdzenie w CI, aby wynik harnessu nie spadał w kolejnych pull requestach:

   ```bash
   npx @wondelai/harness-audit --format html --lang pl --out harness-report.html
   npx @wondelai/harness-audit --ci --min-score 65
   ```

**Opcjonalna głęboka analiza jakościowa (--deep)**

Statyczny skan plików nie oceni, czy testy sprawdzają prawdziwe zachowanie ani jaki jest stosunek sygnału do szumu w instrukcjach. Flaga `--deep` uruchamia opcjonalny przegląd jakościowy z użyciem lokalnego CLI `claude` lub `codex` (albo własnego klucza API). Bez tej flagi narzędzie działa całkowicie offline.

## Zweryfikuj, że poprawki z audytu naprawdę podniosły bezpieczeństwo

Wyższy wynik liczy się dopiero wtedy, gdy dodane mechanizmy zatrzymują realne defekty. Łącz każdy PR wynikający z audytu z trzema sprawdzeniami:

- **Ponowny skan deterministyczny w CI:** potwierdź, że `--ci --min-score` przechodzi bez zaniżania progów i że zdjęto blokujący limit poziomu na naprawianym stanowisku.
- **Żywe próby kanarkowe:** samo istnienie pliku hooka lub sekcji sandbox spełnia kontrolę statyczną; udowodnij realną odmowę przez [przypadki testowe hooków](/pl/workflows/harness/agent-hooks/), [test kanarkowy sandboksa](/pl/workflows/harness/permissions-and-sandboxing/) i [kanarek defektów repozytorium](/pl/workflows/harness/agent-ready-codebase/).
- **Śledzenie wyników w wielu repozytoriach:** archiwizuj cykliczne raporty HTML lub JSON dla kluczowych serwisów, aby liderzy techniczni mierzyli realny postęp strukturalny zamiast samej objętości wygenerowanego kodu ([ramy metryk](/pl/org/metrics-frameworks/)).

## Kiedy audyty harnessu wprowadzają w błąd

- **Zespoły nabijają wynik pustymi szablonami.** Dodanie ogólnikowego `AGENTS.md`, atrap hooków czy tautologicznych testów odhacza kontrolki statyczne bez poprawy bezpieczeństwa. Łącz skany statyczne z `--deep`, [wykrywaniem slopu](/pl/workflows/test/slop-detection/) oraz testami kanarkowymi.
- **Inżynierowie szlifują mocne stanowiska, ignorując limity poziomów.** Podniesienie Intencji z 85 do 95 nie odblokuje organizacji zatrzymanej na Poziomie 2 przez słabą Weryfikację. Najpierw domykaj najniżej ocenione stanowisko blokujące.
- **Uruchamianie `init` bez przeglądu obecnych plików.** Zawsze podglądaj zmiany przez `npx @wondelai/harness-audit init --dry-run`, aby szkielet był spójny z istniejącym `AGENTS.md`, menedżerem pakietów i układem CI.
- **Traktowanie jednego audytu jako stałego certyfikatu.** Konwencje narzędzi, modele i potoki CI zmieniają się co kwartał. Utrzymuj `--ci --min-score` w workflow PR i podnoś próg po większych wdrożeniach.

## Strona narzędzia, książki i wsparcie zespołowe

Sprawdź interaktywny opis na [`/pl/harness-audit/`](/pl/harness-audit/), poznaj otwarte wydania książkowe na [`/pl/books/`](/pl/books/), a bieżącą składnię poprawek sprawdzaj w oficjalnej dokumentacji: [Claude Code](https://code.claude.com/docs), [OpenAI Codex](https://developers.openai.com/codex), [Cursor](https://cursor.com/docs), [Agent Skills](https://agentskills.io) oraz [MCP](https://modelcontextprotocol.io).

- [Referencja kontroli harness-audit](/pl/reference/harness-audit-checks/) — Przejrzyj wszystkie deterministyczne kontrole oceniane w sześciu stanowiskach fabryki.
- [Interaktywna strona harness-audit](/pl/harness-audit/) — Sprawdź opcje CLI, przykładowy wynik i wagi stanowisk.
- [Przycinanie plików kontekstu](/pl/workflows/context/pruning-context-files/) — Napraw przerośnięte lub zduplikowane instrukcje wykryte w Stanowisku 1.
- [Diagnostyka repozytorium i Dzień pracy z zespołem](/pl/services/) — Wsparcie praktyczne przy wdrażaniu harnessu w wielu repozytoriach i wyrównaniu standardów.
