Дајте агенту користан контекст репозиторијума

Почните од тренутне радне копије

Агент мора да зна који репозиторијум и грану мења. Мора да зна и да ли радни директоријум садржи неповезане промене. Те чињенице утичу на то шта сме безбедно да мења и како треба тумачити коначни diff.

Затражите да агент испита упутства пројекта и конфигурацију пакета пре имплементације. Запамћена команда из другог репозиторијума овде може да буде погрешна. Познат назив framework алата не доказује инсталирану верзију или конвенције пројекта.

За малу промену обезбедите релевантан модул, код који га позива, тестове и архитектонску одлуку. Додајте информације када истраживање покаже конкретну потребу.

Користите упутства репозиторијума за трајна правила

Датотека са упутствима може да опише подржане команде, границе модула, захтеве за преглед и радње које захтевају одлуку одговорне особе. Конвенција AGENTS.md алатима за програмирање даје препознатљиво место за ове информације. Подршка алата и приоритет упутстава могу да се разликују, па проверите понашање свог алата.

Чувајте трајна правила пројекта у репозиторијуму. Тренутни задатак држите у опису задатка. Не претварајте датотеку са упутствима у историју сваког разговора или списак привремених планова.

Корисно упутство гласи: „Покрените интеграционе тестове ауторизације када рута мења понашање приступа.” Неодређено упутство гласи: „Увек пазите на безбедност.” Прво наводи услов и радњу које особа која прегледа рад може да провери.

Проверите упутства према коду

Упутства застаревају када се промене команде, директоријуми или архитектура. Ако водич наводи скрипту која недостаје, испитајте конфигурацију пакета. Ако документ тврди да сервис само чита податке, испитајте дозволе пре ослањања на ту тврдњу.

Забележите неслагање. Користите непосредне доказе о актуелној верзији да разумете понашање имплементације. Не одбацујте прећутно намерно постављену политику зато што је стари код крши. Политика и тренутно понашање одговарају на различита питања.

На пример, водич може да забрањује директан упис у заједничку грану, док га стара скрипта и даље обавља. Исправан одговор је да се политика сачува, а скрипта исправи. Постојећи код није дозвола да се понови забрањена радња.

Обезбедите релевантан и безбедан контекст

Цео репозиторијум може да садржи акредитиве, приватне тестне податке, извозе података клијената и старе евиденције подршке. Приступ репозиторијуму не значи аутоматски да је свака датотека погодна за сервис модела.

Користите одобрене алате и правила поступања са подацима. Искључите тајне из контекста. Замените примере клијената измишљеним подацима где је могуће. Проверите и повезане алате, не само отпремљене датотеке: конектор за претрагу може да прибави информације које нису биле у почетном упиту.

Упутство репозиторијума „не читајте тајне” корисна је смерница. Не замењује ограничење приступа складишту тајни и осетљивим директоријумима.

Оставите користан запис следећој особи

По завршетку забележите промењено понашање, проверу и неразрешена ограничења у pull request захтеву. Ажурирајте трајну документацију пројекта када се подржани ток рада промени. Избегавајте копирање целог транскрипта агента у репозиторијум.

Запис треба да помогне будућој особи задуженој за одржавање да понови рад без реконструисања дугог разговора. Повежите меродавне документе и чувајте један званичан опис сваког трајног правила.

Добар контекст смањује поновљено истраживање. Олакшава и откривање грешака јер су очекивано понашање и исправне команде изричито наведени.