Dev notes 31.01.2026 #0003 Fumadocs

Lielā projektā pienāk brīdis, kad kods vairs nav lielākais izaicinājums. Sistēma strādā, arhitektūra ir pārdomāta, servisi sarunājas savā starpā, bet es pats sāku just bremzi. Ne tāpēc, ka kaut kas nestrādātu, bet tāpēc, ka viss sāk dzīvot manā galvā. Lēmumi, konteksts, “kāpēc tas ir tieši tā” — ja es to nepierakstu, tas pazūd vai jāizdomā no jauna.

Tieši šajā brīdī projektā ienāk Fumadocs.

Sākumā tas ir pragmatisks solis — beidzot sakārtot dokumentāciju. Bet ļoti ātri kļūst skaidrs, ka Fumadocs nav par dokumentiem. Tas ir par domāšanu. Kad arhitektūras lēmumi, plūsmas un robežas ir pierakstītas skaidrā, strukturētā veidā, galva atbrīvojas. Nav vairs jāatceras viss — sistēma sāk sevi paskaidrot.

Strādājot vienatnē pie liela projekta, Fumadocs kļūst par manu otro atmiņu. Ja pēc mēneša atgriežos pie kāda servisa vai funkcijas, man nav jārokas kodā, lai saprastu, ko es toreiz domāju. Atbilde jau ir dokumentācijā. Kāpēc šis risinājums? Kādi bija alternatīvie varianti? Kur šeit ir robežas? Tas viss ir fiksēts, nevis pazaudēts laikā.

Projektam augot, dokumentācija vairs nekļūst par nastu. Tā aug kopā ar sistēmu. Ja parādās jauna integrācija, jauns domēns vai sarežģītāks biznesa scenārijs, Fumadocs palīdz to ielikt vietā, saglabājot skaidru kopainu. Tas neļauj projektam pārvērsties par “vēsturisku artefaktu”, ko saprot tikai tā autors — pat ja tas autors esmu es pats.

Ir arī ļoti praktisks ieguvums: ātrums. Lēmumi tiek pieņemti pārliecinošāk, refaktoringi ir drošāki, jo konteksts nav jāatjauno no nulles. Un brīdī, kad projektam pievienosies vēl kāds cilvēks — izstrādātājs, klients vai partners — pamats jau būs gatavs. Nekas nav jāskaidro no jauna, nekas nav jāizvelk no atmiņas.

Ar laiku Fumadocs kļūst par kaut ko pašsaprotamu.

Tas ir kā arhitektūras mugurkauls projektam, kur komanda šobrīd esmu tikai es viens pats. Kluss, bet kritiski svarīgs. Bez tā projekts vēl varētu dzīvot, bet ar to tas kļūst stabils, pārskatāms un gatavs augšanai.

Un tad kļūst skaidrs — Fumadocs nav rīks komandām. Tas ir rīks cilvēkiem, kuri būvē nopietnus projektus. Pat ja tas cilvēks esi tu viens pats.