Mācekļa rokasgrāmata

Saturs

0 Lasi vienreiz · pirms MS1

Pamatu primer

Izlasi šo PIRMS pirmās dzīvās sesijas (MS1). Īss — domāts lasīt aukstā, vienā piegājienā. Mērķis: pāris mentālie modeļi un divas pamatprasmes, lai dzīvais laiks paiet darot, ne mācoties „kas ir LLM”. Katras nodaļas beigās ir ✓ Saprata, ja — ja to nevari izdarīt, apstājies un pārlasi, pirms ej tālāk.

0.0

Sprinta gatavība

Pirms pirmās sesijas visam zemāk jābūt vietā. Tā ir kontrolkartīte, ne teorija — pilno soli-pa-solim versiju ar saitēm atradīsi pielikumā A0.

Konti (visi bezmaksas izveidojami):

Claude — galvenais rīks. Vajag Pro abonementu (~$20/mēn), jo Claude Code tajā ir iekļauts; bezmaksas versijā tā nav.
GitHub — kur dzīvo tavs darbs un tā vēsture. Bezmaksas.
Cloudflare — kur tavu lapu padara dzīvu (deploy). Bezmaksas.

Nauda: reāli ~$20 mēnesī (Claude Pro). Hostings (Cloudflare, GitHub) sprinta apjomā ir bezmaksas. Pārsteiguma rēķins nav iespējams, kamēr tev nav atsevišķas maksas API atslēgas (piekļuves parole, kas ļauj programmai izmantot maksas servisu) — un sprintam tāda nav vajadzīga. Detaļas: pielikums A7.

Instalācijas: Claude Code (termināļa rīks) + Git. Precīzie soļi — A0.

Kur dzīvo noslēpumi: API atslēgas un paroles glabājas ārpus darba mapes, nekad failā, ko augšupielādē. Kāpēc — sadaļā 0.5.

„Dzīvs URL”: kad lapa ir deployota, tai ir interneta adrese (piem. tavs-projekts.pages.dev), ko var atvērt jebkurš. „Dzīvs” nozīmē — strādā internetā, ne tikai tavā datorā.

Laiks: rēķinies ar ~8–12 stundām nedēļā, apmēram 2 sesijas. Sprints ir īss un blīvs.

Ja setup neizdodas: neiestrēgsti viens pats — pieraksti, kas neizdevās (kļūdas teksts), un tas ir pirmais jautājums mentoringa sesijā. Biežākās kļūmes un labojumi — pielikums A5.

✓ Saprata, ja

visi konti izveidoti, rīki instalēti, zini mēneša izmaksas (~$20) un laika prasību pirms pirmās sesijas.

0.1

Tu esi režisors, ne rakstītājs

Šī ir galvenā domāšanas maiņa visā rokasgrāmatā.

Tu nerakstīsi kodu. Tu tikai aprakstīsi vēlamo, un aģents (Claude Code) to izdarīs tavā vietā. Tava loma ir kā režisoram — vai kā analītiķim, kurš dod uzdevumu jaunākajam kolēģim: tu zini mērķi un atpazīsti labu rezultātu, bet pats nesēdi pie katras koda rindas.

Tāpēc tavas galvenās prasmes šeit nebūs tehniskas, bet gan spēja:

skaidri aprakstīt nolūku — ko un kāpēc tu vēlies,
novērtēt rezultātu — vai aģenta paveiktais tiešām strādā pareizi.

Tev kā analītiķim tas jau ir pazīstams process. Tu taču proti pateikt: „Man vajag atskaiti, kas rāda X sadalījumā pa Y”, un pēc tam pārbaudīt, vai skaitļiem ir jēga. Šeit strādā tieši tā pati prasme, tikai tagad tavs kolēģis ir AI.

Vēlāk tu dzirdēsi tādus vārdus kā skills, plugins un context rot. Pagaidām tos droši ignorē — pie tiem atgriezīsimies tad, kad tie tev patiešām noderēs (attiecīgi pēc sprinta un MS4). Šobrīd pilnīgi pietiek atcerēties, ka tu esi režisors.

✓ Saprata, ja

vari saviem vārdiem pateikt, ka tavs darbs ir aprakstīt nolūku un pārbaudīt rezultātu, ne rakstīt kodu.

0.2

Kas ir LLM (un kas nav)

Aģenta „smadzenes” ir liels valodas modelis (LLM — large language model). Vienkāršā valodā — tas ir ļoti spēcīgs teksta paredzētājs. Modelis ir „izlasījis” milzum daudz teksta un iemācījies, kurš vārds visticamāk sekos nākamais. Tieši no šīs prasmes rodas pārsteidzošā spēja rakstīt kodu, skaidrot un plānot.

Taču te slēpjas kāds āķis: modelis ražo to, kas izklausās pareizi, ne vienmēr to, kas ir pareizi. Reizēm tas pārliecinoši pasaka nepareizu lietu — to mēs saucam par halucināciju. Teksts plūst gludi un skan droši neatkarīgi no faktu patiesuma. Tieši tāpēc skaista, pārliecināta atbilde nav pierādījums, ka tā ir pareiza.

Ko tas praktiski nozīmē tev kā režisoram? Vienmēr pārbaudi rezultātu — atver lapu, palaid programmu, paskaties uz izvadi. Neuzticies apgalvojumam „es to izdarīju”, bet gan tam, ko redzi savām acīm. (Šo pārbaudes soli iemācīsies sadaļā 0.6.)

Vēlāk ievērosi vēl kādu niansi: aģentam vienā sesijā ir ierobežota atmiņa, tas nevar paturēt prātā bezgalīgi daudz informācijas. Kāpēc tā notiek un kā ar to tikt galā, uzzināsi MS4.

✓ Saprata, ja

vari pateikt, kāpēc aģents var pārliecināti kļūdīties (un tāpēc rezultāts jāpārbauda).

0.3

Modeļi un domāšanas piepūle

Ir vairāki Claude modeļi. Tos vari uztvert kā kolēģus ar atšķirīgu ātrumu, zināšanu dziļumu un stundas likmi:

lielais, dziļais modelis (piemēram, Opus) — domā rūpīgāk, taču maksā dārgāk un strādā lēnāk → ideāli der sarežģītiem, knifīgiem uzdevumiem;
mazais, ātrais modelis (piemēram, Haiku) — zibensātrs un lēts, taču seklāks → noder vienkāršiem, rutīnas soļiem;
pa vidu atrodas Sonnet — lielisks balanss starp prātu un cenu, radīts ikdienas darbam.

Kā datu analītiķis tu noteikti sapratīsi šo pieeju. Ātrai skaitīšanai tu uzmet vienkāršu pivot-tabulu, bet knifīgai modelēšanai piesaisti pieredzējušu senioru.

Atsevišķi vari regulēt domāšanas piepūli — cik ilgi modelis apdomā situāciju, pirms dod atbildi. Lielāka piepūle prasa ilgāku laiku, toties rezultāts ir pamatīgāks. Tas līdzinās situācijai, kad lūdz kolēģim atbildēt uzreiz vai iedod laiku padomāt pusstundu.

Iesācēja likums: Claude Code jau startē ar spēcīgu modeli un saprātīgu noklusējuma piepūli. Pagaidām neko nemaini — vienkārši strādā ar noklusējumu. Uz lētāku un ātrāku modeli pārslēdzies tikai tad, kad darāmie soļi kļūst pavisam vienkārši un sāk atkārtoties. Pilnu tabulu ar cenām atradīsi pielikumā A1.

✓ Saprata, ja

zini pamatprincipu — lielo/domājošo modeli grūtajam solim, lēto vienkāršajam; un ka noklusējumu drīkst atstāt.

0.4

Repo, commit, deploy — konceptuāli

Trīs vārdi, ko dzirdēsi katrā sesijā. Konceptuāli pavisam vienkārši:

Repo (repozitorijs) — tava projekta darba mape ar vēsturi. Tā izskatās kā parasta mape ar failiem, taču atceras pilnīgi katru izmaiņu soli.
Commit — saglabāts kontrolpunkts šajā vēsturē. Gluži kā spēles saglabāšana: tu fiksē pašreizējo stāvokli ar īsu aprakstu, lai vajadzības gadījumā pie tā atgrieztos. Ja kaut kas salūzt, vienkārši atkāpies uz pēdējo strādājošo commit.
Deploy — padarīt lapu dzīvu internetā. Līdz deploy tavs veikums mīt tikai tavā datorā; pēc deploy tas iegūst īstu URL, ko var atvērt jebkurš.

Analoģija: repo ir dokuments ar pilnu izmaiņu vēsturi, commit ir konkrēta versija šajā vēsturē, bet deploy ir brīdis, kad tu to publicē citu acīm.

Tev pašam šīs komandas no galvas nebūs jāzina — aģents tās izpildīs. Jāsaprot tikai tas, ko katra no tām nozīmē, lai tu skaidri zinātu, ko lūgt un ko vēlāk pārbaudīt.

✓ Saprata, ja

vari vienkāršos vārdos paskaidrot, kas ir commit un kas ir deploy.

0.5

Drošība vienā elpas vilcienā

Trīs likumi. Iegaumē tos tagad; pilnā versija ar soļiem ir pielikumā A8 (vienīgais drošības patiesības avots — visas sesijas atsaucas uz to).

Noslēpumi ārpus repo. API atslēgas un paroles nekad neliec failā, ko commito vai deployo. Tie glabājas atsevišķi, ārpus darba mapes.
Deployo tikai skenētu output mapi, ne visu projektu. Publicē tikai output mapi ar tikai publiskiem failiem, un pirms tam palaid drošības skenēšanu (safe-deploy), kas pārbauda, ka nekas slepens neaizlīst līdzi.
Uzstādi budžeta griestu. Ja kādreiz lieto atsevišķu maksas API atslēgu, uzliec tai zemu mēneša griestu — tad pārsteiguma rēķins nav iespējams. (Kā to izdarīt — A7/A8.)

Kāpēc tas svarīgi: deploy nolasa failus tieši, ne caur git — tāpēc parastā „neievietot git” aizsardzība te nepalīdz. Ja noslēpums reiz nonāk publiskā lapā, tas jāuzskata par kompromitētu (jārotē). Vieglāk to nepieļaut.

✓ Saprata, ja

vari nosaukt trīs likumus — noslēpumi ārpus repo, deployo tikai skenētu output mapi, uzstādi budžeta griestu.

0.6

Aģenta darba loops

Šis ir kanoniskais cikls, kas atkārtojas katrā sesijā un katrā kontrolpunktā. Iemācies to tagad, un viss pārējais ir tikai šī paša loka atkārtojums:

Apraksti norādi — pasaki aģentam, ko gribi (pēc anatomijas no 0.7).
Apskati izvadi — izlasi, ko aģents atbild un ko tas izmainīja. Nepārlec pāri.
Palaid / pārbaudi — atver lapu, palaid rezultātu, paskaties, vai tas tiešām strādā.
Ekrānšāviņš / URL — apskati redzamo pierādījumu: pašu lapu vai dzīvo adresi, ne tikai aprakstu.
Commit — kad solis ir labs, saglabā kontrolpunktu.
Izskaidro atpakaļ — palūdz aģentam paskaidrot, ko tas izdarīja, saviem vārdiem; tā tu mācies un pamani pārpratumus.

Vissvarīgākais: 3. un 4. solis (pārbaudi) nav izlaižams. Atceries 0.2 — aģents var pārliecināti kļūdīties, tāpēc rezultāts jāredz pašam, ne jāpieņem uz vārda.

✓ Saprata, ja

vari nosaukt visus 6 soļus un saproti, kāpēc „pārbaudi” nekad netiek izlaists.

0.7

Kā uzrakstīt norādi (prompt anatomija)

Norāde (prompt) ir tas, ko tu uzraksti aģentam. Laba norāde nav gara — tā ir skaidra. Lūk, no kā tā sastāv:

Mērķis — ko tu gribi sasniegt. („Uztaisi sākumlapu ar manu vārdu un īsu aprakstu.”)
Konteksts — kāpēc, kam tas domāts, kāda situācija. („Tā ir mana portfolio lapa potenciālajiem klientiem.”)
Ierobežojumi — stils, tonis, kas jāievēro. („Vienkārša, gaiša, latviski.”)
Faili — ar kuriem failiem strādāt, ja zini. („Strādā ar index.html.”)
Pieņemšanas kritērijs — kā izskatās gatavs. („Gatavs, kad lapa atveras un rāda manu vārdu bez kļūdām.”)
„Nemaini X” — ko neaiztikt. („Nemaini krāsas.”)
„Ja neskaidrs — vispirms parādi plānu.” — liec aģentam vispirms izklāstīt plānu, ja kaut kas nav skaidrs, nevis uzreiz taisīt.

Šī pēdējā rindiņa ir spēcīga: tā aptur aģentu no minēšanas un ļauj tev pamanīt pārpratumu, pirms tas kaut ko sabojā.

Miglains lūgums vs. laba norāde:

✗ Miglains„Uztaisi man mājaslapu.”

✓ Skaidrs„Mērķis: vienkārša portfolio sākumlapa ar manu vārdu un 2 teikumu aprakstu. Konteksts: rādīšu klientiem. Fails: index.html. Gatavs, kad atveras bez kļūdām un rāda tekstu. Ja kaut kas neskaidrs, vispirms parādi plānu.”

✓ Saprata, ja

vari paņemt miglainu lūgumu un pārrakstīt to ar skaidru mērķi un pieņemšanas kritēriju.

1 Seko live · MS1 → MS4

Playbook

Šī daļa seko dzīvajām sesijām, kontrolpunkts pa kontrolpunktam (MS1→MS4, tad 1.5). Atšķirībā no primera tā drīkst būt bieza — te ir gaļa: soļi, čeklisti, gotcha kartītes. Katrā kontrolpunktā tas pats ritms: darba loops (0.6) kā rāmis → jaunie koncepti tieši tad, kad vajag → operatīvais čeklists → vārti + ✓. Drošība atkārtojas visur, bet pilnā versija ir vienā vietā — pielikums A8. Šeit tikai atsauces uz to.

MS1

Setup gatavs

Mērķis

dators ir sagatavots, pirmā sesija palaista, un tu esi uzdevis aģentam izdarīt un commitot nelielu izmaiņu. Beigās tev ir repo, CLAUDE.md un pirmais commit.

Jaunie koncepti (tieši tagad)

Claude Code — Claude, kas dzīvo tavā terminālī (tajā melnajā komandu logā). Tas māk lasīt un rakstīt failus tavā projektā, palaist komandas un commitot. Šis ir tavs jaunais darba kolēģis, kuru tu tagad režisēsi (atceries 0.1).
Sesija — viena nepārtraukta saruna ar aģentu. Tās ietvaros aģents atceras visu pārrunāto, bet katra jauna sesija sākas ar pilnīgi tīru galvu (kāpēc tas ir tik noderīgi — redzēsi MS4).
CLAUDE.md = tava konstitūcija — īss fails projekta saknē, ko aģents izlasa katras sesijas sākumā. Tajā tu paskaidro, kas šis ir par projektu, ar ko jūs strādājat un kā ar tevi jāsadarbojas. Īss teksts strādā labāk par garu (mērķē uz ~50 rindu, nevis 300). Gatavs šablons iekopēšanai atrodams pielikumā A9.

Darba loops šajā solī

Tavs pirmais reālais loops būs mazs: apraksti norādi (pēc 0.7 anatomijas) → apskati, ko aģents piedāvā → ļauj izpildīt un commitot → izskaidro atpakaļ. Piemēram: „Pievieno README.md ar vienu rindu — projekta nosaukumu. Kad izdarīts, commito ar skaidru ziņu.”

Operatīvais čeklists

Priekšnosacījumi no 0.0 izpildīti: konti, Claude Pro, instalēts Claude Code + Git. (Ja nē — atgriezies pie 0.0 / A0.)
Palaid pirmo sesiju projekta mapē. Ja mape tukša — palūdz aģentam to inicializēt kā git repo.
Izveido CLAUDE.md no A9 šablona; aizpildi <...> vietas (kas ir projekts; steks — ar ko strādājat, t.i. rīki/tehnoloģijas; patiesības avoti). Turi īsu.
Pirmā norāde + commit: liec aģentam izdarīt vienu mazu, pārbaudāmu izmaiņu un to commitot.
Drošība: ja setup prasa kādu atslēgu/paroli — apstājies; noslēpumi dzīvo ārpus repo (pilns rituāls → A8).

Ja pirmā palaišana neizdodas

Komanda „nav atrasta” → rīks nav instalēts vai terminālis jārestartē. Pārbaudi 0.0/A0 instalācijas soli.
Aģents neredz tavu mapi → pārliecinies, ka sesija palaista projekta mapē (ne mājas mapē).
Iestrēdzis vai kaut kas dīvains → atkopšanās kartītes A6 (Esc aptur, Esc-Esc attin, jauna sesija).
Neskaidra kļūda → nokopē kļūdas tekstu un iedod to aģentam: „šī kļūda — ko tā nozīmē un kā to labot?”

Vārti MS1 · setup

Tev ir git repo, aizpildīts CLAUDE.md un pirmais commit, ko izdarīja aģents pēc tavas norādes.

✓ Saprata, ja

iedarbināji sesiju un liki aģentam izdarīt + commitot tavu aprakstīto izmaiņu.

MS2

Statiska lapa dzīva

Mērķis

izveidot vienkāršu statisku lapu (piemēram, tava profila vai portfolio sākumlapu) un padarīt to dzīvu internetā caur Cloudflare Pages. Pa ceļam izlabosi vismaz vienu kļūdu, lasot izvadi, nevis minot.

Jaunie koncepti (tieši tagad)

0.6 loops pilnā ritmā — tagad cikls izvēršas līdz galam: norāde → preview → commit → deploy. „Preview” ir lokāls priekšskatījums tavā datorā tieši pirms publicēšanas.
„Logi” un kļūdas — kad kaut kas nestrādā, sistēma parāda ziņojumu (žurnālu jeb „logu”) par to, kas tieši nogāja greizi. Sākumā tas var izskatīties pārāk tehniski, taču tieši tur slēpjas atbilde. Neignorē to — izlasi pats vai iedod aģentam. Lasīt izvadi vienmēr ir labāk nekā minēt.
Cloudflare Pages — bezmaksas hostings statiskām lapām. Rīks paņem tavu output mapi un piešķir tai dzīvu URL adresi.

Darba loops šajā solī

Norāde („uztaisi sākumlapu ar X”) → preview (atver lokāli, paskaties) → ja kļūda: izlasi izvadi → labo → commit → deploy → atver dzīvo URL un pārbaudi. Verifikācija šeit ir manuāli vizuāla: tu atver lapu acīm un skaties. (Automātisko pārbaudi ar rīkiem redzēsi MS3.)

Deploy mehānikas čeklists

Host konts — Cloudflare konts izveidots (0.0).
Build/output mape — tavai lapai ir skaidra mape ar tikai publiskajiem failiem (piem. site/). Deployo tikai to, ne visu projektu.
Skenē pirms publicē — palaid safe-deploy.py pār output mapi (pilns rituāls → A8).
Deploy — publicē caur Cloudflare Pages; sagaidi dzīvo URL.
URL — atver to. „Dzīvs” nozīmē, ka strādā internetā, ne tikai tavā datorā.
Cache — ja izmaiņa uzreiz neparādās, tā var būt kešatmiņa; pagaidi vai pārlādē. Ja bija noplūdis noslēpums — keša tīrīšana ir daļa no labojuma (A8).
Env (vides) mainīgie — ja lapai vajag konfigurāciju vai atslēgu, to iestata platformā (piem. Cloudflare iestatījumos), ne kā failu repo.

Gotcha kartītes (biežākās deploy kļūmes)

Lapa deployojas, bet „Functions” pazūd

palaid deploy no projekta saknes, ne no apakšmapes.

Attēli nerādās

HTML atsaucas uz attēliem pa relatīvo ceļu; turi lapu un attēlus vienā mapē.

wrangler deployo uz nepareizo Cloudflare kontu

uzspied pareizo konta ID kā vides mainīgo.

Slepenais fails servējas publiski

nepaļaujies uz .assetsignore; output mapē liekam nav vietas (A8).

Pilnās kartītes ar avotiem → pielikums A5.

VārtiMS2 · dzīva lapa

Lapa dzīva Cloudflare Pages, tu to deployoji, un vismaz vienu redzamu kļūdu izlaboji, lasot izvadi.

✓ Saprata, ja

izlaboji redzamu kļūdu, lasot izvadi, ne minot.

MS3

Dashboard pipeline strādā

Mērķis

izveidot vienkāršu dashboardu, kas izvelk reālus datus caur vienu pipeline un parāda vienu noderīgu skatu. Šis ir sprinta grūtākais solis, tāpēc sākumā noteikti sašaurini tvērumu.

Vispirms: scoping tilts (izdari šo, pirms kaut ko būvē)

Iesācēja lielākā kļūda ir mēģināt par daudz. Pirms sāc, fiksē uz papīra:

Viens datu avots (ne pieci).
Viens pipeline — viena datu plūsma no avota līdz skatam.
Viens noderīgs skats — viena tabula vai grafiks, kas atbild uz vienu jautājumu.
Viens veiksmes rādītājs — „gatavs, kad rāda X par pēdējām 30 dienām”.
Nekādu sensitīvu datu pirmajā versijā.
Viss pārējais — nogriez. Features var pievienot vēlāk.

Jaunie koncepti (tieši tagad)

API — veids, kā viena programma palūdz datus citam servisam. Iedomājies to kā „servisa lodziņu”: tu iesniedz pieprasījumu noteiktā formā, un tas atdod datus. Tavs dashboards izmantos API, lai iegūtu reālus datus.
API atslēga — slepena parole, kas pierāda, ka pieprasījums nāk tieši no tava konta. Tā dzīvo ārpus repo (A8), un maksas atslēgām vienmēr uzreiz uzstādi izmaksu griestus (A7).
Pipeline forma — laba datu plūsma ir vienkārša ķēde: paņem datus (fetch) → lēts filtrs/apstrāde → (ja vajag) modeļa sintēze → saglabā rezultātu. Dārgo un gudro soli (modeli) liec pēc lētā filtra, lai netērētu resursus velti.
MCP un kāpēc tieši tagad — MCP ir „adapteris”, kas iedod aģentam papildu spēju (atceries, ka primerā mēs to pagaidām ignorējām). Tagad, kad tev ir dashboarda skats (preview vai dzīvs), ļoti noderēs Playwright MCP. Tas dod aģentam spēju atvērt tavu lapu kā cilvēks — noklikšķināt uz filtra, pārbaudīt, vai grafiks nav tukšs, un uzņemt ekrānšāviņu. Tā ir automātiskā verifikācija, kas MS2 solī vēl nebija vajadzīga.
git-as-truth — tavs repo ar commit vēsturi kalpo kā patiesības avots par visu izdarīto. Ja apjūc, vēsture skaidri parāda, kur biji pirms tam.

Darba loops šajā solī

Tas pats 0.6 loops, tikai „pārbaudi” solī tagad vari izmantot Playwright MCP: norāde → aģents būvē pipeline → palaid → pārbaudi (atver dashboardu vai liec Playwright to izdarīt) → ekrānšāviņš/URL → commit → izskaidro atpakaļ.

MCP: ko pievienot (un ko ne)

Nepievieno „visu sarakstu”. Pievieno vienu serveri tikai tad, kad vari pabeigt teikumu: „Aģentam jādrīkst ___, lai pārbaudītu vai salabotu dashboardu.”

Vajadzība	Serveris
„Vai mans dashboards tiešām strādā?”	Playwright (atver, klikšķina, ekrānšāviņš)
„Ielasi šo publisko dok./cenu lapu”	Fetch
„Strādā ar lokāliem CSV/MD failiem”	Filesystem (tikai viena atļauta mape)
„Issue / PR / logi ir GitHub”	GitHub (sākumā read-only)

Pilns saraksts + drošības piezīmes → pielikums A2. Iesācēja likums: MS3 sākumā pietiek ar Playwright.

API hubi (kad daudz modeļu)

Ja sintēzes solī gribi salīdzināt vai pārslēgt modeļus (Claude/GPT/Gemini...), API hub (piem. OpenRouter) dod vienu pieslēgvietu un vienu atslēgu uz daudziem modeļiem. Ja lieto tikai Claude — tiešā Anthropic API ir vienkāršāka, hub vēl nav vajadzīgs. Detaļas → pielikums A3.

Operatīvais + drošība

API atslēgas — ārpus repo, kā vides mainīgais vai centrālā .secrets glabātuvē (nekad servētajā mapē). → A8.
Izmaksu griesti — jebkurai maksas atslēgai uzstādi zemu mēneša griestu uzreiz. Anthropic API to dara Console → Limits; citiem hubiem/provideriem (piem. OpenRouter) ir savi griesti vai kredītu limiti — uzstādi tos, pirms lieto. Izmaksu lapa → A7.
Privātums — nekādu sensitīvu vai personīgu datu pirmajā dashboardā. Ja dati ir jutīgi — apstājies un pajautā mentoram.
Ja aģents iestrēdzis pie pipeline — atkopšanās kartītes A6 (sašaurini soli, plan mode, jauna sesija).

VārtiMS3 · pipeline

Dashboards velk reālus datus caur vienu pipeline un parāda skatu.

✓ Saprata, ja

tev ir dashboards ar reāliem datiem caur pipeline, ko tu režisēji, tu zini tā izmaksas un ka atslēgas ir drošībā.

MS4

Deployots + handoff

Mērķis

novest dashboardu līdz nopulētam, dzīvam stāvoklim, uzrakstīt HANDOFF, no kura sveša (jauna) sesija varēs turpināt iesākto, un noauditēt pašam savu darbu.

Jaunie koncepti (tieši tagad)

Context rot („konteksta rūsa”) — atceries mājienu no 0.2: aģentam vienā sesijā ir ierobežota atmiņa (konteksta logs). Jo garāka kļūst sesija, jo vairāk agrīnā satura tas „aizmirst” vai sajauc, un pēc ilgstošas strādāšanas sāk kļūdīties. Risinājums ir nevis cīnīties pretim, bet sākt jaunu sesiju ar skaidru galvu un HANDOFF, kas precīzi pasaka, kur apstājies.
Handoff prakse — HANDOFF ir īss fails, ko aģents katrā sesijā izlasa pirmo: kur mēs esam, kas jau pabeigts (ar commit), kāds ir nākamais konkrētais solis un ko noteikti NEDARĪT bez tevis. Šo failu tu atjaunini sesijas beigās. Šablons → A9.
Pašaudits — pirms saki „gatavs”, pats pārbaudi paveikto pret zemāk redzamo sarakstu. Galu galā tieši režisors pieņem darbu.

„Nopulēts” — ko tas nozīmē

Ne „aptuveni strādā”, bet:

Dzīvs URL tiešām atveras un rāda pareizo.
Nav lauztu linku — visi links ved, kur vajag.
Mobilais — atver telefonā (ātrā pārbaude); nav salūzis.
Svaigas-sesijas handoff tests — atver jaunu sesiju un pārbaudi: vai no HANDOFF vien var turpināt? Ja nē — HANDOFF vēl nav gatavs.

Pašaudita čeklists (7 asis)

Pirms nodošanas izej cauri:

Dzīvs URL verificēts (atvērts, strādā).
Links — nav lauztu.
Mobilais — ātri pārbaudīts telefonā.
Drošība — nav noplūdušu noslēpumu, deploy bija skenēts (A8).
Izmaksas — griesti uzstādīti, zini mēneša summu (A7).
HANDOFF — svaiga sesija no tā var turpināt (tests izdarīts).
Vēsture — katrs solis commitots, ziņas skaidras.

Darba loops šajā solī

Tas pats loops, bet „pārbaudi” = pašaudita čeklists, un „commit” ietver arī HANDOFF atjauninājumu. Beigās: dzīvs URL + HANDOFF + tava atsauksme, kas gāja labi un kas grūti.

VārtiMS4 · handoff

Nopulēts, deployots dashboards + HANDOFF + pašaudits + atsauksme.

✓ Saprata, ja

nogādāji dzīvu dashboardu, uzrakstīji handoff, no kura svaiga sesija turpina, un noauditēji pats savu darbu.

1.5

Pēc sprinta: kā turpināt augt

Sprints ir galā — tev ir dzīvs dashboards, ko režisēji pilnīgi no nulles. Tagad varam atgriezties pie tā, ko 0.1 sadaļā lūdzām pagaidām ignorēt.

Skills (prasmes) — iepakots norāžu komplekts atkārtotam darbam. Ja kādu workflow prasi atkal un atkal (piemēram, „uztaisi nedēļas atskaiti pēc šī parauga”), to vari iepakot kā skill, lai katru reizi nav jāskaidro no jauna.
Plugins (spraudņi) — komplekti, kas iedod Claude Code jaunas spējas vai komandas (arī MCP serverus, kā MS3).
Kā lietot — izsauc skill vai komandu, kad to vajag; tā ienesīs savas instrukcijas tavā sesijā.
Kā veidot (viegli) — kad pamani, ka atkārto vienu un to pašu norādi, palūdz aģentam to iepakot kā skill. Tas ir vieglākais sākumpunkts.

Kad esi gatavs — tālāk: tevi gaida vēl jaudīgāki rīki, piemēram, subagenti (paralēli palīgi lielākam darbam), plan mode sarežģītiem uzdevumiem un hooks (automātiskas darbības pēc noteikta notikuma). Nav jāsteidzas — tie noderēs, kad pamati jau būs stabili.

Kur meklēt: palūdz aģentam parādīt pieejamās skills un komandas vai pārrunā to ar mentoru. Sāc tieši no turienes.

✓ Saprata, ja

saproti, ka skills/plugins iepako tavus atkārtotos workflows, un zini, kur meklēt, kad gribi tos lietot vai veidot.

2 Meklē · kad vajag

Atsauces pielikums

Plakans, skenējams companion. Meklē te, kad vajag — nav jālasa no vāka līdz vākam. Ātri-mainīgais (modeļi, MCP, hubi, cenas, linki) apzināti sēž šeit, lai to varētu atjaunināt atsevišķi. Cenas un ID pārbaudāmi pret dzīvām lapām pirms piegādes.

Gatavības čeklists

Pilnā 0.0 versija — izej cauri pirms pirmās sesijas.

Konti
Claude konts + Pro abonements (~$20/mēn) — Claude Code ir iekļauts Pro (ne Free).
GitHub konts (bezmaksas) — repo hostings + vēsture.
Cloudflare konts (bezmaksas) — deploy (lapa dzīva).
Rīki instalēti
Claude Code (termināļa rīks) — sk. Claude Code quickstart (A4).
Git — sk. GitHub „set up Git” (A4).
Terminālis atvērts un strādā (komanda atrodama pēc instalācijas vai restarta).
Nauda un griesti
Zini mēneša izmaksas: ~$20 (Pro). Hostings bezmaksas. Detaļas → A7.
Ja plāno maksas API atslēgu (pipeline izsauc maksas API) — uzstādi zemu mēneša griestu uzreiz (Anthropic: Console → Limits → mēneša cap darbvietai/atslēgai; citiem provideriem — savi limiti) → A7 / A8.
Drošība
Zini, kur dzīvo noslēpumi: ārpus repo (vides mainīgie vai .secrets), nekad servētajā mapē → A8.
Praktiskais
Saproti „dzīvs URL” = lapa strādā internetā (piem. projekts.pages.dev), ne tikai tavā datorā.
Laiks atvēlēts: ~8–12 h/ned, ~2 sesijas.
Plāns, ja setup neizdodas: pieraksti kļūdas tekstu → pirmais jautājums sesijā (sk. A5).

Modeļu čītšīts

Avots: claude-api modeļu tabula, kešēta 2026-06-24. Cenas un ID gaistoši — pārbaudi pret dzīvo lapu pirms piegādes.

Kurš modelis kad

Modelis	Kad lietot	Ātrums / dziļums	Cena (ievade / izvade uz 1M tokeniem)
Haiku 4.5 `claude-haiku-4-5`	Vienkārši, atkārtoti, ātri soļi	Ātrs, seklāks	$1 / $5
Sonnet 5 `claude-sonnet-5`	Ikdienas darbs, lielākā daļa uzdevumu	Ātrs–vidējs, labs	$3 / $15
Opus 4.8 `claude-opus-4-8`	Grūti soļi — loģika, arhitektūra, knifīgas kļūdas	Lēnāks, dziļš	$5 / $25
Fable 5 `claude-fable-5`	Vissarežģītākie, gari uzdevumi	Lēns, visdziļākais	$10 / $50

1 tokens ≈ 0,75 angļu vārda (latviešu tekstam tokenu vairāk). Iesācēja noklusējums: Claude Code startē ar spēcīgu modeli — strādā ar to; pārslēdzies uz lētāku tikai vienkāršiem, atkārtotiem soļiem.

Domāšanas piepūle (thinking effort)

Līmenis	Kad
`low`	Vienkārši, ātri; ātrums svarīgāks par dziļumu
`medium`	Cenas taupīšana, saglabājot kvalitāti
`high`	Noklusējums — līdzsvars lielākajai daļai darba
`xhigh`	Grūtākie daudzsoļu uzdevumi (Claude Code noklusējums)
`max`	Kad pareizība svarīgāka par visu; var būt lēni

Mūsdienu modeļi izmanto adaptīvo domāšanu — pietiek ar effort līmeni, nekāds „budžets” ar roku nav jāregulē. Iesācēja likums: atstāj noklusējumu; cel uz max tikai grūtākajam solim.

MCP saraksts

Verificēts ar live web search 2026-07-06 (oficiālie MCP / Anthropic / serveru doki).

Kas ir MCP. MCP (Model Context Protocol) ir atvērts standarts, ar ko AI lietotne pieslēdzas ārējiem rīkiem un datu avotiem — kā universāls adapteris starp aģentu un konkrētu rīku. Bez adaptera aģents strādā ar to, ko ielīmē sarunā; ar adapteri tas var (ar tavu atļauju) lietot pieslēgto rīku tieši.

Iesācēja likums: nepievieno „visu sarakstu”. Pievieno vienu serveri tikai tad, kad vari pabeigt teikumu: „Aģentam jādrīkst ___, lai pārbaudītu vai salabotu dashboardu.” MS1–MS2 pietiek ar pamata loopu; MCP kļūst noderīgs MS3.

⚠️ MCP serveris nav automātiski uzticams — Anthropic brīdina par prompt-injection risku serveriem, kas ielasa ārēju saturu. Pievieno tikai uzticamus serverus un pārbaudi katru pieprasīto darbību.

Serveris	Kas / kāpēc	Kad	Drošība
Playwright (primārais MS3)	Dod aģentam pārlūka automatizāciju: atver lapu, klikšķina, raksta, uzņem ekrānšāviņu. Ļauj pārbaudīt dashboardu kā cilvēks.	MS3+, kad ir skats/preview	Nelieto `browser_run_code_unsafe` (RCE-ekvivalents) iesācēja loopā
Fetch	Ielasa publiskas web lapas saturu (HTML → markdown). Labs „avotu ielasītājs”.	MS3, konkrētam URL	Var piekļūt lokāliem/iekšējiem IP — tikai uzticami publiski URL
Filesystem	Failu operācijas, bet tikai atļautajā mapē.	MS3, ja dati ārpus repo	Atļauj tikai vienu projekta mapi, ne visu datoru
GitHub	Repo / issue / PR / Actions konteksts tieši aģentam.	MS3 / MS4, ja projekts GitHub	Sākumā read-only; tokenu ārpus repo

Ko neuzspiest pirmajā MS3 versijā: vairākus serverus „drošībai” (katrs = jauna piekļuves virsma); Fetch pret privātiem hostiem; Filesystem uz visu datoru; GitHub write tools, kamēr nesaproti sekas.

Oficiālie reference serveri (modelcontextprotocol/servers) ir mācību piemēri, ne automātiski production-ready — katrai piekļuvei šaurs mērķis, minimālas tiesības, cilvēka apstiprinājums.

API hub saraksts

Pārbaudīts ar dzīviem avotiem 2026-07-06.

Kas ir API hub. Viena pieslēgvieta uz vairākiem AI modeļiem vai provideriem: dashboarda kods sūta pieprasījumu uz vienu adresi ar vienu atslēgu, bet aiz tās var būt Anthropic, OpenAI, Google, xAI, Mistral u.c. Bieži arī viens rēķins un viena lietojuma uzskaite. Analītiķa analoģija: viena datu-konektoru sadaļa un viena izmaksu lapa, ne atsevišķs eksports no katras sistēmas.

Ko tas atrisina MS3: kad sintēzes solī gribi salīdzināt vai pārslēgt modeļus, nepārrakstot integrāciju katram providerim. Hub neaizstāj drošu atslēgu glabāšanu, izmaksu griestus vai datu privātuma lēmumus.

Risinājums	Kas / kad	Piezīme
OpenRouter	Viens API, simti modeļu, viens endpoint. Sākuma izvēle, ja gribi izmēģināt vairākus modeļus ar vienu atslēgu.	Unified billing + usage tracking; mainās galvenokārt base URL + atslēga
Vercel AI Gateway	Ja app jau Vercel / Next ekosistēmā.	Viena atslēga, spend monitoring, fallback
Cloudflare AI Gateway	Ja vajag production-kontroli: logi, cache, rate limits, retries.	Core features bez maksas; provideri: Anthropic, OpenAI, Google, xAI, OpenRouter u.c.
LiteLLM	Pašhostēts gateway komandai, kas pati to uztur.	Ne pirmais solo-iesācēja instruments
Tiešā Anthropic API	Ja lieto tikai Claude, bez salīdzināšanas.	Vienkāršāka nekā hub

Kad hub NAV vajadzīgs: lieto tikai Claude; nav API pipeline (tikai Claude Code sesija); vēl nav drošības/izmaksu disciplīnas (vispirms sakārto A8 / A7).

Avoti: openrouter.ai/docs · vercel.com/docs/ai-gateway · developers.cloudflare.com/ai-gateway · docs.litellm.ai

Ārējie linki

Link-check: visi URL atgrieza HTTP 200 (2026-07-06). Pāradresētie aizstāti ar kanonisko gala URL.

Links	Kāpēc svarīgi	Kad
Claude Code: terminal guide	Soli pa solim: atvērt termināli, uzstādīt Claude Code, palaist pirmo sesiju	MS1
Claude Code: quickstart	Galvenais sākuma ceļš instalācijai, loginam, pirmajai darbībai	MS1
Claude Code: how Claude Code works	Kā aģents terminālī lasa failus, maina kodu, palaiž komandas ar tavu kontroli	MS1
Claude Code: best practices	Vadīt aģentu ar mērķiem, kontekstu un verifikāciju, ne mikromenedžēt kodu	MS1–MS4
Claude Code: common workflows	Konkrētas promptu receptes: izpētīt, labot, testēt, dokumentēt, turpināt sesijas	MS2–MS4
Claude Code: commands	Sesijas iekšējās komandas: modelis, konfigurācija, konteksts, darba vadība	MS1–MS4
Claude Code: memory	Saprast CLAUDE.md, projekta atmiņu, kāpēc aģentam vajag skaidras instrukcijas	MS1, MS4
Claude Code: manage costs	Izmaksu skatīšana, konteksta taupīšana, modeļu izvēle, usage/spend limiti	MS1, MS3
Anthropic: models overview	Kuru Claude modeli lietot ātram, lētam vai dziļākam darbam (sk. A1)	MS1, MS3
Claude Help: usage & length limits	Kāpēc var beigties lietošanas limits; ko nozīmē sarunas garums / kapacitātes logs	MS1–MS4
MCP: kas ir Model Context Protocol	Vienkārša sākuma lapa par MCP kā standartu (sk. A2)	MS3
Claude Code: connect to MCP	Pievienot pirmo MCP serveri un pārbaudīt savienojumu	MS3
Claude Code: MCP reference	Pilnāka atsauce: scopes, konfigurācija, traucējummeklēšana	MS3
Playwright MCP: installation	Pārlūka verifikācija dashboard fāzē	MS3
Cloudflare Pages: Static HTML	MS2 statiskai lapai: HTML/CSS/JS uz Cloudflare Pages	MS2
Cloudflare Pages: Git integration	Automātiskais deploy no repo pēc push	MS2, MS4
Cloudflare Pages: Direct Upload	Deploy no gatavas build/output mapes, ne visa repo	MS2, MS4
Wrangler: pages deploy	Precīza komanda `wrangler pages deploy [DIRECTORY]` drošam explicit-payload deploy	MS2, MS4
Cloudflare Pages: build config	Build command un output directory, kad lapa pāraug par dashboardu	MS2, MS3
Cloudflare Pages: custom domains	MS4 dzīvs URL ar savu domēnu, ne tikai `pages.dev`	MS4
GitHub: about GitHub and Git	Atšķirība: Git, GitHub, repo, commits, sadarbība	MS1
GitHub: set up Git	Uzstādīt Git, sagatavot datoru pirmajam repo	MS1
GitHub: Hello World	Drošs vingrinājums repo/branch/commit/PR idejai	MS1
Pro Git: getting a repository	Stabila Git pamatu nodaļa: init, clone, add, commit, status	MS1–MS2
GitHub: managing remotes	`origin`, remote URL, kā lokālais savienojas ar GitHub un deploy	MS2, MS4
GitHub: storing secrets safely	Galvenais drošības likums: atslēgas/tokenus ne kodā, ne repo	MS1, MS3, MS4

Gotcha kartītes

Formāts: simptoms → labojums. Kad kaut kas nestrādā, meklē te vispirms.

Deploy

Lapa deployojas, bet „Functions” pazūd („No Functions. Shimming...”)

palaid deploy no projekta saknes, ne no apakšmapes (Functions kompilējas relatīvi pret CWD).

Slepenais fails (wrangler.toml / .env) servējas publiski

nepaļaujies uz .assetsignore (wrangler ≥4 to ignorē); liec wrangler.toml + functions/ saknē, pages_build_output_dir = "site", output mapē tikai publiskie faili. → A8.

API atslēga (Pages secret) nestrādā pēc uzstādīšanas

secret saistās tikai nākamajā deploy — uzstādi, redeploy, tad testē.

wrangler deployo uz nepareizo kontu

uzspied pareizo konta ID kā vides mainīgo (CLOUDFLARE_ACCOUNT_ID).

Forma paiet cauri bez īstas verifikācijas

pārbaudi, ka nav palicis hardcoded test-fallback (piem. Turnstile test-atslēga); nomaini pret īsto pirms prod.

Lapa / attēli

Attēli nerādās deployotajā lapā

HTML atsaucas uz attēliem pa relatīvo ceļu; turi lapu un attēlus vienā mapē.

API / modeļi (MS3)

Pipeline klusi pārstāj strādāt pēc laika

nehardcodē modeļu ID fallback ķēdē; ja providers retirē ID, funkcija klusi krīt. Pārbaudi modeļa ID pret dzīvo lapu (A1).

Budžets izsūkts, kaut zvans neizdevās

budžeta skaitītājs pieaug PIRMS zvans izdodas; timeout tērē slotu. Novērtē tokenus konservatīvi, uzstādi griestu (A7).

Sesija / process

HANDOFF/stāvoklis sajūk, checkpoints konfliktē

viens režisors; paralēlas sesijas lauž secīgo darbu. Jauna tēma = jauna sesija.

Atkopšanās kartītes — „aģents iestrēdzis”

Kad aģents iestrēdzis, cilpo vai nesaprot — pamēģini šos, secībā:

Aptur (Esc) — aģents apstājas uzreiz un gaida tavu norādi.
Attin (Esc divreiz) — atgriež uz iepriekšējo stāvokli (checkpoints, lokāli sesijai).
Sašaurini norādi — viena norāde = viens pārbaudāms rezultāts; sadali mazākā solī.
Palūdz izskaidrot + kā pārbaudīt — liec pastāstīt cilvēku valodā, ko dara un kā to verificēt, pirms turpina.
Plan mode vispirms (Shift+Tab divreiz) — sarežģītai problēmai: izpēti un plānu PIRMS koda; pārskati, tad ļauj izpildīt.
Jauna sesija — ja konteksts „sarūsējis” (aģents aizmirsis), sāc jaunu sesiju ar tīru galvu; HANDOFF ļauj turpināt.
Ievirzi (raksti + Enter) — neapstādinot, ieraksti korekciju; aģents to izlasa nākamajā solī.

Zelta likums: ja neskaidrs — apturi un sašaurini, nevis ļauj cilpot. Konteksta rot risinājums = jauna sesija + HANDOFF.

Izmaksu lapa

Cenas fetch 2026-07-06 — pārbaudi pret dzīvām lapām pirms piegādes. Divu veidu izmaksas; tikai viena var pārsteigt ar rēķinu.

(a) Fiksētie abonementi — droši, zini summu iepriekš

Plāns	Cena	Claude Code
Free	$0	nav iekļauts
Pro	$17/mēn (gada) vai $20 (ikmēneša)	iekļauts
Max 5×	no $100/mēn	iekļauts, 5× lietošana
Max 20×	$200/mēn	iekļauts, 20× lietošana

Lietošanas limits kopīgs starp Claude čatu un Claude Code. Iesācēja izvēle: sāc ar Pro; cel uz Max, ja sit limitu. Hostings (Cloudflare Pages, GitHub) sprinta apjomā = $0.

(b) Usage-based / pay-per-token — kur ir risks

Vajadzīgs tikai tad, ja dashboarda pipeline pats izsauc maksas API. Aptuvenās Anthropic cenas → A1. API hubi (OpenRouter u.c.) → A3, kredītu / pay-per-token modelis.

Uzstādi griestu uzreiz — pirms lieto maksas atslēgu. Anthropic: Console → Limits (mēneša cap darbvietai un/vai atsevišķai atslēgai); sasniedzot, lietošana apstājas, ne turpina tērēt.
Zems griests dev-atslēgai (piem. $5–10) — rēķins fiziski nevar to pārsniegt.
Citiem hubiem / provideriem — savi griesti vai kredītu limiti.
Nav pay-per-token atslēgas → nav pārsteiguma rēķina.

Mēneša novērtējums (pilota sprints): ~$20 (Pro + bezmaksas hostings).

Drošības rituāls (vienīgais patiesības avots)

Visi MS atsaucas uz šo, nepārraksta. Trīs likumi vienā elpas vilcienā, tad pilnā versija.

Trīs likumi: (1) noslēpumi ārpus repo; (2) deployo tikai skenētu output mapi, ne visu projektu; (3) uzstādi budžeta griestu.

1. Noslēpumi dzīvo ĀRPUS deployojamās mapes

Atslēgas/tokeni glabā vidē (env mainīgie) vai centrālā glabātuvē (C:\Projects\.secrets), nekad failā servētajā mapē. Tad pat visas-mapes deploy fiziski nevar noplūdināt noslēpumu.
⚠️ Deploy lasa failsistēmu TIEŠI — ne caur git. Tāpēc .gitignore un git secret-scanneri neaizsargā deploy. Aizsardzība jāliek uz deploy payload.

2. Deployo TIKAI build/output mapi (ne repo sakni)

Deployo tikai skaidru dist/ / site/ / build/ mapi ar tikai publiskiem failiem.
Cloudflare Pages struktūra: wrangler.toml + functions/ projekta saknē, pages_build_output_dir = "site", site/ = tikai publiskie faili.
⚠️ Neuzticies .assetsignore drošībai — wrangler ≥4 to ignorē pages deploy gadījumā. Nekad ne kā drošības robeža.

3. Skenē payload PIRMS publicē

Palaid: python ~/.claude/safe-deploy.py <deploy_dir> -- <deploy komanda...> — aborts, ja atrod *.env / atslēgas / *.pem / credentials / .git/.
Windows: safe-deploy.py iet ar shell=False → bare npx neuzticams; saslēdz skenu + deploy ar &&: python safe-deploy.py site && npx wrangler pages deploy.
Nekad nepalaid deploy komandu uz neskenētas mapes.

4. Budžeta griesti

Katrai pay-per-token atslēgai — uzstādi zemu mēneša griestu uzreiz (Console → Limits; sk. A7). Rēķins fiziski nevar pārsniegt griestu.
Edge/AI funkcijām — budžeta sargs + circuit breaker (per-user + global limits, timeout + fallback), lai kļūda vai timeout neizsūc budžetu.

5. Ja noslēpums nonāca publiskā hostā = KOMPROMITĒTS

Saki uzreiz. Rotē atslēgu UN iztīri hosta kešu — origin tīrīšana nepietiek (Cloudflare kešē līdz 7 dienām).

CLAUDE.md + HANDOFF šabloni

Kopē un aizpildi <...> vietas. Turi CLAUDE.md īsu (~50 rindu; Anthropic: īss > garš). Avotu faili: guide/templates/.

CLAUDE.md šablons

# CLAUDE.md — <projekta nosaukums>

## Kas šis projekts ir
<vienā teikumā: ko mēs būvējam un kam>

## Steks (ar ko strādājam)
- <piem. statiska HTML/CSS/JS lapa; Cloudflare Pages deploy; GitHub repo>

## Kā strādāt ar mani (režisora likumi)
- Viena norāde = viens pārbaudāms rezultāts. Atskaities cilvēku valodā + kā to pārbaudīt.
- Pirms jebkura konta / deploy / API-atslēgas soļa — apstājies un pajautā, neminam.
- Pēc katra pabeigta soļa — commito ar skaidru ziņu.
- Verifikācija = atver URL un paskaties (vai palaid), ne "droši vien strādā".

## Drošība (nepārkāpjami — pilns rituāls: A8)
- Noslēpumi (API atslēgas) — ārpus repo, nekad servētajā mapē.
- Deployo tikai build/output mapi; skenē ar safe-deploy.py pirms publicē.

## Patiesības avoti
- <fails vai lapa, kas ir autoritāte, ja doki un kods nesakrīt>

HANDOFF.md šablons

# HANDOFF — <projekta nosaukums>

> Atjaunināts: <datums> · Fāze: <MS_x>

## Kur esam (autoritatīvais pašreizējais stāvoklis)
- Pabeigts: <kas izdarīts, ar commit hash>
- Nākamais: <viens skaidrs, sašaurināts uzdevums>

## Palaist vispirms
- <komanda, ar ko sākt sesiju / palaist projektu>

## Stop nosacījumi (ko NEDARĪT bez cilvēka OK)
- <konti, deploy, API atslēgas, cenu maiņas>

## Pierādījumi
- <commit range / URL / ekrānšāviņš, kas apliecina pēdējo fāzi>

A10

Minimālā vārdnīca

aģents: AI palīgs, kuram dod uzdevumu un kurš pats var plānot soļus, lasīt failus, labot tekstu vai palaist komandas. Iedomājies to kā juniora kolēģi ar ļoti ātrām rokām, bet ar vajadzību pēc skaidra režisora.
API: veids, kā viena programma sarunājas ar citu programmu. Tas ir kā pasūtījuma lodziņš: tu iedod precīzu pieprasījumu, otrā puse atdod atbildi noteiktā formā.
API atslēga: slepena parole, kas pierāda, ka tev ir tiesības lietot konkrētu API. Ar to jāapietas kā ar bankas kartes PIN: neliec publiskos failos un nesūti svešiem.
API hub: starpniekpakalpojums, kur vienā vietā var piekļūt vairākiem modeļiem vai datu avotiem. Tas ir kā tirgus laukums, kur dažādi pārdevēji stāv aiz vienas ieejas.
branch (zars): atsevišķa darba līnija git vēsturē, kur var izmēģināt izmaiņas, netraucējot galveno versiju. Iesācējam pietiek zināt: parasti strādā tajā zarā, kas jau ir atvērts.
CLAUDE.md: projekta instrukciju fails AI aģentam. Tajā parasti raksta, kā šajā projektā strādāt, ko neaiztikt un kā pārbaudīt rezultātu.
commit: saglabāts izmaiņu moments git vēsturē. Tas ir kā fotogrāfija ar komentāru: „šajā brīdī projekts izskatījās šādi”.
context rot: brīdis, kad gara sesija sāk kļūt miglaina, jo sarunā ir sakrājies pārāk daudz detaļu. Tad palīdz īss handoff vai jauna sesija ar skaidru kopsavilkumu.
deploy: gatavās versijas publicēšana vietā, kur to var lietot citi cilvēki, piemēram, mājaslapā. Tas nav tas pats, kas commit: commit saglabā vēsturi, deploy parāda rezultātu ārpasaulei.
endpoint: konkrēta API adrese jeb „durvis”, uz kurām sūta pieprasījumu. Piemēram, viena adrese var būt modeļa atbildei, cita — failu augšupielādei.
git: rīks, kas glabā projekta izmaiņu vēsturi. Tas ļauj redzēt, kas mainīts, kad un kāpēc, un vajadzības gadījumā atgriezties pie agrāka stāvokļa.
handoff: īss nodošanas pieraksts nākamajai sesijai vai cilvēkam. Labs handoff pasaka, kas izdarīts, kas pārbaudīts un kāds ir nākamais drošais solis.
lokāli: uz tava datora, nevis internetā vai publiskā serverī. Lokāls tests parasti ir drošāks pirmais solis pirms deploy.
MCP: savienojuma standarts, ar kuru AI aģents var lietot ārējus rīkus vai datu avotus. Domā par to kā par adapteri, kas ļauj Claude Code pieslēgties konkrētai darba videi.
modelis: AI „smadzenes”, kas lasa tavu norādi un ģenerē atbildi. Daži modeļi ir ātrāki un lētāki, citi domā dziļāk, bet maksā vairāk.
prompt (norāde): instrukcija, ko tu dod AI modelim. Labs prompts pasaka ne tikai „ko izdarīt”, bet arī auditoriju, robežas, vēlamo formātu un pārbaudes kritērijus.
providers: uzņēmumi vai pakalpojumi, kas nodrošina modeļus, API vai citus rīkus. Piemēram, viens providers var dot AI modeli, cits — datu iegūšanas servisu.
push: commit augšupielāde uz attālu repo, piemēram, GitHub. Push vēl nenozīmē, ka mājaslapa ir publicēta; tas tikai aiznes koda vēsturi uz kopīgo vietu.
repo: projekta mape ar git vēsturi. Tajā dzīvo faili, izmaiņu pieraksti un bieži arī instrukcijas, kā projektu palaist vai labot.
safe-deploy: drošības pārbaude pirms publicēšanas, kas skenē deploy mapi un mēģina noķert noslēpumus vai liekus failus. Tā ir kā pēdējā somas pārbaude pirms izejas pa durvīm.
sesija: viens darba posms ar AI aģentu vai termināli. Sesija var būt īsa atbilde vai garāks darbs ar failiem, pārbaudēm un handoff beigās.
spending cap (izmaksu griesti): iepriekš noteikta maksimālā summa, ko drīkst iztērēt konkrētam darbam vai rīkam. Tas ir drošības limits, lai eksperiments nepārvēršas negaidītā rēķinā.
terminālis: logs, kurā raksta komandas datoram. Ja grafiskais interfeiss ir pogas un izvēlnes, terminālis ir tieša saruna ar sistēmu tekstā.
thinking effort (domāšanas piepūle): iestatījums, cik daudz modelim ļauj „padomāt” pirms atbildes. Augstāka piepūle var palīdzēt grūtākos uzdevumos, bet parasti ir lēnāka un dārgāka.
tokeni: mazi teksta gabaliņi, kuros AI sadala vārdus un teikumus. No tokeniem ir atkarīgs, cik daudz teksta modelis var paturēt prātā un cik aptuveni maksā pieprasījums.

Kā lietot šo rokasgrāmatu

Pamatu primer

Sprinta gatavība

Tu esi režisors, ne rakstītājs

Kas ir LLM (un kas nav)

Modeļi un domāšanas piepūle

Repo, commit, deploy — konceptuāli

Drošība vienā elpas vilcienā

Aģenta darba loops

Kā uzrakstīt norādi (prompt anatomija)

Playbook

Setup gatavs

Statiska lapa dzīva

Dashboard pipeline strādā

Deployots + handoff

Pēc sprinta: kā turpināt augt

Atsauces pielikums

Gatavības čeklists

Modeļu čītšīts

MCP saraksts

API hub saraksts

Ārējie linki

Gotcha kartītes

Atkopšanās kartītes — „aģents iestrēdzis”

Izmaksu lapa

Drošības rituāls (vienīgais patiesības avots)

CLAUDE.md + HANDOFF šabloni

Minimālā vārdnīca