Развој вођен спецификацијом у Let Books

Let Books је користан студијски пример развоја вођеног спецификацијом јер репозиторијум већ садржи више слојева производне намере, а не само имплементационе артефакте.

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

Слој спецификације

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

Одговара на питања као што су:

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

То је разлика између општег описа и праве спецификације. Права спецификација ограничава имплементационе изборе.

Слој тактичких упутстава

AGENTS-Implementation.md додаје други слој. Не замењује производну спецификацију, него објашњава како рад у овом репозиторијуму сада треба да се изводи.

Примери укључују:

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

То је важно у раду уз помоћ AI-ја зато што свако правило не припада дугорочној производној спецификацији. Нека су правила тактичка, уредничка или специфична за репозиторијум. Одржавање те разлике јасном смањује шум и спречава да се производна спецификација претвори у одлагалиште имплементационих детаља.

Слој тренутног стања

README.md представља трећи слој: опис тренутног стања.

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

У Let Books-у README изричито разликује тренутне испоруке од будућих планова. То сарадницима, институцијама и рецензентима помаже да разумеју зрелост пројекта без нагађања.

Слој документације

Подручје docs/ додаје четврти слој. docs/README.md, docs/Development.md, docs/Deployment.md, стилски водичи и подручје sources одређују како знање треба да буде организовано, валидирано и објављено.

Ту репозиторијум постаје више од збирке датотека. Постаје платформа знања са:

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

То је управо врста оквира која помаже да испорука уз помоћ AI-ја остане следљива.

Слој дема

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

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

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

Слој провере

Let Books већ документује и начин размишљања о провери.

docs/Development.md и docs/Deployment.md описују валидационе слојеве као што су:

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

То нису само детаљи о алатима. То је доказ да пројекат квалитет третира као поновљив систем.

Зашто је то важно за AI-подржану испоруку

Ако AI помоћник доприноси Let Books-у, не мора да измишља производ од почетка. Репозиторијум већ садржи ланац намере:

1. производни смер у AGENTS.md
2. тактичка правила испоруке у AGENTS-Implementation.md
3. тренутно стање у README.md
4. правила знања и објаве у docs/
5. статус извршивог прототипа у статичном демоу
6. смернице за валидацију и објаву у развојној и имплементационој документацији

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

Главна лекција

Развој вођен спецификацијом не значи само написати дугачак документ са захтевима пре почетка кодирања.

У пракси значи изградити поуздан ланац између:

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

Let Books већ показује да такав ланац може постојати и пре пуне позадинске апликације.

То је један од најјачих аргумената за развој вођен спецификацијом у AI-подржаном раду: што је ланац намере јаснији, мања је вероватноћа да ће се брз излаз претворити у брзу збрку.