Zanim oddasz projekt AI agentowi – potrzebujesz planu, którego oboje się trzymacie

Przyznaajmy się szczerze: większość z nas wciąż planuje projekty tak samo jak przed erą AI agentów. Szybka notatka, może dokument w Notion, wątek na Slacku, który rozrasta się w nieskończoność. Potem wręczamy ten niedopracowany plan agentowi kodującemu i liczymy na cuda.

Problem nie polega na tym, że AI agenty źle piszą kod. Chodzi o to, że potrzebują struktury, której rzadko im dostarczamy – a kiedy wypełniają te luki samodzielnie, nie mamy żadnego zapisu, dlaczego podjęto konkretne decyzje.

Dokument, który prowadzi dialog

Tu właśnie wkracza inplan. To w gruncie rzeczy edytor Markdown stworzony do wspólnego planowania między ludźmi a agentami AI. Wyobraź sobie wspólną tablicę, na której obie strony mogą tworzyć szkice, zadawać pytania i modyfikować jeden dokument planu.

Ale prawdziwa magia tkwi w systemie komentarzy. Zaznaczasz dowolne zdanie i możesz rozpocząć dyskusję wątkową przypiętą dokładnie do tego miejsca. Pytasz agenta, dlaczego zaproponował taką architekturę. Prosisz o wyjaśnienie jakiegoś założenia. Podejmujesz decyzję. Cała ta wymiana zostaje przypięta do konkretnej linijki – i zostaje tam na dobre.

To rozwiązuje problem, o którym rzadko się mówi: archeologię kontekstową. Przewiń trzy miesiące do przodu. Agent podjął jakąś decyzję. Gdzie jest tok rozumowania? Inplan sprawia, że staje się to śledzialne.

Przegląd przed rewizją

Widuję to zbyt często: zostawiasz agenta AI, wracasz po jakimś czasie, a plan cicho się zmienił. Może jest lepszy. Może coś kluczowego zostało zmienione. Trudno powiedzieć.

Inplan odwraca tę sytuację. Kiedy agent chce zmodyfikować plan, nie nadpisuje cicho dokumentu – generuje diff, który sam przeglądasz i aplikujesz. Widzisz dokładnie, co się zmieniło. Możesz zatwierdzić, odrzucić lub dostosować, zanim cokolwiek zostanie zablokowane.

Ten human-in-the-loop ma większe znaczenie, niż mogłoby się wydawać. Zamienia agenta z wykonawcy w collaboratora z pełną dokumentacją.

Pierwsze kroki

Narzędzie instaluje się jako skill dla Claude Code (wsparcie dla Codex i innych jest w planach). Proste "plan X" otwiera edytor i można działać. To AGPL-3.0 open-source, działa całkowicie lokalnie przez npm.

Dla zespołów potrzebujących współpracy na żywo, dostępna jest wersja hostowana na inplan.ai. Nic w demo nie wymaga zakładania konta – miłe zaskoczenie jak na SaaS.

Gdzie jeszcze kuje

Żadko narzędzie nie jest idealne. Obecna wersja to aplikacja Electron – działa, ale cięższa niż edytor webowy. Mechanizm diff działa linia po linii, co może być zbyt grube dla drobnych zmian. Model zakłada jeden dokument planu na raz. Jeśli zarządzasz wieloma powiązanymi specyfikacjami, będziesz musiał sięgać po dodatkowe narzędzia.

Zespół jest transparentny co do tych ograniczeń, co napawa optymizmem. Wsparcie dla wielu dokumentów i bogatsze pętle interakcji z agentem są na roadmapie.

Dlaczego to ma znaczenie w erze vibe codingu

"Vibe coding" – czyli zlecanie AI implementacji podczas gdy ty określasz wizję – zyskuje na popularności. Ale vibe coding ma brudny sekret: bez jasnego kierunku, weryfikujesz efekty względem intencji, których nigdy w pełni nie sprecyzowałeś.

Narzędzia takie jak inplan sugerują inną przyszłość. Nie "koduj szybciej", ale "myśl jaśniej". Faza planowania staje się prawdziwą współpracą z partnerem AI, tworząc artefakty przydatne zarówno dla bieżącego zadania, jak i dla przyszłych opiekunów kodu (włącznie z tobą za kilka miesięcy).

To, czy inplan stanie się częścią twojego workflow, zależy od twojej tolerancji dla aplikacji Electron i modelu jednego dokumentu naraz. Ale underlying concept – ustrukturyzowana, komentowalna, przez człowieka recenzowana współpraca z AI – wskazuje kierunek, w którym będziemy podążać, gdy agenci kodujący staną się jeszcze zdolniejsi.

Pytanie nie brzmi, czy AI napisze większą część naszego kodu. Pytanie brzmi, czy zbudujemy rusztowanie, które sprawi, że ten kod będzie naprawdę zrozumiały.

Wypróbuj: npm i -g inplan