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

Улога

Смернице за примену налазе се испод спецификације производа.

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

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

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

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

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

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

Уобичајени примери

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

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

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

Зашто је то важно у раду уз помоћ вештачке интелигенције

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

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

У пракси, то значи да датотека са упутствима из Markdown може обављати два посла одједном:

• објасните ток посла људском сараднику
• усмерите АИ агента према жељеним алатима, секвенци и ограничењима

Let Books контекст

У Let Books, AGENTS-Implementation.md је слој тактичког навођења.

Покрива области као што су:

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

То га чини оперативним пратиоцем AGENTS.md, а не његовом заменом.

Остала упутства Markdown у репо-у појачавају исти образац. на пример:

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

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