Managed Agentic Engineering · референс-реалізація
Як цей сайт зроблено за підходом MAE
Spec-driven розробка, де людина визначає що й чому у структурованих документах, а AI-агент виконує як — під контролем гейтів. Нижче — повний флоу, реальні цифри й чесні межі їх точності.
· git-історія репозиторію + артефакти Discovery
TL;DR — головні цифри
Обсяг, оцінений традиційно у 26–40 людино-днів, за commit-based реконструкцією зайняв близько 25 годин. Це не контрольований бенчмарк: метод і всі обмеження наведено нижче.
Метод
Що таке MAE — у двох реченнях
MAE — це supervised агентна розробка: складність маршрутизації, планування й виконання захована всередині конвеєра, а людина рев’ює на межах гейтів. Документація в репозиторії є джерелом правди.
- 1PCDProject Context
- 2FSDепіки → фічі → US + AC
- 3spec.mdbuildable Feature Spec
- 4plan.mdAI Implementation Plan
- 5Gate 3інженер апрувить план
- 6Виконанняагент іде по чеклісту
- 7Гейт якостіlint · typecheck · test · build
- 8Docsfeature record + карта
- 9Merge → deployлюдський approval і реліз
Фаза 1 · 24–27 липня 2026
Discovery — закриваємо невизначеності до першого рядка коду
Аудит старого Gatsby-сайту дав факти, що змінили початкові припущення.
- 7 статей, 5 фізично на otakoyi.software
- Міграція стала малою задачею; External Post — окремою сутністю.
- Остання публікація — листопад 2022
- Контент-каденс, а не технологія, став ризиком №1.
- 4 категорії + 8 legacy-тегів
- URL-таксономію збережено через explicit compatibility map.
- Аналітики не було
- Додано analytics-and-seo, інакше головна метрика лишалась невимірюваною.
- Контент був лише англійською
- Прийнято стратегічне рішення про повну двомовність.
28 рішень, 11 ризиків
Discovery зафіксував 28 рішень у трьох ітераціях. Ключовий розворот D12–D13 зробив lead generation до OTAKOYI кінцевою метою, тому Contact, GDPR і Privacy перейшли в M1.
R9 лишився відкритим свідомо: технічний трафік не гарантує звернень від CTO. Гіпотезу перевіряють Plausible-даними; review — 2027-03-31.
Фаза 2
Специфікація — Feature Index → spec.md
Один рядок Feature Index = одна фіча = один spec.md = одна гілка. Slug подорожує від Discovery до коду, а порядок визначає ациклічний граф залежностей.
Foundation
M1- i18n-routing
- analytics-and-seo
Personal Brand
M1- home-landing → home-conversion-ux
- about-page
Content & Blog
M1 · M2- blog-index-and-post
- content-categories
- content-tags
- content-search
Lead Generation
M1- contact-lead-form
- privacy-policy
Audience Growth
M2- newsletter-subscription
Рівно 11 Feature Index entries: content-search і newsletter-subscription свідомо відкладено в M2.
Фаза 3 · 28 лип — 11 сер
Побудова — реальний слід у git
Next.js 16 · React 19 · TypeScript strict · Tailwind v4 · MDX · Resend · Upstash Redis · Plausible · Vercel. Бази даних немає; write-path — вихідний email.
Discovery
Аудит, 28 рішень, 11 ризиків, OKR Q3.
Bootstrap — /mae:init
Next.js base, MAE SDD layer, PROJECT.md та architecture-map.
Побудова ядра
Foundation → Content → Lead Generation за графом залежностей.
Консолідація та інфраструктура
256 файлів, +16 009 / −1 279 рядків; CI, Vercel і legacy-контент.
M1 формально закрито
Canonical www, D27-статті, article template і production verification.
Post-M1 полірування
Conversion UX, About refresh, mobile navigation і локалізований CV.
Що означає «M1 закрито»
- 47 canonical адрес повернули 200
- 6 normalization-сценаріїв повернули прямий 301
- 3 статті D27 повернули 200 у своїй locale
- Sitemap index отримав Success у Search Console
- Контрольний lead отримав delivered і правильний Reply-To
- HTTPS/HSTS, DKIM/SPF/MX, Upstash і дві Plausible-цілі перевірено
Трудозатрати
Скільки це коштувало часу
Git показує 47 комітів у шести активних днях між 28 липня і 10 серпня. Це реконструкція, а не автоматичний time tracker.
Метод оцінки
Коміти згруповано у сесії: 11–16 год між комітами, 15–23 год із поправкою на старт сесій, плюс 5–8 год сліпої зони перед великим consolidated commit. Рекомендований діапазон — 20–30 год, центральна оцінка ≈25 год.
Оцінка vs факт
Традиційна оцінка M1: 26–40 людино-днів
Commit-based реконструкція: ≈3–4 робочі дні
Орієнтовне стиснення: 8–13×Людина + агент
Що агент міг зробити сам, а що — ні
Замір на contact-lead-form показує: агент добре драфтить те, що механічно виводиться з Discovery; дизайн станів і API-контракт вимагають людського рішення.
Контроль якості
Чому це працює, а не «швидко = недбало»
Швидкість виникає не через пропущені кроки, а через раннє закриття невизначеності й повторювані гейти.
Discovery закриває ризики
8 із 11 ризиків закрито до першого рядка коду.
Конкретні спеки
Числа, ліміти, TTL і error-коди задані до виконання.
Гейт якості
lint → typecheck → test → build; реліз не проходить інакше.
Gate 3
Людський hard stop між планом і виконанням.
Docs як source of truth
Feature records і fix records підтримує сам конвеєр.
Production verification
47×200, 6×301, delivered lead і sitemap Success замість припущення.
Що це означає для клієнтів OTAKOYI
MAE перетворює невизначену цифрову ініціативу на керовану систему рішень: Discovery, buildable spec, контрольоване виконання та доказову перевірку.
Джерела цифр
- Git-історія: 59 комітів станом на 2026-08-11; effort-зріз — 47 комітів.
- requirements/discovery-summary-maluk-tech.md — D1–D28 і Risk Closure Log.
- requirements/project-context-document-maluk-tech.md — обсяг і традиційна оцінка.
- requirements/m1-release-reconstruction-contract.md і m1-production-url-audit.md.
- requirements/feature-specification-document-maluk-tech.md та features/*/spec.md.
- requirements/okr-q3-2026.md.