Umetna inteligenca ne popravi zmedenega razmišljanja. Pospeši ga.
Veliki jezikovni model (LLM) vam na nejasno idejo odgovori nejasno. Dajte mu dobro strukturiran dokument z jasno terminologijo, zamejenimi problemi in sledenimi vrzelmi, pa postane najbolj produktiven sodelavec, s kakršnim ste kdaj delali.
Ozko grlo leta 2026 ni pisanje kode. Umetna inteligenca piše kodo hitro. Ozko grlo je vedeti, kaj graditi, in to znati izraziti dovolj jasno, da lahko to izvedejo ljudje in umetna inteligenca.
Ta zapis predstavlja okvir za prav to. Ne gre za orodja umetne inteligence. Gre za to, kako organizirate svoje misli, da postane vsak zapleten problem obvladljiv.
Dream → Concrete → Divide → Gaps → Fix → Realize → Share
↑ |
└───────────────── feedback loop ────────────────────┘Vsaka faza preoblikuje vaše razmišljanje. Vsaka ustvari izdelek. Takole delujejo.
Imate idejo. Napol je izoblikovana, ambiciozna in v sedanji obliki verjetno nerealna. To je v redu.
Umetni inteligenci povejte, karkoli vam roji po glavi, tudi samo en stavek, in naj ustvari dokument sanj. Ta je zasnovan kot hrepenenje, ne kot natančen načrt. Bistvo je, da idejo spravite iz glave v dokument, kjer jo vidite, se nanjo odzovete in jo začnete oblikovati.
Primer poziva:
I want to build an AI-powered medical diagnosis platform
that helps doctors catch rare diseases earlier. A patient
describes symptoms, the system triages, suggests possible
diagnoses, and routes to the right specialist.
Generate a dream document with:
- The vision (what does this look like when it's done?)
- Current landscape (what exists today and what's missing?)
- Key concepts I'll need to define
- Open questionsKaj dobite:
Strukturiran dokument sanj. Morda dve ali tri strani. Zajame vaš namen, zariše krajino (UpToDate, Isabel Healthcare, Ada Health: kaj počnejo dobro in kje zaostajajo) ter odpre vprašanja, na katera še niste pomislili. »Kaj pomeni ›prej odkriti‹? Hitrejše triažiranje? Boljša diferencialna diagnoza? Opozarjanje na vzorce v bolnikovi zgodovini?«
Svojih misli vam ni bilo treba najprej urediti, prvi krog je opravila umetna inteligenca. Zdaj imate nekaj, na kar se lahko odzovete.
Dokument sanj ni načrt. Je kompas. Pove vam smer, ne korakov.
Izdelek: dreams/ai-diagnosis-platform.md
Zdaj sanje spremenite v konkreten referenčni dokument. Je strukturiran, natančen in zamejen. Opredelite pojme. Narišite arhitekturo. Določite, kaj je vključeno in kaj ne.
Tu umetna inteligenca zasluži svoj kruh. Dajte ji dokument sanj:
Here's my dream doc: [paste].
Turn this into a concrete reference document with:
- Defined terms and concepts
- Architecture sections with clear boundaries
- Scope (what this covers, what it doesn't)
- Open questions marked as [GAP] placeholdersPrimer rezultata:
Kar se je začelo kot »Želim, da umetna inteligenca zdravnikom pomaga prej odkriti redke bolezni«, postane referenčni dokument, ki zajema:
Ta dokument je zdaj vaš edini vir resnice. Ne koda. Ne zgodovina klepeta. Ne čigav spomin. Dokument.
Izdelek: docs/Diagnosis_Platform.md
Vaš konkretni dokument postaja dolg. Nekateri razdelki so sami po sebi dolgi deset strani. To je znak, da je čas za razdelitev.
Konkretni dokument razbijte na osredotočene razdelitvene dokumente, od katerih je vsak dovolj poglobljen, da stoji sam, a povezan s celoto.
Here's my concrete doc: [paste].
Which sections are complex enough to deserve their own
focused document? For each, suggest a title and scope.Primer:
Referenčni dokument platforme za medicinsko diagnostiko se naravno razdeli na:
| Razdelitveni dokument | Zajema |
|---|---|
Symptom_Engine.md | potek vnosa, normalizacijo simptomov, razčlenjevanje v več jezikih |
Diagnosis_Model.md | diferencialno razvrščanje, pragove zaupanja, razložljivost |
Specialist_Routing.md | ujemanje specialnosti, stopnje nujnosti, poteke napotitev |
Patient_Records.md | povezavo z EHR, formate FHIR/HL7, hrambo podatkov |
Compliance.md | kontrole HIPAA, razvrstitev SaMD, revizijsko sled |
Clinical_UI.md | zdravnikovo nadzorno ploščo, vnos za bolnika, prilagajanje mobilnim napravam |
To niso le delitve znanja, to so vaši moduli kode. Vsak razdelitveni dokument se neposredno preslika v pravo enoto kode: mikrostoritev, paket v monorepozitoriju, modul v monolitu ali omejen kontekst (bounded context) v domensko vodenem načrtovanju. Dokument opisuje, kaj modul počne, koda to izvaja.
Division Doc → Code Module
─────────────────────────────────────────────
Symptom_Engine.md → packages/symptom-engine/
Diagnosis_Model.md → packages/diagnosis-model/
Specialist_Routing.md → packages/specialist-routing/
Patient_Records.md → packages/patient-records/
Compliance.md → packages/compliance/
Clinical_UI.md → apps/clinical-dashboard/Ko se dokumenti preslikajo v kodo, ustvarite kazalni dokument: eno samo datoteko v korenu projekta, ki vsak dokument poveže z njegovim modulom kode. Predstavljajte si ga kot kazalo vsebine celotnega sistema. Ko mora agent umetne inteligence (ali nov član ekipe) delati na usmerjanju, pogleda v kazalo, najde Specialist_Routing.md → packages/specialist-routing/ in ima poln kontekst, še preden se dotakne ene same vrstice kode.
## Project Index
| Working In | Primary Doc | Gaps |
|---|---|---|
| `packages/symptom-engine/` | [Symptom_Engine.md](docs/Symptom_Engine.md) | [Symptom_Engine_Gaps.md](docs/Symptom_Engine_Gaps.md) |
| `packages/diagnosis-model/` | [Diagnosis_Model.md](docs/Diagnosis_Model.md) | [Diagnosis_Model_Gaps.md](docs/Diagnosis_Model_Gaps.md) |
| `packages/specialist-routing/` | [Specialist_Routing.md](docs/Specialist_Routing.md) | [Specialist_Routing_Gaps.md](docs/Specialist_Routing_Gaps.md) |
| `packages/patient-records/` | [Patient_Records.md](docs/Patient_Records.md) | [Patient_Records_Gaps.md](docs/Patient_Records_Gaps.md) |
| `packages/compliance/` | [Compliance.md](docs/Compliance.md) | [Compliance_Gaps.md](docs/Compliance_Gaps.md) |
| `apps/clinical-dashboard/` | [Clinical_UI.md](docs/Clinical_UI.md) | [Clinical_UI_Gaps.md](docs/Clinical_UI_Gaps.md) |To kazalo postane najpomembnejša datoteka v repozitoriju. Je most med organiziranimi mislimi in organizirano kodo.
Izdelek: docs/DX_Symptom_Engine.md, docs/DX_Compliance.md + kazalo v korenskem CLAUDE.md
Tu okvir res zaživi. Ko imate konkretne in razdelitvene dokumente, vidite, kaj manjka.
Vrzeli niso neuspehi. So okvir, ki opravlja svoje delo. Ne morete videti, kaj manjka, dokler ne zapišete, kaj je.
Vrzeli sledite s kodami vrzeli: kratkimi oznakami, ki jih naredijo iskljive in omenljive:
### GAP-DX004: Model suggests diagnosis but doesn't explain reasoning
- **Phase**: Diagnosis output
- **Area**: Diagnosis model — result presentation layer
- **Impact**: Doctor sees "Possible: Lupus (82% confidence)"
but no explanation of which symptoms contributed or why
alternatives were ruled out. Doctor can't trust or verify
the suggestion. Useless in clinical practice.
- **Root Cause**: Model outputs a ranked list with scores
but no reasoning chain. Explainability was never specified
in the architecture — it was assumed to be a UI concern.
- **Fix**: Add an explainability module that maps each
diagnosis to contributing symptoms, relevant patient
history, and ruled-out alternatives. Display as
"evidence for / evidence against" in the clinical UI.
- **Priority**: Critical
- **Status**: OpenOblika kode vrzeli vam da:
| Polje | Namen |
|---|---|
| Koda (Code) | Iskljiva oznaka (GAP-DX004, GAP-C001) s predpono kategorije |
| Faza (Phase) | Kdaj se v sistemu pojavi |
| Področje (Area) | Kateri modul ali pojem je prizadet |
| Vpliv (Impact) | Kaj uporabniki doživijo, ko ta vrzel obstaja |
| Temeljni vzrok (Root Cause) | Zakaj vrzel obstaja: vzroki, ne simptomi |
| Popravek (Fix) | Predlagana rešitev (lahko je postopen načrt) |
| Prioriteta (Priority) | Kritična / Visoka / Srednja / Nizka |
| Stanje (Status) | Odprta / V delu / Popravljena (z datumom) |
Predpone kategorij ohranjajo vrzeli urejene: GAP-DX za diagnostiko, GAP-SE za modul simptomov, GAP-C za skladnost, GAP-UI za klinični vmesnik. Lastne kategorije boste razvili, ko bo vaš projekt rasel.
Izdelek: docs/DX_Diagnosis_Gaps.md
Popravite vrzeli. Ampak ne vseh naenkrat.
Vedno zahtevajte postopen načrt izvedbe. Vrzeli imajo odvisnosti. Nekatere so predpogoj za druge. Če poskušate popraviti vse hkrati, nastane kaos.
Here are my open gaps: [paste gap doc].
Here's the main concrete doc for context: [paste relevant section].
Create a phased implementation plan:
- Phase 1: Critical gaps that unblock other work
- Phase 2: High-priority gaps
- Phase 3: Medium-priority improvements
For each phase, estimate scope and list dependencies.Ko je vrzel popravljena:
Fixed (2026-02-22) in zapišite, kaj je bilo storjenoarchive/. Ne brišite jih. So zgodovina vašega razmišljanjaKonkretni dokument se razvija. Različica 1 je imela 20 vrzeli. Različica 2 jih 15 zapre in odkrije 5 novih. Različica 3 zapre te in dokument se umiri. To je konvergenca: vsak krog vas približa popolnemu in poštenemu opisu vašega sistema.
Izdelek: posodobljen docs/Diagnosis_Platform.md, arhiviran archive/gaps/DX_Diagnosis_Gaps_v1.md
Iz dokumentov zgradite prave stvari. Projekti so dokaz, da okvir deluje.
Vsak projekt preizkusi vaš okvir na resničnosti. Ko se kaj zalomi, je vprašanje: kateri dokument je napačen? Težava vodi nazaj do vrzeli v dokumentih, ne le do hrošča v kodi.
Primer:
Iz enega nabora dokumentov diagnostične platforme zgradite pilotne uvedbe: eno za urgentno ambulanto (hitra triaža, veliko bolnikov, pogosta stanja), eno za podeželsko bolnišnico (malo specialistov na kraju samem, usmerjanje v telemedicino) in eno za pediatrično prakso (starostno prilagojeno razlaganje simptomov, drugačne referenčne vrednosti).
Vsaka uvedba preizkusi dokumente na drugačni resničnosti. Ko je pilot v podeželski bolnišnici razkril, da je usmerjanje k specialistom predpostavljalo, da so specialisti v hiši, podeželske bolnišnice pa napotujejo k oddaljenim ponudnikom telemedicine z drugačnimi časovnimi okni razpoložljivosti, kode niste le zakrpali. Naredili ste naslednje:
GAP-SR002 v dokumentu vrzeli usmerjanjaSpecialist_Routing.mdZdaj urgentna ambulanta in pediatrična praksa samodejno obvladata usmerjanje v telemedicino. Vsak projekt izboljša dokumente. Vsaka izboljšava dokumentov naredi prihodnje projekte zanesljivejše.
Tu razdelitev izplača obresti na obresti. Ker ima vsak modul svoj samostojen dokument, lahko module poljubno kombinirate v povsem različnih projektih. Vsak projekt ne potrebuje vsakega modula. Novi projekti se sestavijo z izbiro razdelitvenih dokumentov, ki jih vključite.
| Projekt | Uporabljeni moduli |
|---|---|
| Triažni kiosk za urgentno ambulanto | Symptom_Engine + Clinical_UI |
| Podeželska telemedicinska platforma | Symptom_Engine + Diagnosis_Model + Specialist_Routing |
| Orodje za klinične raziskave | Diagnosis_Model + Patient_Records + Compliance |
| Aplikacija za samopreverjanje bolnikov | Symptom_Engine + Clinical_UI (podmnožica za bolnika) |
| Revizor skladnosti za bolnišnice | Compliance + Patient_Records |
Kiosk v urgentni ambulanti ne potrebuje celotnega diagnostičnega modela, potrebuje le hiter vnos simptomov in čist vmesnik za predajo zdravniku. Raziskovalno orodje ne potrebuje usmerjanja k specialistom, potrebuje poglobljene diagnostične podatke s skladnim dostopom do zapisov. Vsak projekt povleče module, ki jih potrebuje, dokumenti pa vam natančno povedo, kaj dobivate.
To je isto načelo kot za paketi v monorepozitoriju, sestavljanjem mikrostoritev ali celo cevmi v Unixu: majhne, dobro dokumentirane enote, ki se združijo v večje sisteme. Razlika je v tem, da se sestavljanje tu začne na ravni dokumentacije. O tem, kaj projekt potrebuje, odločate z branjem dokumentov, ne z branjem kode.
Izdelek: projects/urgent-care-pilot/, projects/rural-hospital-pilot/ itd.
Pišite o svojem postopku. Poučevanje vas prisili, da razumete, kaj ste dejansko naredili.
Zapisi na blogu, datoteke README, vodiči, notranji dokumenti: medij ni pomemben. Pomembno je, da svoj okvir razložite nekomu, ki nima vašega konteksta. Tako se razkrijejo predpostavke, za katere niste vedeli, da jih delate.
Deljenje tudi sklene krog. Zapis na blogu o vašem pristopu k razložljivosti diagnoz lahko bralca navdihne, da namesto ploskih seznamov dokazov predlaga vizualizacijo grafa simptomov. To postane nova sanja. Cikel se začne znova.
Izdelek: zapisi na blogu, vodiči, javna dokumentacija
Okvir je preprost:
Sanjajte ga → Zapišite ga → Razdelite ga → Poiščite, kaj manjka → Popravite ga → Zgradite ga → Delite ga.
V dobi umetne inteligence je organizirano mišljenje veščina z največjim vzvodom, ki jo lahko razvijete. Ne inženiring pozivov. Ne poznavanje, kateri model uporabiti. Temveč jasnost misli: sposobnost, da zmedeno idejo prečistite v nekaj dovolj natančnega, da to lahko izvedejo ljudje in umetna inteligenca.
Opomba o vzdrževanju: dokumenti uhajajo od stvarnosti. Koda se spreminja, API-ji se premikajo, odvisnosti se posodabljajo. Uhajanje obravnavajte kot še eno vrzel: občasno preglejte, dokumente posodobite, ko se spremeni koda, in stare različice arhivirajte namesto brisanja. Zgodovina vašega razmišljanja je enako vredna kot razmišljanje samo.