Практычныя прытамулкі: ваш AGENTS.md быў напісан для гэршага моделю.

У гэтым керавану парадоксальнае шлях ад сыр'ёў да рабочай системы для: ваш AGENTS.md быў напісан для гэрогліфнага моделю. Акцэнт ставяцца на практычныя крокі, чыстае перакананне і код, які можна проста падставіць у репазітарый без неабяснення меты. У стадзіі агляду неабходна прадзефінаваць вхідныя даны, адпаведальную за крок і критэрыя завершэння пры перамены коду. Аперацыйныя працавнікі должны магчымае перадзеўсці крок з вядомага пункту контролю без неабяснення схованага стану. Конфігурацыю трэба залічыць парадоксальнае ад коду прыкладнення. Файлы сераўіса, хранільнікі секрэтных дадзеных і флагі функций должны знаходзіцца ў аднам месцы, якое працавнікі можу аудытуваты без чытання всей структуры.

OLD: Read A → Edit B → Test C
NEW: Boundaries → Permissions → Definition of done

Кожная неудача залічыць фасал

Калі працуеце над кантэнтам «Кожны неяўнасць заставляе перайсці на наступны этап», спачатку запішыце умовы працы: неабходныя даны, сігнал успеху і тое, што выканаецца у разы частковай неяўнасці. Такі список контроля дапамагае заставіць пазнейшыя змены коду быць чыстымі. Документавацыя стандартнага і варыятыванага падчас выканання шляхоў таксама є важлівай. Перапрыбуткі, людзкія контрольныя пункты і обработка некоректных паведамленняў є частынай продукту, а не пазнейшым дапрацоўкам. Зберагаеце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Перасылка ідэнтычных прамуров є частай прычыной зношэння ресурсаў.

Always run the entire test suite after every change.

Навыкі спачатку маюць кост роутавання, а пасля — кост выканання

Калі працюеце над навыкамі, якія выконваюць певныя задачы, спачатку запісайце умовы дагавору: неабяжлівыя даны, сигнал працэйскага успеху і тое, што выканаецца у разе частковага нявыполнення. Такі список контроля дапамагае заліцварыць пазнейшыя змены ў коде. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына нявыполнення павінна вказываць на адзін конкрэтны элемент, а не на заплутаны ланцюг задач. Зберагаеце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Перадзял у тое ж самае прамэру ёсць частым выклікам зношвання ресурсаў.

database/
├── router.md
└── references/
    ├── migrations.md
    ├── performance.md
    └── recovery.md

У файле AGENTS.md павінна застацца тая інфармацыя, якую код не можа адказаць.

Працюючы над документам AGENTS, неабяжна зберагаць інформацыю пра этап, спачатку запісаць угоду: неабяжныя вхідныя даны, сигнал успеху і тое, што выходзіць у разе частковага невыпання. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Спрэчвайце гэты этап як угоду межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, задаце критэрыя успеху і не падзеўляйцеся частковым завершэнням без паведамлення. Зберагаце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Перадача ідэнтычных прамуслов ёсць частым выклікам зношэння ресурсаў. Працюючы над документам AGENTS, неабяжна зберагаць інформацыю пра этап, спачатку запісаць угоду: неабяжныя вхідныя даны, сигнал успеху і тое, што выходзіць у разе частковага невыпання. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Зберагаце настройкі за межамі коду прыемлівача. Файлы сераўнавання, хранільнікі секрэтных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аудыт без неабяжнага чытання всіх дадзеных.

KEEP

Generated API clients in /src/sdk are immutable.
Edit the generator source instead.

MOVE OR REMOVE

Before making any change:
1. Read ARCHITECTURE.md
2. Inspect the repository map
3. Review all package documentation
4. Identify downstream dependencies

Лепшыя модэлі робяць разрешэння ўсё бол важлівым

Лепшыя модэлі дапамагаюць этапу разрешэння працаваць наяўна, калі яго спрыяваць як вимерную характэрыстыку. Перш чым расширваць масштаб, зафіксавайце адны ідеальны прыклад, адзін прыклад неудачы і прыметку па адвярненню змян. Запісуйце адночасна шлях успеху і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія контрольны пункты і обработка некоректных паведамленняў є частью продукту, а не дадатковым элементам для пасляднейшай доработкі.

Local tests use disposable fixtures and have no production access.

Run affected tests, fix regressions caused by the requested change,
and rerun them without asking for approval at each step.

З’явіце вакуум завершэння працы раней, чым пачнуце процедуру

Этап завершэння апрантавання прыцэпу працюе найкраща, калі яго спрыяваць як меркавыя парадакты. Запісайце адны ідеальны прыклад, адну справу з бягам і прыметку пра вярнэнне да пачатковага стану, перш чым расширваць масштабы. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына бягу должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Задаеце ліміт токэнаў на кожны раунд і на кожную сесію. Інструменты-агенты агрэсывна расширваюць контекст; строгі ліміты не дазволяюць дэмам ператварыцца на неспакоўныя рахункі.

Read these files.
Modify these modules.
Run this command.
Inspect this output.
Run these tests.

Implement the avatar endpoint.

Run the affected local tests, inspect the returned payload,
fix regressions caused by this change, and stop when the requested
behavior works or an external blocker requires a decision from me.

Іерархія інструкцый должна быць намеранай

Іерархія інструкцый працюе найэфектывней, калі яе спрыяваць як до меры. Перш чым расширваць масштаб, неабяжна зафіксаваць адны ідеальны прыклад выкарыстоўвання, адну справу з бягам і прыметкі па адварцыі стану. Спрыяваць гэты этап як кантракт межа вхіднымі даннымі і перакананымі выходнымі рэзультатамі. Назваць всі неабяжныя элементы, задаць критэрыя успеху і не падзеўляцца частым, непূরным выкарыстоўванням. Задаць ліміт токенав на кожны раунд і на кожную сесію. Інструменты-агенты агрэсывна расширваюць контекст; строгі ліміты не дазволяюць дэмам ператварыцца на неспакоўлівыя рахункі. Іерархія інструкцый працюе найэфектывней, калі яе спрыяваць як до меры. Перш чым расширваць масштаб, неабяжна зафіксаваць адны ідеальны прыклад выкарыстоўвання, адну справу з бягам і прыметкі па адварцыі стану. Конфігурацыю трэба зберагаць паза кодам прыкладнай програмы. Файлы сяродовішча, хранільнікі секрэтных данных і флагі функций должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабяжнага чытання всіх элементаў.

AGENTS.md
    ↓
Repository invariants
Safety boundaries
Global permissions

Skills
    ↓
Specialized workflows
Loaded only when relevantTask prompt
    ↓
Immediate objective
Local constraints
Definition of done

Працава з задачамі аудыту заўязкаў кожны раз, калі змінюецца модэль

Для рэалізацыі задачі аудыту заўязкаў у кожны момент змін, неабходна праканалізаваць вхідныя даны, абавесцявальніка крока і критэрыя завершэння пры зміне коду. Аператары должны магчыма было перзапускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Неабходна аддзержваць дакументацыю як пра успішны ход роботы, так і пра способы вярнення да нормальнага стану. Пракаты, людзкія перакрыцця і обработка некоректных паведамленняў є часткай продукту, а не дадатковым элементам пасляўпрацавкі. Калі наступны крок — гэта код чыя-небудзь вызов інструменту, лепш выкарыстоўваць структураваныя выходны даны з пераканалізацыёю за дапамою схемы, чым вольнай формы тэкст.

Інвентарызацыя історыі компенсацый

Для стадіі історычных компенсацый у інвентарызацыі неабяжна прадэфінаваць вхідныя даны, адпаведальнага за шаг і крэтырыя для завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымаўсць перзапускаць шаг з вядомай точкі контролю, не падозрываючы прыхованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі шаг не выконваецца, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцоўкі задач. Калі наступны шаг — це код або вызов інструмента, лепш выкарыстоўваць структураваныя выходныя даны з перакананнем схэмы, чым працэсавы тэкст.

Раздзеляйце інварыянты ад рытуалав

Для стадіі «Адыякраванне інварыянтных элементаў з рытуалоў» неабходна перад змянай коду задаць вхідныя даны, абавесця крока і крэтырыя завершэння. Аперацыёныя працавнікі должны магчымае перайсці на гэты крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра заштынены стан. Спрыяйце цій стадіі як кантракту межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даць назвы артыфактам, задаць перакананні на успех і адмовіцца ад беззвучнага частковага завершэння. Калі наступны крок — гэта код чыя-небудзь інструмент, лепш выкарыстоўваць структураваныя выходныя даны з перакананнем схэмы, чым вольныя тэкстовыя форматы. Для стадіі «Адыякраванне інварыянтных элементаў з рытуалоў» неабходна перад змянай коду задаць вхідныя даны, абавесця крока і крэтырыя завершэння. Аперацыёныя працавнікі должны магчымае перайсці на гэты крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра заштынены стан. Конфігурацыю трэба заставіць парад унутры коду прыкладнення. Файлы сяродавішча, хранільнікі секрэтных дадзеных і флагі функцияў должны знаходзіцца ў аднам месцы, якое працавнікі можуць аудытаваць, не чытаючы весь граф.

.

Ператворыце складныя навыкі ў механізмы керування

Калі працюеце над ператворэнням складных навыкаў у практычныя механізмы, спачатку запісайце угоду: неабходныя даны, сигнал успеху і тое, што выканаецца у разы частковага невялікога браку. Такі чарт дапамагае заліцвачваць будучыя змены ў кодзе. Документавайце як шлях успеху, так і шлях вяселення. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є частью продукту, а не дадатковым дошліваннем пазней. Зберагайце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Перасылка ідэнтычных паведамленняў є частым выкліком для ресурсаў.

Разглядайце забораныя пункты як межы прынятнага рашэння

Калі працуеце над пераглядам забаранэнняў на стадіі прымення рашэння, спачатку запісайце угоду: неабходныя даны, сігнал успеху і тое, што выходзіць на частым неудачам. Такі список контроля дапамагае залічыць пазнейшыя змены ў кодзе. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, неудача павінна вказваць на адну адпаведальнасць, а не на заплутаны ланцюг задач. Зберагаеце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Перадзял у тое ж самае прамэру ёсць частым выклікам зношвання ресурсаў.

Што павінна застацца пасля кожнага апдэйта

Калі працюеце над пытаннем «Што должна застацца на кожным этапе», спачатку запісайце контракт: неабяжлівыя данні, сигнал успеху і тое, што выходзіць у разе частковага невыпання. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Спрэтавайце гэты этап як контракт межа даннімі і перакананымі выходамі. Дайце назвы элементам, задаце правіла пераканання успеху і не падзэлвайце задачу часткова без адпаведнага паведамлення. Зберагачвайце інструкцыі стабільной системы і схемы інструментаў у кэшы. Перадача ідэнтычных прамуслов ёсць частым выклікам зношэння ресурсаў. Калі працюеце над пытаннем «Што должна застацца на кожным этапе», спачатку запісайце контракт: неабяжлівыя данні, сигнал успеху і тое, што выходзіць у разе частковага невыпання. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Зберагачвайце настройкі параду ўнутры коду аплікацыі. Файлы сераўнавання, храненні секрэтных дадзенаў і флагі функций должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аудыт без неабяжлівага чытання всей структуры.

Чэрніця аператыўных задач

Этап перагляду канцэлекту праблемы працюе наяўней, калі яго спрыяваць як мерыемую величыну. Запісайце адна ідеальная версія, адзін прыклад неудачы і запіс пра атрыбуцыю назад, перш чым расширваць масштабы.

Запісвайце часы выканання і кост токеноў або запытаў разам з функцыйнальнымі рэзультатамі. Відразлівае відображэння костаў з самага пачатку запобегае неспакойным рахункам, калі працэс пераходзіць з дэмовай среды ў спакульную.

Задаце бюджет токеноў на кожны раунд і на кожную сесію. Інструменты-агенты агрэсывна расширваюць контекст; строгі ліміты не дазволяюць дэмам ператварыцца на неспакойныя рахунки.

Забезпечыце людзкія апраўды для тых элементаў, якія витрачаюць грошы або зменяюць данні ў працэсе виробніцтва. Працэс кампайлявання не ўзроўнаважваеся з повнасцю бізнес-функцый.

Напісце кароткі посібнік: як зменяць клучы, як спрачыслаць чергу, як атрыбуцыяваць назад пасляльніе дадзеныя.

Лепшыя маленькія, тэставаныя елементы чым велікія скрыпты. Калі якісь крок не выйшае, адказчыкам трэба быць чыстаю прычынай, а не заплутаным ланцугам задач.

Перш чым пераходзіць да наступнага крока, заморозьце версіі, зафіксавайце ідеальны прымер дзейна для критичнага маршруту та паказвайце способы вярнення да пачатковага стану. У спільных средах неабходны ліміты частоты запуска, пераканальнія перагляды та чыстае апамяроўванне адпаведальнага чалавека за зміны секрэтных даных. Лепшая надзеяна надзейнасць чым хітрыя едыноразовыя дэманстрацыі.

Запіс для 42ea40c30a21: не кладзіце ключы прадаўцаў у репазітарый, задаце верхнюю межу токена на кожную сесію та зберагачыце прымеры дзейна рядом з фіксатрамі для ацэнкі, каб пазнейшыя замены модэляў заставаліся парабелнымі.