DevDay

Vandamálið sem hljótt er um

Git-geymslan geymir nákvæmlega hvað breyttist, en hún geymir aldrei hvers vegna. Þegar vinnuvikan er á enda á föstudegi er þriðjudagurinn oftast glataður í minningunni. Skipanasagan svarar spurningunni um „hvað“ var gert, en hún útskýrir aldrei hvers vegna ákveðin leið var valin, hvað var reynt fyrst og hvers vegna því var hafnað, eða hvaða staða var uppi klukkan hálf tólf sem var gleymd fyrir klukkan fjögur.

Sem skipuleggjandi vinn ég að mörgum verkefnum samhliða; sum eru í virkri þróun en önnur liggja í dvala vikum saman. Þegar ég kem aftur að verkefni eftir hlé vil ég að git-geymslan svari því sjálf hvað var í gangi — ekki með tilgerðarlegri sögu, heldur á hreinan og milliliðalausan hátt: „Hér er opna spurningin sem ég skildi eftir.“

Vinnulagið kom á undan tækninni

DevDay er ekki nýstárleg kenning heldur hagnýt reynsla. Ég skrifaði litlar, daglegar skrár beint inn í git-geymslurnar mínar mánuðum saman, löngu áður en Claude Code bauð upp á leið til að skilgreina þetta sem sérstaka Claude Code færni. Í maí 2026 voru þessar skrár orðnar hundruð talsins, til staðar í hverri einustu virku git-geymslu á tölvunni minni. Þetta átti ekki aðeins við um hugbúnaðarverkefni, heldur einnig rannsóknargeymslur, skrif, innviði, erindi, fyrirlestra, viðskiptavinaverkefni og hliðartilraunir. Það sem býr í git fær sjálfkrafa verkdagbók.

Uppsafnað virði þessara gagna er gríðarlegt. Hver skrá er gluggi inn í þriðjudagseftirmiðdag sem annars hefði glatast í flæðinu. Nýjungin í maí 2026 fólst í því að pakka þessari venju inn í tvær einfaldar skástriksskipanir. Viðnámið við að skrá féll niður í fimmtán sekúndur og siðvenjan varð fullkomlega flytjanleg á milli verkefna.

Tvær skipanir

Kerfið byggir á tveimur einföldum skipunum sem gegna ólíkum hlutverkum:

• /devday-log er viðauka-gagnasveif (e. append-only data stream). Þú keyrir hana þegar þú lýkur við áfanga, lendir á vegg eða tekur ákvörðun sem skiptir máli að varðveita. Skipunin sækir sjálfkrafa virka grein, síðustu skipanir og nýlegar breytingar, og skrifar tímasetta vörðu (e. checkpoint) undir viðeigandi klukkustund í verkdagbókina.
• /devday er samtengjarinn (e. synthesizer). Hann les uppsafnaðar vörður dagsins, fer yfir git-söguna og setur saman hreina, skipulagða skýrslu með köflum um helstu afrek, teknar ákvarðanir, næstu skref og gæði vinnulotunnar.

Þú keyrir /devday-log kannski tólf sinnum á dag, en /devday aðeins einu sinni. Samtengjarinn er hannaður sem idempotent aðgerð á forsendum hugbúnaðarins: þú getur keyrt hann á hádegi til að sjá stöðuna, aftur klukkan sex til að ná yfir allan daginn, eða tvisvar í röð án þess að eiga á hættu að skemma eða tvíverka gögnin.

Þrjár hönnunarákvarðanir

Við þróun DevDay leiddu þrjár meginreglur hönnunina til að tryggja að tækið yrði áreiðanlegt og einfalt í notkun:

• Git er eina krafan: Engir ytri gagnagrunnar, engin sérstök öpp og engin innskráning. Ef þú ert staddur í git-geymslu, þá virkar DevDay. Ef ekki, neitar færnin að keyra og útskýrir ástæðuna í einni línu. Of margar tilraunir í þekkingarstjórnun hafa dáið vegna þess að þær kröfðust nýrra og framandi uppsprettna sannleikans.
• Sjálfvirk staðsetning við fyrstu keyrslu: Færnin greinir umhverfið sjálfkrafa í upphafi. Hún finnur heiti verkefnisins út frá package.json, pyproject.toml, Cargo.toml, go.mod eða einfaldlega heiti möppunnar. Hún leitar að viðeigandi stað fyrir verkdagbókina (svo sem docs/devlogs/ eða .devlogs/), stofnar hana ef hana vantar og skrifar stillingarnar í .devday/config.json.
• Viðauka-vörður og óbreytanleg samtenging: Skipunin /devday-log skrifar eingöngu aftan við skrána, sem gerir það að verkum að þú getur aldrei skemmt eldri skýrslur óvart. Skipunin /devday endurskrifar skrá dagsins frá grunni í hvert sinn sem hún er keyrð, en varðveitir safn vörðumerkjanna óbreytt bak við tjöldin.

Orchestrator-reiturinn: Ábyrgð sem framkvæmd

DevDay býður upp á einn valfrjálsan stillingarreit sem vert er að staldra við: orchestrator. Ef þessi reitur er stilltur skrifar færnin undirskriftarlínu í hvern dagshaus. Gildið getur verið hvaða strengur sem er — nafn, netfang, auðkenni eða hópskilgreining. Á þessari síðu nota ég undirskriftina Magnús Smári Smárason | smarason.is.

Tilgangurinn hér er ekki að safna tæknilegum metagögnum um uppruna. Tilgangurinn er að holdgera ábyrgð (e. enactment of responsibility). Vinna sem unnin er með aðstoð gervigreindar er raunveruleg vinna, og sá maður sem setti fram fyrirmæli (e. prompt), samþykkti tillöguna og sameinaði breytingarnar, ber áfram óskipta ábyrgð á því sem byggt var. Verkdagbókin er staðurinn þar sem sú ábyrgð birtist á prenti, dag eftir dag, undir nafni skipuleggjandans (e. orchestrator) sjálfs.

Þetta er lítil athöfn — örfá orð og lén. En hún felur í sér loforð til framtíðarlesanda skrárinnar: Ég gerði þetta. Beindu spurningum þínum til mín, en ekki til gervigreindarinnar.

Þessi hugsun fylgir sama rauða þræðinum og birtist í erindum mínum um AI-Triad og Beyond Fragmentation — hugmyndinni um hinn ósmættanlega mann í gervigreindaraukinni vinnu, þann sem ekki er hægt að skipta út. orchestrator-reiturinn er einfaldlega þessi heimspekilegi þráður færður niður í skráakerfið. Ein undirrituð lína á dag.

Hvernig færsla lítur út

Vefsíðan sem þú lest núna notar DevDay. Færsla gærdagsins er vistuð í skránni docs/devlogs/2026/05-may/devday_20260519.md. Uppbyggingin sem verður til úr /devday fylgir ákveðnu skipulagi:

• Samantekt: Stuttur texti, á bilinu tvær til fjórar setningar, sem inniheldur raunveruleg git-auðkenni (e. commit hashes) og sérstakar tölur. Þetta er það fyrsta sem ég les þegar ég mæti til vinnu eftir helgi.
• Skipanir dagsins: Skýr tafla sem sýnir auðkenni, skilaboð, tímasetningu og flokkun breytinga eftir tegund.
• Teknar ákvarðanir: Hér liggur langtímavinnslan og virði hennar. Á meðan git-sagan segir einfaldlega Merge #691, þá útskýrir verkdagbókin hvers vegna við völdum ákveðna tæknilega útfærslu fram yfir aðra og hvað brást í fyrstu tilraun. Sex mánuðum síðar getur þessi vitneskja gert gæfumuninn á því að leysa vandamál á þremur mínútum eða eyða í það þremur tímum.
• Gæði vinnulotunnar: Heiðarlegt og milliliðalaust mat. Ef minni háttar hindranir koma upp eru þær ekki snyrtar í burtu; þær eru skráðar sem mikilvæg vísbending. Ef sama hindrunin birtist fimm daga í röð er það skýrt merki um að kerfið krefst úrbóta.

Til hvers ég nota þetta

Í daglegum rekstri hafa þrjú skýr notkunarmynstur tekið á sig mynd:

Sem tæki til sjálfskoðunar: Á mánudagsmorgnum skanna ég síðustu sjö færslur í verkdagbókinni. Allt sem hefur verið flutt á milli daga undir liðnum „Næstu skref“ í þrjá daga samfleytt er annaðhvort klárað strax, fellt niður eða tekið til sérstakrar meðhöndlunar. Dagbókin gerir hvers kyns rekstur og töf sýnileg.

Sem afhendingarskjal: Þegar samstarfsmaður kemur inn í verkefni sem ég hef unnið að, sendi ég honum einfaldlega dagsfærsluna. Hann fær tafarlaust fullt samhengi, yfirsýn yfir ákvarðanir og upplýsingar um þær leiðir sem voru reyndar og hafnað. Þetta sparar tíma og breytir löngum fundum í fimm mínútna lestur.

Sem inntak fyrir dýpri greiningu: Dagbækurnar nýtast sem skipulögð gögn fyrir gervigreind. Með því að gefa Claude viku af þessum skrám fæst nákvæm og raunsæ samantekt á raunverulegri framvindu vinnunnar og þeim rökum sem lágu henni til grundvallar. Slíkar upplýsingar er ógerlegt að draga eingöngu úr hráum git-gögnum.

Framlag til gervigreindaraukaðrar þróunar

DevDay er smátt í sniðum — tvær skipanir, ein markdown-skrá á dag. En tækið er hlutdrægt, mótað af reynslu úr hundruðum dagbókarfærslna. Sú skoðun endurspeglast í eftirfarandi atriðum:

• Verkdagbókin á alltaf að vera vistuð við hliðina á kóðanum sjálfum, aldrei fjarri honum.
• Sami maðurinn og gaf fyrirmælin undirritar skrána undir eigin nafni.
• Ákvarðanir eru ritaðar daginn sem þær eru teknar, en ekki endurgerðar eftir á.
• Viðnámið við skráningu er aðeins fimmtán sekúndur — nógu lítið til að venjan lifi af erfiðustu vinnuvikurnar.

Ekkert af þessu krefst Claude Code sérstaklega. Tæknilýsingin fyrir SKILL.md er sjálfstæð og þú getur útfært sömu tvær skipanirnar í hvaða umboðsmanni sem er eða sem einfaldar skeljarskriftir. Git er allt það keyrsluumhverfi sem þú þarft; færnin er aðeins lagið sem fjarlægir viðnámið ofan af venju sem þegar virkaði.

Staða verkefnisins: Stöðug. Notað daglega í hverri einustu virku git-geymslu sem ég snerti. Tæknilýsingin fyrir SKILL.md er aðgengileg undir MIT-leyfi. Ef þú prófar þetta, vil ég gjarnan heyra hvað virkaði vel og hverju þú breyttir. Færnin er hlutdræg; þær skoðanir urðu til úr raunverulegum mistökum og eru alltaf opnar fyrir endurskoðun.