# Referencja kontroli @wondelai/harness-audit

URL: https://developertoolkit.ai/pl/reference/harness-audit-checks/
Description: Katalog sześciu stanowisk fabryki oprogramowania, deterministycznych kontroli repozytorium i progów poziomów ocenianych przez @wondelai/harness-audit.

`@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](/pl/workflows/harness/harness-audit-guide/).

## 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](/pl/workflows/context/agents-md-context/) |
| Jedno źródło prawdy | `CLAUDE.md` odwołuje się do `@AGENTS.md` zamiast duplikować treść polityk | [Wspólne reguły zespołu](/pl/teams/adopt/team-collaboration/) |
| 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](/pl/workflows/context/pruning-context-files/) |
| 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](/pl/ecosystem/skills/) |
| Artefakty specyfikacji | Szablony PR/zgłoszeń lub struktura specyfikacji i planu zapisująca kryteria przed kodem | [Spec-driven development](/pl/workflows/plan/spec-driven-development/) |

## 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](/pl/workflows/harness/permissions-and-sandboxing/) |
| Hooki cyklu życia | Deterministyczne hooki `PreToolUse`, `PostToolUse` lub `Stop` z ochroną przed pętlą (`stop_hook_active`) | [Hooki agentów](/pl/workflows/harness/agent-hooks/) |
| Higiena MCP | Brak zarchiwizowanych lub zmyślonych pakietów, martwych endpointów `/sse` i tokenów w plain-text | [Model Context Protocol](/pl/ecosystem/mcp/) |
| 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](/pl/org/agent-identity-and-secrets/) |

## 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](/pl/workflows/harness/agent-ready-codebase/) |
| Ścisłe typowanie statyczne | Włączony tryb ścisły TypeScript lub odpowiednik statycznej analizy typów dla całego kodu | [Testowanie i weryfikacja](/pl/workflows/test/) |
| Szybki linter i formater | Skonfigurowany deterministyczny linter i formater z nieinteraktywnym trybem sprawdzania w CI | [Pętla informacji zwrotnej](/pl/method/lifecycle/test/) |
| Powtarzalność środowiska | Zacommitowany lockfile oraz przypięta wersja runtime zgodna z CI | [Repozytorium gotowe na agentów](/pl/workflows/harness/agent-ready-codebase/) |

## 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](/pl/workflows/harness/git-worktrees/) |
| Izolacja portów i stanu | Niezależne porty lokalne dla każdego worktree oraz odizolowany stan bazy i cache | [Środowiska efemeryczne](/pl/workflows/harness/ephemeral-environments/) |
| Podagenci i przepływy | Wyspecjalizowani podagenci tylko do odczytu lub w worktree (`.claude/agents/`, `[agents]` w Codexie) | [Wzorce orkiestracji](/pl/workflows/automate/orchestration-patterns/) |

## 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](/pl/workflows/test/oracle-strength/) |
| Ochrona wyroczni | `CODEOWNERS` lub reguły CI chroniące testy, bramki i workflow przed cichym osłabieniem | [Ochrona wyroczni](/pl/workflows/test/protect-the-oracle/) |
| Jakość testów | Niska liczba `.skip`/`.only`, zero tautologicznych asercji, minimalne wyciszenia lintera i typów | [Wykrywanie kodu pozornego](/pl/workflows/test/slop-detection/) |
| Automatyczne PR review | Skonfigurowany Bugbot (`.cursor/BUGBOT.md`), review Claude/Codex albo bramki automatycznego review | [Code review PR agenta](/pl/workflows/ship/agent-pr-review/) |
| Funkcje dopasowania | Automatyczne bramki warstw architektury, rozmiaru paczki, zależności i bezpieczeństwa | [Funkcje dopasowania architektury](/pl/workflows/test/fitness-functions/) |

## 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](/pl/method/lifecycle/deploy/) |
| Szablon PR z dowodami | Lista kontrolna wymagająca wyników weryfikacji, klasy ryzyka, wrażliwych ścieżek i planu rollbacku | [Pakiet dowodów](/pl/workflows/ship/evidence-bundle/) |
| Zależności i obserwowalność | Automatyczna weryfikacja zależności oraz śledzenie błędów i strukturalna telemetria produkcji | [Zdrowie bazy kodu agentów](/pl/workflows/operate/codebase-health/) |

## 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

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ł:

```bash
npx @wondelai/harness-audit
npx @wondelai/harness-audit --ci --min-score 65
```

Przekaż `--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](https://code.claude.com/docs), [OpenAI Codex](https://developers.openai.com/codex), [Cursora](https://cursor.com/docs), [Agent Skills](https://agentskills.io) i [MCP](https://modelcontextprotocol.io).

**Interaktywny podgląd audytu**

Przejrzyj wszystkie sześć stanowisk i skopiuj gotowe komendy na stronie [`/pl/harness-audit/`](/pl/harness-audit/).

## 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 aktywne `sandbox_mode` + `approval_policy` (`on-request`, `never`, `granular`) lub `.cursor/rules/*.mdc` zgodnie z oficjalną dokumentacją.
- **Wysoka liczba testów nadal wywołuje ostrzeżenia w Stanowisku 5.** Zestawy wypchane tautologicznymi asercjami, znacznikami `.skip` albo szerokimi wyciszeniami typów nie dowodzą zachowania. Odzyskanie: oceń testy według [siły wyroczni](/pl/workflows/test/oracle-strength/) i zablokuj ścieżki testów w `CODEOWNERS`.
- **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.json` bezpośrednio w repozytorium.

## Kolejne kroki z katalogu kontroli

- [Przewodnik po @wondelai/harness-audit](/pl/workflows/harness/harness-audit-guide/) — Uruchom CLI, skorzystaj z 7-pytaniowego wywiadu i wygeneruj dopasowany prompt naprawczy.
- [Jedna mapa: poziomy i etapy](/pl/ladder/one-map/) — Zobacz, jak sześć stanowisk łączy się z Drabiną Autonomii Dana Shapiro.
- [Interaktywna strona audytu](/pl/harness-audit/) — Uruchom npx @wondelai/harness-audit --lang pl i zobacz punktację stanowisk.
- [Diagnostyka repo i dzień warsztatowy](/pl/services/) — Audyt o stałym zakresie i praktyczne wdrożenie usprawnień w zespołach wielorepozytoryjnych.
