Igas projektis on hetk, mida keegi projektiplaani ei kirjuta. Aruanne on valmis. Tähtaeg on neljapäeval. Kolmapäeva õhtul loed selle esimesest leheküljest viimaseni läbi, nii nagu kliendi nõukogu seda lugema hakkab, ja hakkad märkusi tegema.
„Liiga üldine." „Kas see arv on märtsi intervjuudest või küsitlusest?" „Nemad ütlevad liikmed, mina kirjutasin jälle kliendid." „See lõik ütleb sama, mis eelmine."
Tund hiljem on mustandi veerisel kolmkümmend märkust ja õhtu päris töö alles algab. Nüüd tuleb ära teha kõik see, mida sa just endale ette kirjutasid.
Kahte sorti märkused
Kui need kolmkümmend märkust ausalt üle vaadata, jagunevad nad kahte hunnikusse.
Esimeses hunnikus on väikesed ja mehaanilised tööd. Tee lühemaks. Kasuta kliendi sõna. Vii need neli loetelupunkti samasse vormi. Kontrolli, et kokkuvõtte arv oleks sama mis lisas. Sa tead täpselt, milline tulemus peab olema, sa pole seda lihtsalt veel ära teinud.
Teise hunniku pärast klient su palkaski. Kas teine soovitus on selle nõukogu jaoks liiga järsk? Kas tähelepanek piirkondliku kontori kohta peaks üldse aruandes olema või tuleb see öelda koosolekul? Neile ei peaks vastama ükski tööriist ja hea konsultant ei tahakski seda.
Häda on selles, et esimene hunnik sööb õhtu ära. Selleks ajaks, kui jõuad küsimusteni, mis nõuavad selget pead, on kell pool kaksteist ja sa lepid sellega, et „käib küll".
Miks vestlusaknast siin vähe abi on
Väikesed märkused võiks viia vestlusassistendile. Enamik proovijaid lõpetab neljanda märkuse järel.
Iga märkus on edasi-tagasi käik. Kopeeri lõik, kleebi, selgita, mis aruanne see on ja kellele, palu muudatust, kopeeri vastus tagasi, paranda teel kaduma läinud vormindus. Siis otsi dokumendis oma koht uuesti üles. Ühe märkuse puhul pole sellest midagi. Kahekümne puhul on see aeglasem kui käsitsi parandamine ja kuskil kümnenda juures kleebid uue lõigu vale vana lõigu peale.
Märkused ise pole kunagi probleem olnud. Need on lühikesed ja selged ning asuvad täpselt selle teksti kõrval, mille kohta nad käivad. Puudu on viis, kuidas need üle anda sealsamas, kus nad juba on.
Jäta märkus sinna, kus ta on
Ritemarkis käib läbilugemine nii nagu paberil. Vali lõik, klõpsa Comment, kirjuta märkus. See ilmub veerisele teksti kõrvale ja lõik tõstetakse esile, nii et on näha, mille kohta märkus käib. Kui märkus käib koha, mitte lause kohta, kirjuta /// ja pane see sinna.
Siiani on see pastakas. Vahe tuleb sisse siis, kui otsustad, kellele märkus mõeldud on.
Kirjuta märkusesse ükskõik kuhu @claude või @codex ja sellest märkusest saab agendi töö. „@claude tee see kahe lausega, arv jäta alles." Agent saab sinu juhise ja täpselt selle lõigu, mille sa märkisid, ning dokumendi nime, nii et midagi pole vaja kopeerida ega uuesti selgitada. Kui projekti kaustas on AGENTS.md või CLAUDE.md kliendi reeglitega, alustab agent ka nendest.
Ilma mainimiseta märkus jääb märkuseks. Tööriistariba Comments-menüü loeb mõlemad kokku ja ütleb otse välja: „Unassigned comments are never sent." Sellele reale kaks hunnikut toetuvadki. „Liiga järsk selle nõukogu jaoks?" on sinu oma ja jääb sinu omaks, kuni oled selle läbi mõelnud.
Kui lugemine on läbi, ava Comments-menüü. See loetleb määratud märkused iga agendi all, nii et näed, mis kohe välja läheb. Vajuta Send assigned comments to AI, vaata nimekiri veel korra üle ja siis Start tasks. Agent käib oma märkused läbi dokumendi järjekorras.
Mis tagasi tuleb
Iga kommentaar annab aru oma töö kohta. See näitab, millal agent on töö vastu võtnud ja millal ta sellega tegeleb. Kui agendil on küsimus või ta ootab luba, ütleb kommentaar Needs your input. Kui töö on valmis, ilmub sinu märkuse alla lühike kokkuvõte sellest, mida agent tegi, ja Open conversation, kui tahad näha kogu vestlust.
Sinu märkust ei kirjutata kunagi ümber ja keegi ei eemalda seda sinu eest. Sa loed muudetud lõigu läbi, otsustad, kas see on see, mida palusid, ja klõpsad ise Mark as done. Kui tulemus on vale, on märkus alles ja saad seda öelda.
Seda kohta palun võta tõsiselt. Märkus „kontrolli seda arvu intervjuumärkmete vastu" on mõistlik asi anda agendile, kes saab kausta faile lugeda. Vastus on ikkagi väide ja see läheb aruandesse, millel on sinu nimi. Loe üle, mida ta muutis.
Mida see ei tee
Ritemarki kommentaarid on sinu ja agendi vahel. Need ei ole ühine ülevaatus kolleegi või kliendiga: keegi teine sinu veerist ei näe ja agent vastab ühe lühikese kokkuvõttega, mitte vestluslõimega. Kui sinu mustandeid loeb partner, jõuab tema tagasiside sinuni samamoodi nagu praegu ja sa saad sellest teha oma märkused.
Kui saadad kommentaari agendile, lähevad lõik ja sinu märkus sinu valitud tehisaru teenusepakkujale, sinu konto alt ja selle pakkuja tingimustel. Kui projekt ei luba kliendi materjali tehisaru teenusesse saata, siis veeris seda ei muuda.
Kommentaarid salvestatakse Markdowni faili sisse. See on kasulik, sest homme hommikul on need alles, ja see oleks probleem, kui need aruandega koos uksest välja läheksid. Ei lähe: Export PDF ja Export Word jätavad kommentaarid välja. „Liiga järsk selle nõukogu jaoks?" nõukoguni ei jõua.
Õhtu, mille tagasi saad
Läbilugemine ise sellest lühemaks ei lähe. Iga lehekülg tuleb ikka läbi lugeda ja nii peabki.
Muutub see, mis pärast tuleb. Väike hunnik saab tehtud sel ajal, kui sa kohvi teed, ja tulemused vaatad üle nii, nagu vaataksid üle noorema kolleegi parandused. Siis istud maha nende viie-kuue märkusega, kus mainimist pole, kellaajal, mil veel mõelda jaksad.
Need viis-kuus märkust ongi see projekt. Ülejäänu oli trükkimine.
Kui tahad samm-sammulist versiooni, käib kommentaaride juhend läbi iga nupu ja oleku ning konsultantide leht näitab, kuidas ülejäänud projekt selle ümber paigutub.