Упатство за имплементација

Улога

Упатството за имплементација се наоѓа под спецификацијата на производот.

Тоа помага да се одговори на прашања како што се:

• како треба да функционира јавното именување
• како треба да бидат структурирани документите
• кои очекувања за проверка важат во моментов
• кои правила специфични за складиштето треба да ги следат соработниците
• каде треба да бидат запишани тактичките правила додека проектот се развива

Разлика од спецификацијата на производот

Спецификацијата на производот дефинира што е производот и што треба да постигне.

Упатството за имплементација дефинира како соработниците треба да ја извршуваат работата во рамките на тековниот контекст на испорака.

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

Вообичаени примери

Упатството за имплементација често вклучува:

• правила за именување и брендирање
• правила за спроведување на документацијата
• ограничувања за статичко место или демо
• очекувања за верификација
• правила за уредување или генерирање кодови
• докажувачки политики за јавно пишување

Ваквите правила често најдобро функционираат во Markdown затоа што треба да останат прегледни, лесни за ажурирање и блиску до останатиот контекст на складиштето.

Зошто е важно во работата со помош на вештачка интелигенција

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

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

Во пракса, тоа значи дека датотеката со упатства Markdown може да изврши две работи одеднаш:

• да му го објасни работниот тек на човечкиот соработник
• да го насочи агентот за вештачка интелигенција кон претпочитаните алатки, редослед и ограничувања

Let Books контекст

Во Let Books, AGENTS-Implementation.md е слојот за тактичко водење.

Таа опфаќа области како што се:

• јавно именување
• правила за документација
• како се поделени јавната страница и документите
• метаподатоци и правила за оптимизација за статични страници
• статички демо ограничувања
• правила за локализација и пристапност
• правила за верификација
• политика на докази за блог

Тоа го прави оперативен придружник на AGENTS.md, а не негова замена.

Другите упатства Markdown во репото ја зајакнуваат истата шема. На пример:

• docs/android-debugging.md ги насочува изборите за дебагирање на работниот тек, како што се CDP прикачување наспроти работните текови со изворна закрпа
• docs/style-guide/publishing/ubuntu-tooling.md ги документира очекуваните алатки за објавување, верификација, слики од екранот, проверка на правопис и отстранување грешки на уредот

Овие документи се читливи како човечки упатства, но тие исто така им помагаат на агентите да изберат подобри дејства наместо да погодуваат од генеричките стандардни вредности.