|
Я тут уже битый месяц делаю сабж. Сделал ему отдельную репу, и там папочки business, ops, dev и projects. И внутри projects/{foo,bar,baz}/ то же самое business-ops-dev. А внутри маркдаун-файлики типа 01-overview.md
"Номера глав" болван предложил, оказалось удобно. Разбиение на business-ops-dev вышло из моего опыта с Archimate и исходя из того, что с LLM будут общаться люди с разными ролями (которые у нас уже есть).
У нас есть значительное количество бизнес-стейкхолдеров. Это и наш внутренний C-level, и С-level клиентов. Что вот эти люди, которые в технику не лезут, должны знать о компании и системе? Все идет в business/
Далее у нас есть народ, который в технику лезет, но не лезет в код что-то там править. Когда они будут общаться с LLM, им надо знать про логи-метрики-админки, саппорт, диагностику проблем, стектрейсы, деплоймент, конфигурирование системы. В-общем довольно много.
Ну и наконец, собственно разрабы, которые постоянно видят код.
business/01-portfolio-and-product-status.md
Тут громко сказано, но общее описание компании- чем занимается, какие проекты есть, что в проде что нет. Тут же однострочно бизнес- и технические стратегии и позиционирования.
business/02-team.md
Тут персоналии. И наши работники, и внешние стейкхолдеры. Кто есть кто, по каким каналам коммуницируем, общие концепции управлениt командой (совещания, дисциплина).
business/03-business-meeting-format.mdОдной из задач будущей системы автоматизации является автоматизация совещаний, которые у нас бизнес- и технические. Вот для бизнес-совещаний тут оговаривается их формат и в каком виде нам нужен будет отчет. Пока несколько сумбурно.
Глобальные папки dev и ops пока ещё более сумбурные — там то что болван наизучал из общих принципов дизайна систем в ходе работы. Типа того что в DynamoDB мы не используем монотаблиц.
В проектах интереснее. |