🎬 README — это продукт. Часть 3: что получилось

В первом видео — числа. Во втором — мышление.
В третьем — конкретика.

Взял Claude Opus, написал промпт с концепцией JTBD, улучшил шаблон документации. Claude Sonnet в терминале разложил всё по файлам. Пинки и Брейн.

Три вещи, на которые стоит обратить внимание:

Pipe-формат API — четыре строки, и ты понимаешь как работает эндпоинт. Без головной боли.
Навык для инженера и машины: объяснить поток данных на пальцах.

Лестница вглубь — README → тесты → architecture → ADR → contributing. Каждый уровень — отдельный файл. Читатель сам решает, где ему остановиться.

Карта файлов — каждый документ знает своего клиента.
README — инженерам.
AGENTS.md — агенту.
Concept — менеджеру, инженеру. Каждый находят своё.

Шаблон сервиса:
👉 https://github.com/ubik-life/service-template

README сервиса авторизации (живой пример):
👉 https://github.com/ubik-life/passkey-demo-api

Платформа Ubik — описание всей системы:
👉 https://github.com/ubik-life/concept

Статья с полным разбором и расчётами потерь:
👉 https://codemonsters.team/blog/2026/04/07/documentation-as-product-jtbd/

#rationaldev #codemonstersvlog