Az AI code asszisztensek rejtett problémája

Évek óta figyelem, ahogy fejlesztők használják az AI eszközöket, és van egy gondolat, ami nem hagy nyugodni: a legtöbben a potenciáljuknak csak a töredékét használják ki.

A tipikus használat valahogy így néz ki: megnyitod a ChatGPT-t, bemásolsz egy kódrészletet, felvetsz egy kérdést, kapsz egy választ, bezárod a lapot. És kezdődik minden elölről. Gyakorlatilag egy gyorsabb, de szebb felületű Google-keresés.

A valódi gond

Ha komolyabb projekten dolgozol – mondjuk egy startupon, egy side projecten, vagy éles rendszeren –, a stateless (állapot nélküli) beszélgetések inkább hátrány, mint előny. Minden session nulláról indul. Több időt töltesz az előzmények visszamagyarázásával, mint a tényleges megoldásokkal.

Ez különösen fájdalmas azoknak, akik amúgy is küzdenek a végrehajtó funkciókkal. És őszintén? Ez a legtöbbünkre igaz. Az a romantikus kép, hogy a programozó nyolc órán át flow-állapotban kódol? A valóságban szinte soha nem így működik.

Ami tényleg működik: tartós kontextus

A fordulópont akkor jön el, amikor abbahagyod az AI chat-eszközként való kezelését, és elkezded úgy használni, mint egy állandó fejlesztőpartnert. Ez annyit tesz, hogy rendszereket építesz, amelyek:

• Emlékeznek, hol hagytad abba, több sessionön át is
• Kényszerítik a saját minőségi standardjaidat, nélküled
• Olyan összefoglalókat generálnak, amelyekkel egy perc alatt vissza tudsz kapni a munkába
• Automatikusan követik a döntéseket, kudarcokat és tanulságokat

Ez nem arról szól, hogy "lusták" legyünk vagy kiirtsuk az agyunkat. A szoftverfejlesztés adminisztratív terheit adjuk át a rendszernek, hogy a kognitív energiánk a valódi problémamegoldásra maradjon.

A saját workflow-m

Évekig tartó "izgatottan kezdem, összezavarodva hagyom abba" ciklusok után fejlesztettem ki ezt a módszert. A lényege: minden projekthez tartozik egy kontextus fájl, amely a repositoryban él, és automatikusan beolvasódik minden session elején.

Így működik:

Projekt kontextus fájl

A projekt gyökérkönyvtárába létrehozol egy fájlt – nevezzük mondjuk CLAUDE.md-nek –, amely leírja, mit építesz, ki építi, és hol tartasz a folyamatban. Amikor újra elkezdesz dolgozni, Claude először ezt a fájlt olvassa. Nincs több "mit is csináltam utoljára?" pillanat.

A fájl négy fő szekciót tartalmaz:

Kontextus és cél

Mit csinál a projekt? Mi a tech stack? Kik a felhasználók? Ez a lift-pitch önmagadnak, hogy két hét szünet után is azonnal tudd, miről van szó.

Szabályok és standardok

A személyes kódolási szabályaid. Fájlelnevezési konvenciók. Tesztelési követelmények. Amit csak szeretnél, hogy automatikusan érvényesüljön – ide írod. A Claude követi ezeket, nélküled.

Session tervek

Mielőtt nekikezdesz egy sessionnek, leírod, mit tervezel elérni. Ez két perc. A megtérülés: ha félbeszakítanak vagy elfogy a lendület, pontosan ott folytatod, ahol abbahagytad. Nincs súrlódás.

Async checkpoint-ok

Minden session végén a Claude visszaír egy összefoglalót a fájlba. Mit értél el? Mi a következő lépés? Van-e akadály? Jövő héten vagy holnap visszatérve a kontextus már vár.

Miért számít ez a fejlesztési sebesség szempontjából?

A context-switching költséges. Kutatások szerint 20-30 percre van szükség a mély fókusz visszaállításához egy megszakítás után. Akiknek figyelemzavarra hajlamosító tényezőik vannak, ez az idő akár magasabb is lehet.

Tartós kontextussal csökkented a váltás költségét. Még mindig behívhatnak egy megbeszélésre, de az újraindás 60 másodpercet vesz igénybe harminc perc helyett. Egy hét alatt ez több óra visszanyert fókuszidő.

Van pszichológiai vonala is. Amikor ránézel a projektedre és elveszettnek érzed magad, a projekt a súrlódással asociálódik. Idővel ez elkerüléshez vezet. Egy olyan rendszer, amely azt mondja: "itt voltál, ez működött, ez a következő lépés" – teljesen eltávolítja ezt a súrlódást.

Minőségi kapuk hozzáadása

A solo fejlesztés egyik legnagyobb kockázata, hogy "készen vagy" kódot szállítasz, miközben nem vagy kész. A tesztek lefutnak? Mehet. De... eszedbe jutott futtatni a lintest? Ellenőrizni a security issue-kat? Megnézni, hogy a build még mindig működik-e?

Ezeket a checkeket "evidence gate"-kként (bizonyíték kapukként) írod a kontextus fájlba. Mielőtt a Claude segítene lezárni valamit, automatikusan ellenőrzi a saját kritériumaidat. Mintha lenne egy szorgalmas code reviewer, aki soha nem felejti el a checklistát.

Példa:

Mielőtt teljesnek jelölöd:
- Futtasd a teljes test suite-t
- Ellenőrizd, nincs-e console.log a production kódban
- Nézd meg, hogy a build warning-ok nélkül fordul

A Claude automatikusan érvényesíti ezeket. Nem kell emlékezned. A rendszer emlékszik helyetted.

Gyakorlati megvalósítás

Az indulás egyszerűbb, mint gondolnád:

1. Hozz létre egy fájlt a projekt gyökérkönyvtárában
2. Írd meg a kontextust: projekt leírása, standardjaid, jelenlegi állapot
3. Minden session elején frissítsd a session tervet
4. Minden session végén kérj checkpoint összefoglalót
5. Iterálj: adj hozzá tanulságokat, finomítsd a szabályokat, alakítsd a rendszert

A beállítás körülbelül 30 perc. A komplex megtérülés azonnal indul és idővel nő.

Csapatoknak és startupoknak

Ez nem csak egyéni fejlesztőknek működik. A csapatok közös kontextus fájlokat használhatnak, hogy gyorsabban bevonjanak új fejlesztőket, fenntartsák a konzisztenciát a contribútorok között, és csökkentsék a "bus factor"-t azáltal, hogy az implicit tudást explicitté teszik.

Képzeld el: új csapattag csatlakozik, klónozza a repót, és azonnal megérti a projekt struktúrát, a kódolási standardokat és a jelenlegi prioritásokat. Nem kellett két órás átadás. A kontextus fájl elvégezte a munkát helyette.

A nagyobb kép

Érdekes fordulóponton vagyunk a szoftverfejlesztésben. Az AI eszközök valóban hasznossá válnak, de a legtöbben nem frissítették a workflow-jukat ehhez. Még mindig "kérdezel, választ kapsz" módban gondolkodnak, miközben a valódi lehetőség az, hogy tartós, intelligens rendszereket építsünk, amelyek fokozzák az emberi képességeket.

A fejlesztőknek – különösen azoknak, akik másképp dolgoznak – a statelessről stateful AI interakcióra való átállás átalakító erejű. Nem arról szól, hogy kevesebbet dolgozunk. Arról szól, hogy okosabban dolgozunk. Olyan rendszereket építünk, amelyek az agy természetes hajlamaival dolgoznak, nem ellenük.

A legjobb kód akkor születik, amikor nem vagy kimerülve a kontextuskezeléstől. Az eszközök megvannak, hogy ez megvalósuljon. A kérdés csak az, hogy kihasználod-e a teljes potenciáljukat.