Modele psują się szybciej, kiedy piszą w repo na ślepo. Mapy strukturalne dają sesji punkty orientacyjne, zanim zacznie edytować.
§ 01 · PROBLEM OBSERWACJE 2024–2026 FIG. 01
Aplikacje po agentach wyglądają na gotowe
gdy auth, dane, płatności i deploy nadal są kruche .
Generowanie kodu dowozi demo. Prawdziwi użytkownicy, pieniądze, security review i kolejny developer pokazują miejsca, których żaden prompt nie wziął na własność.
Security review
Aplikacja działa, ale auth ma tylko admin/user, tokeny żyją w złym miejscu i nikt nie umie pokazać, kto może dotknąć których danych.
Ścieżka pieniędzy
Stripe działa, aż przestaje. Webhook crashuje raz, nie ma retry, a klient znajduje brakującą usługę szybciej niż system.
§ 02 · INŻYNIERIA AKSJOMATY · METODA FIG. 02 · DWG VC-002
Mniej magii
Więcej pracy, którą da się obejrzeć .
Słownictwo może być żywe, jeśli system pozostaje inspekowalny: kontekst przed edycją, dowód po runie i powierzchnia release, która mówi, co nadal jest niepewne.
Generowanie kodu jest szumne. Pętla Marbles daje temu szumowi miejsce: małe pętle, kontrprzykłady i widoczną pracę nierozwiązaną.
Ustrukturyzowana 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 powód stojący za zmianą. Repo ma zmiany; praca nie ma pamięci.
Retry staje się metodą.
Przejście kompilacji zaczyna wyglądać jak dowód. To użyteczny sygnał, tylko 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 może nieść prompt, raport, metadane i decyzję, którą miał wesprzeć.
- 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 .
Kilka field notes z produktów budowanych z agentami i z naszych własnych torów release. Anonimizowane, bo ważniejszy jest wzorzec niż nazwa.
PATTERN · 01 RELEASE MIRROR
Dwa checkouty, dwie prawdy.
Framework upstream był już naprawiony, ale publiczny landing nadal serwował starszą prawdę installera. Każdy miał rację w swoim checkoutcie; użytkownik widział dryf.
FIELD NOTE · reprezentacyjny tor release PATTERN · 02 HELPER DRIFT
Runtime się przeniósł. Docs nie.
Helper script nadal trzymał wczorajsze założenia o ścieżkach po tym, jak główny runtime został naprawiony. 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ł ponownie.
Checkout wyglądał zdrowo, dopóki aktywacja nie przeszła w 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. Support tickets rosną, a founder próbuje pamiętać, który tab odpalił się ostatni.
ZAOBSERWOWANE · raporty z terenu