Problem
Bądźmy szczerzy: nie chcemy już czytać kodu. Nie chcemy sprawdzać wszystkiego, co robią agenci, ani trzymać w głowie każdego technicznego szczegółu projektu.
Ale jeśli nikt nie kontroluje agentów, zamienią każdy projekt w niemożliwy do utrzymania chaos, którego nie rozplącze ani człowiek, ani agent. To tylko kwestia czasu.
Idea
HUMAN-INTENT.md to jeden plik w katalogu głównym repozytorium. Zawiera twój zamysł: architekturę projektu, zasady rozwoju i decyzje produktowe.
To nie jest dokumentacja kodu. To prawo, któremu kod musi się podporządkować.
Zasady
-
Piszesz go ty — i tylko ty
Agenci nigdy nie edytują tego pliku. Każda linia w nim to decyzja podjęta przez człowieka.
-
Jego instrukcje są prawem dla agenta
To, co mówi HUMAN-INTENT.md, jest ważniejsze od wszystkiego innego. Jeśli kod przeczy plikowi — to kod się myli.
-
Określa architekturę, zasady i produkt
Zamysł, nie przepisy. Agent i tak zna wszystkie wzorce; twoim zadaniem jest ustalić, co ma obowiązywać — i dlaczego.
Dlaczego to działa
Za agentami nie da się nadążyć: kodu powstaje więcej, niż ktokolwiek chce przeczytać. Kontrolowanie każdej linii jest beznadziejne. Kontrolowanie zamysłu — realne.
HUMAN-INTENT.md przenosi kontrolę poziom wyżej: pilnujesz jednego pliku ze swoimi decyzjami zamiast tysięcy linii kodu. Dopóki plik jest prawem, projekt rozwija się według twojego zamysłu — nawet jeśli nikt nie czyta kodu.
Jak zacząć
- Utwórz HUMAN-INTENT.md w katalogu głównym repozytorium.
- Zapisz decyzje, które już podjąłeś: architektura, zasady rozwoju, produkt.
- Powiedz agentowi, by czytał ten plik i traktował go jak prawo — odwołaj się do niego w AGENTS.md lub CLAUDE.md.
- Każdą nową decyzję dopisuj do pliku. Nigdy nie pozwól agentowi w nim pisać.
- Rób review tego pliku, nie kodu.