Modele dryfują, kiedy piszą w repo na ślepo. Mapy strukturalne dają sesji punkty orientacyjne, zanim agent ruszy plik.
§ 01 · PROBLEM OBSERWACJE 2024–2026 FIG. 01
Aplikacje po agentach wyglądają na kompletne.
Auth, dane, płatności i deploy są wciąż kruche .
Po pierwszym użytkowniku często okazuje się, że demo to nie produkt. Prawda wychodzi przy pierwszej instalacji na innym OS, pierwszym Stripe webhook'u, pierwszym security review albo nowym koledze w zespole — to oni pokazują, czego żaden prompt nie wziął na siebie.
Security review
Aplikacja działa. Auth ma dwie role: admin i user — ale w prod chodzi siedem profili, których nikt nie zmapował. Tokeny żyją gdzie popadnie: czasem w localStorage, czasem w cookie HTTP-only, czasem w obu naraz. Pierwsza rzecz na audycie: nikt nie wie, kto ma dostęp do czego. Druga: kiedy ktoś wyleci z zespołu, klucze zostają.
Ścieżka pieniędzy
Stripe działa. Dopóki nie przestanie. Webhook się wywala raz — nie ma retry, nie ma dead letter queue, nie ma alertu. Klient zauważa brakującą usługę szybciej niż system. Founder dowiaduje się z Discorda support, nie z dashboardu.
§ 02 · INŻYNIERIA AKSJOMATY · METODA FIG. 02 · DWG VC-002
Mniej magii
Więcej pracy, którą da się obejrzeć .
Słownictwo żyje tylko wtedy, kiedy system zostaje inspekowalny: kontekst przed edycją, dowód po runie i powierzchnia release, która sama mówi, co nadal jest niepewne.
Każde generowanie kodu to szum. Pętla Marbles przerabia ten szum: małe pętle, kontrprzykłady i widoczna praca nierozwiązana.
Rzemieślnicza współpraca człowieka i AI. Rzemiosło jest w handoffie: ludzie trzymają scope, smak i decyzje nieodwracalne; agenci robią fieldwork z dowodem przyczepionym do pracy.
§ 03 · ZMIANA VIBE → PRODUKT FIG. 03 · DWG VC-003
Większość sesji AI zostawia fragmenty.
Vibecrafted nadaje pracy współrzędne..
Bez planszy
Kontekst paruje.
Następna sesja może odziedziczyć diff, ale nie wie, po co. Repo ma zmiany; praca nie ma pamięci.
Retry staje się metodą.
Zielony build zaczyna wyglądać jak dowód. Sygnał jest, ale to nie wystarcza, żeby wiedzieć, czy produkt jest bezpieczny.
Done zostaje mgliste.
Artefakty zbierają się w komentarzach, branchach, notatkach i screenshotach. Kolejny agent widzi części, ale nie widzi kształtu.
Z planszą
Kontrakt jest widoczny.
Zakres, owner, dowód i następny ruch siedzą na tej samej powierzchni, zanim agent zacznie ciąć.
Ślad przeżywa sesję.
Raporty i artefakty zostają przy repo, więc następna sesja może iść od dowodu, a nie od nastroju.
Konwergencję da się obejrzeć.
Plansza nie ogłasza zwycięstwa. Pokazuje, co wylądowało, co się przesunęło i co nadal prosi o decyzję.
05 FAZY
06 OPERATORZY
01 PLANSZE
00 UTRACONY KONTEKST
§ 04 · FRAMEWORK SCAFFOLD → RELEASE FIG. 04 · DWG VC-004
Nie rewrite. Sprint stabilizacji
Znajdź słabe szwy i je domknij .
Vibecrafted zostawia momentum z kodu pisanego przez AI i dokłada brakującą dyscyplinę release: mapę repo, następne cięcie, prawdę runtime i dowód dla kolejnej sesji.
01
Scaffold
przygotuj powierzchnię
02
Craft
kształtuj z agentami
03
Convergence
domknij nierozwiązane
04
DoU
znajdź to, co nadal niedokończone
05
Release
wypuść dla obcych użytkowników
%%{init: {
"theme": "base",
"themeVariables": {
"background": "#07111f",
"primaryColor": "#0c1626",
"primaryTextColor": "#f3efe7",
"primaryBorderColor": "#2d3b56",
"lineColor": "#d8894b",
"secondaryColor": "#101b2d",
"tertiaryColor": "#0d1728",
"fontFamily": "Inter, ui-sans-serif, system-ui, sans-serif",
"fontSize": "16px"
},
"flowchart": {
"curve": "basis",
"htmlLabels": true,
"nodeSpacing": 32,
"rankSpacing": 46,
"padding": 14
}
} }%%
flowchart LR
A["Scaffold"] --> B["Init"]
B --> C["Workflow"]
C --> D["Follow-up"]
D --> E{{"Pętla Marbles"}}
E --> F["DoU"]
F --> G["Decorate"]
G --> H["Hydrate"]
H --> I["Release"]
classDef stage fill:#0d1728,stroke:#31415d,color:#f3efe7,stroke-width:1.3px;
classDef core fill:#1a1110,stroke:#d8894b,color:#ffd9bd,stroke-width:2.2px;
class A,B,C,D,F,G,H,I stage;
class E core;Jak działa pass .
Każdy workflow ma jedno zadanie. Przeczytać repo, zrobić cięcie, sprawdzić realną ścieżkę albo nazwać to, co nadal nie jest gotowe. Nazwy przychodzą później; dowód pierwszy.
OP · 00 loctree · STRUKTURA OP · 01 aicx · PAMIĘĆ OP · 02 prview · REVIEW OP · 03 ScreenScribe · RUNTIME OP · 04 DoU · GATE OP · 05 Review · DOMKNIĘCIE
Otwórz Playground § 05 · OPERATOR INSTALUJ · URUCHOM · OBSERWUJ FIG. 05 · DWG VC-005
Zainstaluj lokalnie
Niech każdy run zostawia ślad .
KROK 01
$ curl -fsSL vibecrafted.io/install.sh | bash Jeden lokalny bootstrap. Instaluje komendy i otwiera prowadzony launcher. KROK 02
$ vibecrafted doctor Szybki health check, zanim agenci dotkną repo. KROK 03
$ vibecrafted init claude Pierwszy przelot kontekstowy realnym agentem w realnym repo. Repo dostaje wspólną powierzchnię .
Sesja może się skończyć, ale nie musi zniknąć. Następny agent może odziedziczyć raporty, decyzje i otwarte pytania zamiast zimnego promptu.
- Stan ma miejsce. Artefakty żyją pod $VIBECRAFTED_ROOT/. Nie w pamięci taba, który akurat był otwarty.
- Runy zostawiają dowód. Każdy run agenta zostawia prompt, raport, metadane i decyzję, którą miał uzasadnić.
- Undone zostaje widoczne. DoU i marbles trzymają nierozwiązane kawałki na planszy, aż ktoś zdecyduje, co znaczą.
N# FAZA MARBLES POKRYCIE % STAN
00 scaffold 04 100 SKONWERGOWANE
01 craft 12 078 AKTYWNE
02 convergence 07 042 AKTYWNE
03 doU 03 000 CZEKA
04 release 00 000 BLOKADA
Fig. 04a — Stan planszy zaobserwowany o t=14:04:48, po sześciu rzutach przez fazy 00-02.
NAWYKI OPERATORA JEDNO REPO, JEDNA POWIERZCHNIAKONTRAKT PRZED PROMPTEMDOWÓD PONAD NASTRÓJNIEROZWIĄZANE ZOSTAJE WIDOCZNE
§ 06 · SZYBKI START INIT → SHIP · 6 RZUTÓW FIG. 06 · DWG VC-006
Zacznij od pierwszego użytecznego sygnału .
§ 07 · ŹRÓDŁA BADANIA · NOTATKI FIG. 07 · DWG VC-007
Co czytaliśmy, zanim zbudowaliśmy .
Framework konwergencji jest syntezą badań o handoffach agentów, gate'ach release i kontraktach runtime. Źródła poniżej — sprawdź przed adopcją.
REF · 01 The Mythical Man-Month. Addison-Wesley, 1975 Pierwotna obserwacja była prosta: dorzucenie większej siły bez koordynacji nie przyspiesza pracy, tylko ją pogarsza. W vibecrafted. odpowiedzią na ten problem jest konwergencja, czyli systemowe domykanie wariancji zamiast dokładania kolejnego chaosu. REF · 02 A Philosophy of Software Design. Yaknyam Press, 2018 Głębokie moduły są lepsze niż płytkie API, bo niosą większą sprawczość przy mniejszym narzucie. W vibecrafted. ta zasada wraca w operatorach: każdy ma jeden ostry protokół, a nie tysiąc luźnych promptów. REF · 03 Model Cards for Model Reporting. FAccT 2019 Zanim system trafi do ludzi, trzeba jasno opisać, co potrafi, a czego nie. DoU robi podobną robotę dla buildu: nie ocenia tylko tego, czy działa, ale też czy da się go znaleźć, zrozumieć i sensownie wypuścić. REF · 04 Datasheets for Datasets. Communications of the ACM, 2021 Każdy zbiór danych powinien mieć zdefiniowane pochodzenie, zakres możliwości i ograniczenia — jeszcze zanim ktokolwiek zacznie go używać. Board w vibecrafted. wymaga tego samego od każdego rzutu: kontrakt deklarujesz przed kodem, nie po nim. REF · 05 On the Dangers of Stochastic Parrots. FAccT 2021 Sama skala nie produkuje rozumienia — płynność powierzchniowa bez ugruntowania w rzeczywistości to nie jest produkt, który się wypuszcza. Konwergencja istnieje właśnie po to, żeby odróżnić jedno od drugiego. REF · 06 The Hardware Lottery. Communications of the ACM, 2021 To, jaki masz runtime i środowisko wykonania, decyduje o tym, które pomysły mają szansę przetrwać. System konwergencji potrzebuje przewidywalnego podłoża, nie tylko sprytnych promptów.
§ 08 · DOWODY Z TERENU · ZAOBSERWOWANE WZORCE FIG. 08 · DWG VC-008
Vibe hangover w terenie .
Parę notatek z terenu — z produktów budowanych z agentami i z naszych własnych torów release. Anonimowo, bo wzorzec mówi więcej niż nazwa.
PATTERN · 01 RELEASE MIRROR
Dwa checkouty, dwie prawdy.
Framework w upstreamie już naprawiliśmy, ale publiczny landing nadal pokazywał starą wersję installera. Każdy miał rację w swoim checkoutcie; użytkownik widział dryf.
FIELD NOTE · publiczny tor release PATTERN · 02 HELPER DRIFT
Runtime się przeniósł. Docs nie.
Główny runtime naprawiliśmy. Helper script trzymał wczorajsze założenia o ścieżkach. Produkt działał, dopóki operator nie poszedł starym tropem.
FIELD NOTE · audyt powierzchni helperów PATTERN · 03 SILENT FAILURES
Webhook, który nigdy nie spróbował drugi raz.
Checkout wyglądał zdrowo. Dopóki aktywacja nie weszła w fazę claim i webhook truth. Sprzedaż się wydarzyła; historia entitlementu nadal potrzebowała świadka.
ZAOBSERWOWANE · realny founder (zanonimizowane) PATTERN · 04 DEPLOY AND PRAY
Piątkowa migracja odpalona cztery razy.
Brak stagingu, brak smoke testów, brak rollbacku. Migracja zakleszcza się na lock table. Zgłoszenia od supportu rosną, a founder próbuje sobie przypomnieć, który tab odpalił komendę ostatni.
ZAOBSERWOWANE · raporty z terenu